اضبط المتغيرات والأسرار

أضف متغيرات الخدمة وعدلها واحذفها، وشاركها مع البيئة كلها، وعلم المتغيرات السرية.

كل الصفحات

اضبط متغيرا

  1. افتح الخدمة واضغط ⌘K واختر انتقال › المتغيرات.

    تعرض الصفحة متغيرات الخدمة خاصة، ثم مشتركة وموفرة.

  2. اختر إضافة متغير، واكتب الاسم والقيمة، واضغط Enter. وإذا أردت تعديل الكثير دفعة واحدة، بدل العرض من قائمة إلى .env، وعدل أسطر NAME=value واختر تجهيز التغييرات.

    في الحالتين، ينتظر التعديل كتغيير مجهز.

  3. اضغط ⌘K، واختر مراجعة التغييرات، ثم اضغط ⌘↵ لكي تطبقه.

    وتطبيقه ينشر كل خدمة ويب يصل إليها المتغير.

كل متغير يصل إلى البناء وإلى الخدمة وهي تعمل معا، فلا يوجد ما تختاره.

في الـ CLI، يجهز أمر vars set المتغير أيضا، ويطبقه --apply في المرة نفسها:

تيرمينال
ghaym cloud vars set API_URL https://api.example.com --project shop --env production --service web --apply

شارك متغيرا مع البيئة كلها

يصل المتغير المشترك إلى كل خدمة في البيئة. يظهر عليه من البيئة في صفحة الخدمة. وإذا كان للخدمة متغير خاص بها بالاسم نفسه، فهو الذي يعمل، ويكتب على المشترك متجاوز. وعبر الـ CLI، لا تضع --service:

تيرمينال
ghaym cloud vars set LOG_LEVEL info --project shop --env production

أبق القيمة سرية

شغل سرية وأنت تضيف المتغير، أو اختر اجعل القيمة سرية من قائمة متغير موجود. لا تعرض قيمته مرة أخرى، ولا حتى لك، ولا يعود المتغير السري عاديا أبدا. ويصل المتغير السري إلى البناء وإلى الخدمة وهي تعمل كأي متغير آخر.

  • في سجلات البناء، يخفي غيم قيمته فتظهر •••••••• أينما طبعت، متى كانت القيمة 4 أحرف أو أكثر.
  • في أسطر الأوامر التي يشغلها غيم للبناء، تحل محله قيمة بديلة، ولا تظهر قيمته أبدا.
  • المتغير الذي تشير قيمته إلى متغير سري، أو إلى كلمة مرور قاعدة بيانات، أو إلى المفتاح السري لمخزن، هو متغير سري أيضا.
  • ما تفعله خطوات البناء الخاصة بك وكودك بالقيمة أمر يخصك: لا يخفي غيم شيئا من الأسطر التي يكتبها تطبيقك في سجلاته.
تيرمينال
ghaym cloud vars set STRIPE_KEY <value> --project shop --env production --service web --secret

اقرأ المتغيرات في Dockerfile

الخدمة التي تبنى بـ Dockerfile تأخذ كل متغير عادي كـ build arg، وكل متغير سري كـ build secret. اقرأ المتغير العادي بـ ARG، واربط المتغير السري بالخطوة التي تحتاجه:

dockerfile
ARG VITE_API_URL
RUN --mount=type=secret,id=STRIPE_KEY,env=STRIPE_KEY npm run build

المتغير السري لا يكون build arg أبدا، فلا يقرأ ARG STRIPE_KEY شيئا. والمتغير العادي لا يكون build secret أبدا، فلا يجد ربطه شيئا.

تغيير قيمة متغير سري يعيد بناء الخدمة دون الـ cache. وتغيير متغير عادي يبقي الطبقات التي فوق أول ARG يقرؤه.

والخدمة التي تبنى دون Dockerfile لا تحتاج شيئا إضافيا: كل خطوة من بنائها تأخذ كل متغير، وكل متغير سري كـ build secret.

ثبت الحزم من npm registry خاص

أضف إلى الـ repo ملف .npmrc يسمي الـ token باسم متغيره، واضبط NPM_TOKEN كمتغير سري:

ini
@acme:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NPM_TOKEN}

الخدمة التي تبنى دون Dockerfile لا تحتاج أكثر من ذلك. وفي Dockerfile، انسخ .npmrc مع ملفات الحزم، واربط المتغير السري بخطوة التثبيت:

dockerfile
COPY package.json package-lock.json .npmrc ./
RUN --mount=type=secret,id=NPM_TOKEN,env=NPM_TOKEN npm ci

اربط قاعدة بيانات أو مخزنا

لا تصل قيم قاعدة البيانات إلى الخدمة إلا عبر متغير تراه. اجعل قيمة المتغير مرجعا: ${{postgres.DATABASE_URL}} يقرأ DATABASE_URL من قاعدة البيانات التي اسمها postgres، ويملؤه غيم وقت النشر. مرجع مثل ${{Service.VAR}} يعمل داخل موقع واحد فقط. وتصل إلى خدمة الويب في موقع آخر عبر عنوانها العام. اختر نسخ كمرجع من قائمة متغير في صفحة قاعدة البيانات، وضعه كقيمة.

تيرمينال
ghaym cloud vars set DATABASE_URL '${{postgres.DATABASE_URL}}' --project shop --env production --service web

وما دامت خدمة الويب لا تشير إلى أي متغير من متغيرات قاعدة بيانات، تكتب صفحة متغيراته postgres غير موصولة بهذه الخدمة. اختر هناك أضف DATABASE_URL لتجهيز المرجع، أو تجاهل لإخفاء السطر.

ربط مخزن يجهز ستة متغيرات على الخدمة، من S3_ENDPOINT إلى S3_REGION، كل منها مرجع إلى متغير المخزن نفسه: ${{bucket:media.S3_BUCKET}} يقرأ S3_BUCKET من المخزن الذي اسمه media. يمكنك أن تغير أسماءها أو تحذفها، وفصل المخزن يزيلها.

القيم التي يضيفها غيم

يضيف غيم أربع قيم من عنده. والمتغير الذي تضبطه بالاسم نفسه يحل محل كل منها.

الاسمالقيمةتصل إلى
GHAYM_COUNTRYرمز الدولة التي تعمل فيها الخدمة، مثل JOالبناء والخدمة وهي تعمل
GHAYM_SITEالموقع الذي تعمل فيه، مثل amman-1البناء والخدمة وهي تعمل
PORTمنفذ التطبيقالخدمة وهي تعمل
NODE_OPTIONS--max-old-space-size بنسبة 75% من ذاكرة الخدمةالخدمة وهي تعمل

شغل الـ migrations عند التشغيل

لا يصل البناء إلى الشبكة الخاصة بالمشروع، فلا تصل الـ migration إلى قاعدة بياناتك أثناءه. شغل الـ migrations عند بدء التطبيق بدلا من ذلك، في أمر التشغيل في إعدادات البناء:

تيرمينال
npx prisma migrate deploy && node server.js