متغيّرات البيئة

تضبط متغيّرات البيئة خدمتك دون تغيير الشيفرة. كل قيمة مشفّرة أثناء الراحة، ومقنّعة في الواجهة، ولا تُعرض ثانيةً بعد الحفظ.

أضِف متغيّرًا أو عدّله#

1. 1

   افتح تبويب Environment

   في صفحة الخدمة، انتقل إلى تبويب Environment.

2. 2

   أدخِل مفتاحًا وقيمة

   اكتب اسم المتغيّر (يُحوَّل تلقائيًا إلى أحرف كبيرة، مثل NODE_ENV) وقيمته، ثم انقر «Add». إعادة استخدام مفتاح تكتب فوقه.

3. 3

   أعِد النشر للتطبيق

   تسري التغييرات عند النشر التالي — انقر «Deploy» عندما تكون جاهزًا.

اربط قاعدة بيانات#

افتح تبويب Connect لقاعدة بيانات لتكشف كتلة متغيّرات اتصال جاهزة للّصق — مثل DATABASE_URL لـ Postgres/MySQL، وMONGODB_URI لـ MongoDB، وREDIS_URL لـ Redis. انسخها إلى بيئة خدمتك.

الحدود والقواعد#

• تُحوَّل المفاتيح إلى أحرف كبيرة تلقائيًا (يصبح node_env هو NODE_ENV).
• يمكن أن تبلغ القيم 32,768 حرفًا.
• تسري التغييرات عند النشر التالي.
• تعيد واجهة البرمجة وواجهة الأوامر المفاتيح فقط — لا القيم المخزّنة أبدًا.

مجموعات البيئة (إعداد مشترك)#

أنشئ مجموعة بيئة قابلة لإعادة الاستخدام من مجموعات البيئة، أضِف متغيّرات (أو استورد ملف ‎.env‎)، واربطها بعدة خدمات. عند النشر تُحقَن متغيّرات المجموعة في كل خدمة مرتبطة — وتُغلِّب متغيّرات الخدمة نفسها. مفيدة للأسرار والإعدادات المشتركة.

متغيرات البناء#

تُحقن المتغيرات عادةً عند تشغيل الحاوية، فلا ينتهي أي سر داخل الصورة. بعض عمليات البناء تحتاجها قبل ذلك — تطبيق Next.js يولّد صفحاته مسبقاً من قاعدة البيانات، أو قيم NEXT_PUBLIC_/VITE_ المُضمَّنة في حزمة المتصفح. علّم تلك المفاتيح بأيقونة المطرقة في تبويب البيئة، أو أضفها تحت «متغيرات البناء».

• تُتاح المفاتيح التي تعلّمها فقط — وما عداها يبقى وقت التشغيل حصراً.
• تُركَّب القيم كأسرار بناء للخطوة التي تقرأها، ولا تُكتب أبداً في طبقة من الصورة.
• تُحلّ المفاتيح كما في وقت التشغيل، فيكفي إدراج مفتاح DATABASE_URL لقاعدة بيانات مرتبطة.
• ما يكتبه البناء انطلاقاً من قيمة يبقى: قيمة NEXT_PUBLIC_ المُضمَّنة تظل في الحزمة لأن إطار العمل هو من وضعها هناك.