اضبط المتغيرات والأسرار
أضف متغيرات الخدمة وعدلها واحذفها، وشاركها مع البيئة كلها، وعلم المتغيرات السرية.
كل الصفحات
- افتح الخدمة واضغط ⌘K واختر انتقال › المتغيرات.
تعرض الصفحة متغيرات الخدمة خاصة، ثم مشتركة وموفرة.
- اختر إضافة متغير، واكتب الاسم والقيمة، واضغط Enter. وإذا أردت تعديل الكثير دفعة واحدة، بدل العرض من قائمة إلى .env، وعدل أسطر
NAME=valueواختر تجهيز التغييرات.في الحالتين، ينتظر التعديل كتغيير مجهز.
- اضغط ⌘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 تأخذ كل متغير عادي كـ build arg، وكل متغير سري كـ build secret. اقرأ المتغير العادي بـ ARG، واربط المتغير السري بالخطوة التي تحتاجه:
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.
أضف إلى الـ repo ملف .npmrc يسمي الـ token باسم متغيره، واضبط NPM_TOKEN كمتغير سري:
@acme:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NPM_TOKEN}الخدمة التي تبنى دون Dockerfile لا تحتاج أكثر من ذلك. وفي Dockerfile، انسخ .npmrc مع ملفات الحزم، واربط المتغير السري بخطوة التثبيت:
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% من ذاكرة الخدمة | الخدمة وهي تعمل |
لا يصل البناء إلى الشبكة الخاصة بالمشروع، فلا تصل الـ migration إلى قاعدة بياناتك أثناءه. شغل الـ migrations عند بدء التطبيق بدلا من ذلك، في أمر التشغيل في إعدادات البناء:
npx prisma migrate deploy && node server.js