متغيّرات البيئة
أضِف وعدّل متغيّرات مشفّرة، واربط قاعدة بيانات بخدمتك.
تضبط متغيّرات البيئة خدمتك دون تغيير الشيفرة. كل قيمة مشفّرة أثناء التخزين ومقنّعة في الواجهة. يستطيع المسؤولون إظهار القيم، ويُسجَّل كل إظهار في سجلّ التدقيق. أما المتغيّر المعلَّم سريًّا فلا يمكن إظهاره مجددًا أبدًا.
أضِف متغيّرًا أو عدّله#
- 1
افتح تبويب Environment
في صفحة الخدمة، انتقل إلى تبويب Environment.
- 2
أدخِل مفتاحًا وقيمة
اكتب اسم المتغيّر (يُحوَّل تلقائيًا إلى أحرف كبيرة، مثل NODE_ENV) وقيمته، ثم انقر «إضافة». إذا أعدت استخدام مفتاح موجود، تُستبدل قيمته.
- 3
أعِد النشر للتطبيق
تسري التغييرات عند النشر التالي. انقر «نشر» عندما تكون جاهزًا.
تعرض القائمة معاينة مقنّعة، لا النص الصريح. لقراءة القيم، ينقر المسؤول «إظهار القيم»، ويُسجَّل كل إظهار في سجلّ التدقيق. أما المتغيّر المعلَّم «سري» فهو للكتابة فقط: لا يستطيع أحد إظهاره، لا من لوحة التحكّم ولا عبر API ولا عبر CLI.
اربط قاعدة بيانات#
افتح تبويب الاتصال في قاعدة البيانات لإظهار كتلة متغيّرات اتصال جاهزة للّصق، مثل DATABASE_URL لـ Postgres وMySQL، وMONGODB_URI لـ MongoDB، وREDIS_URL لـ Redis. انسخها إلى بيئة خدمتك.
الحدود والقواعد#
- تُحوَّل المفاتيح إلى أحرف كبيرة تلقائيًا (يصبح node_env هو NODE_ENV).
- يمكن أن تبلغ القيم 32,768 حرفًا.
- تسري التغييرات عند النشر التالي.
- عبر API وCLI، تعيد قائمة المتغيّرات المفاتيح مع قيم مقنّعة. يستطيع المسؤول قراءة القيم بالأمر gheima env reveal، الذي لا يعيد أبدًا أي متغيّر سري.
مجموعات البيئة (إعداد مشترك)#
أنشئ مجموعة بيئة قابلة لإعادة الاستخدام من صفحة مجموعات البيئة، وأضِف متغيّرات (أو استورد ملف .env)، ثم أرفِقها بعدة خدمات. عند النشر، تُحقن متغيّرات المجموعة في كل خدمة مرفقة. وتتغلّب متغيّرات الخدمة نفسها على متغيّرات المجموعة. تفيد المجموعة في الإعدادات والأسرار التي تتشاركها عدة خدمات.
متغيرات البناء#
تُحقن المتغيّرات عادةً عند تشغيل الحاوية، فلا ينتهي أي سرّ داخل الصورة. لكن بعض عمليات البناء تحتاجها قبل ذلك: تطبيق Next.js يولّد صفحاته مسبقًا من قاعدة البيانات، أو قيم NEXT_PUBLIC_ وVITE_ المُضمَّنة في حزمة المتصفح. علّم تلك المفاتيح بأيقونة المطرقة في تبويب البيئة، أو أضفها تحت «متغيرات البناء».
- لا يصل إلى البناء إلا المفاتيح التي تعلّمها. أما البقية فتبقى متاحة وقت التشغيل حصرًا.
- تُركَّب القيم كأسرار بناء للخطوة التي تقرأها، ولا تُكتب أبداً في طبقة من الصورة.
- تُحلّ المفاتيح كما في وقت التشغيل، فيكفي إدراج مفتاح DATABASE_URL لقاعدة بيانات مرتبطة.
- ما يكتبه البناء انطلاقاً من قيمة يبقى: قيمة NEXT_PUBLIC_ المُضمَّنة تظل في الحزمة لأن إطار العمل هو من وضعها هناك.
✦ تقرأ خدمتك الإعدادات وبيانات اعتماد قاعدة البيانات من البيئة، مشفّرة وخارج شيفرتك.