دالة ملف المعلمات ل Bicep
يوفر Bicep دالة تسمى readEnvironmentVariable() تسمح لك باسترداد القيم من متغيرات البيئة. كما يوفر المرونة لتعيين قيمة افتراضية إذا لم يكن متغير البيئة موجودا. يمكن استخدام هذه الدالة فقط في الملفات .bicepparam . لمزيد من المعلومات، راجع ملف معلمات Bicep.
getSecret
getSecret(subscriptionId, resourceGroupName, keyVaultName, secretName, secretVersion)
إرجاع سر من Azure Key Vault. استخدم هذه الدالة لتمرير سر إلى معلمة سلسلة آمنة لملف Bicep.
إشعار
يمكنك أيضا استخدام الدالة keyVaultName.getSecret(secretName) من داخل .bicep ملف.
using './main.bicep'
param secureUserName = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretUserName')
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
تحصل على خطأ إذا كنت تستخدم هذه الدالة مع استنتاج السلسلة.
يمكن استخدام مؤهل مساحة الاسم (az)، ولكنه اختياري، لأن الدالة متوفرة من مساحة اسم Azure الافتراضية.
المعلمات
| المعلمة | المطلوب | نوع | الوصف |
|---|---|---|---|
| subscriptionId | نعم | سلسلة | معرف الاشتراك الذي يحتوي على مورد key vault. |
| resourceGroupName | نعم | سلسلة | اسم مجموعة الموارد التي تحتوي على مورد key vault. |
| keyVaultName | نعم | سلسلة | اسم خزنة المفاتيح. |
| secretName | نعم | سلسلة | اسم السر المخزن في خزنة المفاتيح. |
| secretVersion | لا | سلسلة | إصدار السر المخزن في مخزن المفاتيح. |
قيمة الإرجاع
قيمة السر.
مثال
يحتوي الملف التالي .bicepparam على معلمة securePassword تحتوي على أحدث قيمة من <سر secretName> .
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
يحتوي الملف التالي .bicepparam على معلمة securePassword تحتوي على قيمة< سر secretName>، ولكن يتم تثبيته في secretValue> معين.<
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword', 'exampleSecretVersion')
readEnvironmentVariable
readEnvironmentVariable(variableName, [defaultValue])
إرجاع قيمة متغير البيئة، أو تعيين قيمة افتراضية إذا لم يكن متغير البيئة موجودا. يحدث تحميل المتغير أثناء التحويل البرمجي، وليس في وقت التشغيل.
مساحة الاسم: sys.
المعلمات
| المعلمة | المطلوب | نوع | الوصف |
|---|---|---|---|
| variableName | نعم | سلسلة | اسم المتغير. |
| defaultValue | لا | سلسلة | قيمة سلسلة افتراضية لاستخدامها إذا لم يكن متغير البيئة موجودا. |
قيمة الإرجاع
قيمة سلسلة متغير البيئة أو قيمة افتراضية.
الأمثلة
توضح الأمثلة التالية كيفية استرداد قيم متغيرات البيئة.
use './main.bicep'
param adminPassword = readEnvironmentVariable('admin_password')
param boolfromEnvironmentVariables = bool(readEnvironmentVariable('boolVariableName','false'))
الخطوات التالية
لمزيد من المعلومات حول ملف معلمات Bicep، راجع ملف المعلمات.