Docs

متغیرهای محیطی

تعریف، ویرایش و اعمال متغیرهای محیطی پروژه در بیلد و اجرا.

متغیر محیطی چیست؟

متغیر محیطی یک جفت KEY=value است که برنامه هنگام بیلد و اجرا می‌خواند. با آن می‌توانید بدون تغییر کد، تنظیمات محیط را عوض کنید؛ مثلاً آدرس دیتابیس یا حالت اجرا.

ویرایش متغیرها

  1. صفحهٔ پروژه را باز کنید.
  2. به تب تنظیمات بروید.
  3. تب متغیرهای محیطی (ENV) را انتخاب کنید.
  4. متغیرها را ویرایش کنید.
  5. روی تغییر دادن ENV بزنید.
می‌توانید هر متغیر را در یک ردیف جدا وارد کنید یا حالت متنی را انتخاب کنید و همه را یک‌جا بچسبانید. در حالت متنی، هر خط باید به شکل KEY=value باشد.
محدودیت‌ها:
  • حداکثر ۳۰۰ متغیر.
  • کلید فقط می‌تواند شامل حروف، عدد، -، _ و . باشد.
  • مقدار نباید شامل " باشد یا با \ تمام شود.
  • خطی که با # شروع شود به‌عنوان توضیح پذیرفته می‌شود.

بعد از ذخیره چه می‌شود؟

نوع اعمال تغییر به نوع پروژه و وضعیت آن بستگی دارد:
  • در پروژه‌های فرانت‌اند و برخی انواع Node، یک پایپلاین جدید ساخته می‌شود.
  • در بقیهٔ پروژه‌ها، برنامه ری‌استارت می‌شود.
  • اگر پروژه در وضعیت عدم موجودی کافی باشد، تغییر ذخیره می‌شود اما اجرا نمی‌شود تا موجودی شارژ شود.
بعد از ذخیره، وضعیت را در تب پایپلاین‌ها یا لاگ‌ها بررسی کنید.

نکات امنیتی

  • رمزها و توکن‌ها را در متغیر محیطی بگذارید، نه داخل ریپازیتوری.
  • متغیرها برای اعضای تیم پروژه قابل دیدن هستند.
  • برای اطلاعات حساس، دسترسی اعضای تیم را محدود کنید.

عیب‌یابی

  • تغییرات اعمال نشده: بررسی کنید پایپلاین جدید ساخته شده یا پروژه ری‌استارت شده است.
  • بیلد بعد از تغییر خطا می‌دهد: مقدار متغیر را بررسی کنید؛ نقل‌قول دوتایی و بک‌اسلش پایانی مجاز نیست.
  • برنامه بالا نمی‌آید: مطمئن شوید کلیدها با نام مورد انتظار برنامه یکی هستند.

مرتبط