پرش به مطلب اصلی

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

متغیرهای محیطی یا Environment Variables به کاربران این امکان را می‌دهند که پارامترهایی را در محیط اجرایی اپلیکیشن‌های پردازش لبه تعریف و در کدهای خود از آن‌ها استفاده کنند. این متغیرها باید به‌شکل یک مقدار معتبر در قالب JSON تعریف شوند.

توجه داشته باشید که این مقادیر فقط نباید یک شی (Object) باشند، بلکه می‌توانند هر مقدار معتبری در قالب JSON، مانند عدد صحیح، عدد اعشاری، آرایه، مقدار بولی یا حتی رشته‌ای با ساختار JSON باشد.

برای نمونه، تمامی موارد زیر به عنوان مقدار معتبر پذیرفته می‌شود:

"encrypted_value"
992647896
true
[1, 2, 3]
{ "API_KEY": "abcdef123456" }

با تعریف یک متغیر محیطی در پردازش لبه آروان‌کلاد، می‌توانید به آن در همه‌ی نمونه‌های یک اپلیکیشن Edge Computing دسترسی داشته باشید. با این کار، نیازی به تعریف دوباره‌ی متغیر در کد ندارید و می‌توانید از آن در بخش‌های مختلف اپلیکیشن استفاده کنید.

توجه داشته باشید که هر Environment Variable تنها در همان اپلیکیشنی که در آن تعریف شده قابل استفاده است و در سایر اپلیکیشن‌های Edge Compute در دسترس نخواهد بود.

برای نمونه، تصور کنید که متغیری با نام API_URL تعریف کرده‌اید که URL یک سرویس وب را در خود نگه می‌دارد. این متغیر می‌تواند به‌شکل زیر در قالب JSON تعریف شود:

"https://api.example.com"

این متغیر فقط در همان اپلیکیشینی که تعریف شده قابل استفاده خواهد بود و برای استفاده از آن در سایر اپلیکیشن‌ها باید آن را در هر اپ به‌شکل جداگانه ثبت کنید.

تعریف Environment Variable

برای تعریف یک متغیر محیطی وارد پنل پردازش لبه آروان‌کلاد شوید و روی اپلیکیشنی که می‌خواهید برای آن متغیر تعریف کنید، کلیک کنید.

بخش تنظیمات را انتخاب و روی دکمه‌ی «متغیر جدید» کلیک کنید.

در صفحه‌ی جدیدی که باز می‌شود، نام و مقدار متغیر را وارد کنید.

در همین صفحه می‌توانید انتخاب کنید متغیرتان رمزگذاری شود. زمانی که یک متغیر رمزگذاری می‌شود، مقدار آن قابل مشاهده نخواهد بود و فقط در زمان اجرا (Runtime) در دسترس قرار می‌گیرد.

برای نمونه، فرض کنید که کاربر یک متغیر به نام API_KEY دارد که حاوی یک کلید امنیتی است. این متغیر می‌تواند به‌شکل رمزنگاری‌شده در محیط اجرایی قرار بگیرد تا مقدار آن تنها در هنگام اجرای اپلیکیشن قابل دسترسی باشد.

توجه داشته باشید با رمزگذاری متغیر دیگر امکان مشاهده‌ی آن را در پنل ندارید.

پس از تعریف متغیر روی «انتشار» کلیک کنید.

توجه داشته باشید که یک متغیر رزرو‌شده با نام EC_URL به‌شکل پیش‌فرض در همه‌ی اپلیکیشن‌های Edge Compute تعریف شده است. این متغیر نشان‌دهنده‌ی مسیر اجرایی اپلیکیشن بر بستر پردازش لبه است و قابل بازنویسی یا استفاده‌ی دوباره به‌وسیله‌ی کاربران نیست.