متغییرهای محیطی عبارت های key و value هستند که به صورت گلوبال در سطح کل سرویس قرار می گیرند و شما می توانید در پروژه خود از آن ها استفاده نمایید.

 

نحوه تنظیم متغیر محیطی در رانفلر

۱. وارد مدیریت پروژه شده و پروژه مورد نظر خود را انتخاب کنید.

 

 

۲. در صفحه لیست سرویس ها هست که روی تنظیمات سرویسی که می خواهید کلیک کنید تا وارد صفحه جزییات سرویس شوید.

 

 

۳. در صفحه جدید گزینه متغیر محیطی را کلیک کنید.

 

 

۵. در صفحه متغیر محیطی فیلد های Name و Value وجود دارد که می توانید متغیر های خود را وارد کرده و ذخیره کنید.

 

 

 

تنظیمات اضافه بخش متغیر محیطی

حالت Bulk edit : در این حالت می توانید به جای وارد کردن تک تک متغیر های محیطی یک edit text برای شما باز می شود که می توانید فایل متغیر محیطی که از قبل دارید رو کلا کپی و در این بخش Paste کنید.

 

 

فیلد Mode: این بخش شامل Manual هست که دستی مقدار وارد میکنید در Value و حالت Secret که می توانید از لیست سکرت هایی که در سطح پروژه تعریف کردید استفاده کنید (کاربرد این بخش بیشتر برای امنیت پسورد ها است)

 

فیلد Use case: این بخش شامل All یعنی هم در زمان بیلد و هم در زمان اجرا متغیر وجود داشته باشد و حالت Build که می توانید مشخص کنید فقط در سطح بیلد متغیر وجود داشته باشد و حالت آخر Running است که یعنی فقط در زمان اجرا این متغیر استفاده شود.

 

نکات مهم

 

نکته ۱ : در فریم‌ورک‌های فرانت‌اند (React، Vue، Angular) و همچنین Next.js و Nuxt.js، متغیرهای محیطی که در کد سمت کلاینت استفاده می‌شوند (مثل NEXT_PUBLIC_*، NUXT_PUBLIC_*، VITE_*، REACT_APP_* و مشابه آن‌ها)، به‌دلیل اینکه خروجی بیلد به‌صورت استاتیک تولید می‌شود و این متغیرها فقط در زمان بیلد جایگزین می‌شوند، برای اعمال تغییرات آن‌ها نیاز به بیلد و استقرار مجدد (Redeploy) است و باید یک دیپلوی جدید انجام شود .

 

نکته ۲ : متغیرهایی که فقط در سمت سرور (runtime) خوانده می‌شوند و Use case آن‌ها روی Running تنظیم شده باشد، معمولاً با ریستارت سرویس اعمال می‌شوند.

 

نکته ۳ : همچنین بهتر است فیلد Use case با دقت انتخاب شود اگر متغیر را برای حالت بیلد نیاز ندارید حتما روی حالت Running ست کنید تا روی سرعت بیلد تاثیر منفی نداشته باشد.