مرجع متغيرات Azure Deployment Environment CLI
تقوم بيئات نشر Azure (ADE) بتعيين العديد من المتغيرات المتعلقة بالبيئة التي يمكنك الرجوع إليها أثناء تأليف صور مخصصة. يمكنك استخدام المتغيرات أدناه داخل البرامج النصية للعملية (deploy.sh أو delete.sh) لجعل صورك مرنة للبيئة التي تتفاعل معها.
بالنسبة للملفات المستخدمة بواسطة ADE داخل الحاوية، توجد جميعها في ade
مجلد فرعي خارج الدليل الأولي.
فيما يلي قائمة متغيرات البيئة المتوفرة:
ADE_ERROR_LOG
يشير إلى الملف الموجود في /ade/temp/error.log
. يخزن error.log
الملف أي إخراج خطأ قياسي يملأ تفاصيل خطأ البيئة في نتيجة فشل النشر أو الحذف. يتم استخدام الملف مع ade execute
، الذي يسجل أي إخراج قياسي ومحتوى خطأ قياسي إلى ملف سجل مدار بواسطة ADE. عند استخدام الأمر ، قم بإعادة ade execute
توجيه تسجيل الأخطاء القياسي إلى موقع الملف هذا باستخدام الأمر التالي:
ade execute --operation $ADE_OPERATION_NAME --command "{YOUR_COMMAND}" 2> >(tee -a $ADE_ERROR_LOG)
باستخدام هذا الأسلوب، يمكنك عرض خطأ النشر أو الحذف داخل مدخل المطور. يؤدي هذا إلى تكرارات تصحيح الأخطاء أسرع وأكثر نجاحا عند إنشاء صورتك المخصصة، وتشخيص أسرع للسبب الجذري للعملية الفاشلة.
ADE_OUTPUTS
يشير إلى الملف الموجود في /ade/temp/output.json
. يخزن output.json
الملف أي مخرجات من نشر بيئة في التخزين المستمر، بحيث يمكن الوصول إليه باستخدام Azure CLI في وقت لاحق. عند تخزين الإخراج في صورة مخصصة، تأكد من تحميل الإخراج إلى الملف المحدد، كما هو موضح في المثال التالي:
echo "$deploymentOutput" > $ADE_OUTPUTS
ADE_STORAGE
يشير إلى الدليل الموجود في /ade/storage
. أثناء نقطة إدخال الصورة الأساسية، يسحب ADE ملفا مسمى storage.zip
خصيصا من حاوية التخزين الخاصة بالبيئة ويملأ هذا الدليل، ثم عند الانتهاء من العملية، يعيد تحميل الدليل كملف مضغوط مرة أخرى إلى حاوية التخزين. إذا كان لديك ملفات ترغب في الرجوع إليها داخل صورتك المخصصة على عمليات إعادة التوزيع اللاحقة، مثل ملفات الحالة، فضعها داخل هذا الدليل.
ADE_CLIENT_ID
يشير إلى معرف الكائن لهوية الخدمة المدارة (MSI) لنوع بيئة مشروع البيئة. يمكن استخدام هذا المتغير للتحقق من صحة Azure CLI للحصول على أذونات لاستخدامها داخل الحاوية، مثل نشر البنية الأساسية.
ADE_TENANT_ID
يشير إلى المعرف الفريد العمومي للمستأجر للبيئة.
ADE_SUBSCRIPTION_ID
يشير إلى المعرف الفريد العمومي للاشتراك للبيئة.
ADE_TEMPLATE_FILE
يشير إلى مكان تواجد ملف القالب الرئيسي المحدد في الخاصية "templatePath" في تعريف البيئة داخل الحاوية. يعكس هذا المسار تقريبا التحكم بالمصادر في مكان الكتالوج، اعتمادا على مستوى مسار الملف الذي قمت بتوصيل الكتالوج به. يقع الملف تقريبا في /ade/repository/{CATALOG_NAME}/{PATH_TO_TEMPLATE_FILE}
. يتم استخدام هذا الأسلوب بشكل أساسي أثناء خطوة التوزيع الرئيسية كملف المشار إليه لإسناد التوزيع إلى إيقاف التشغيل.
وفيما يلي مثال باستخدام واجهة سطر الأوامر لـ Azure :
az deployment group create --subscription $ADE_SUBSCRIPTION_ID \
--resource-group "$ADE_RESOURCE_GROUP_NAME" \
--name "$deploymentName" \
--no-prompt true --no-wait \
--template-file "$ADE_TEMPLATE_FILE" \
--parameters "$deploymentParameters" \
--only-show-errors
يتم تخزين أي ملفات أخرى، مثل دعم ملفات IaC أو الملفات التي ترغب في استخدامها في صورتك المخصصة، في موقعها النسبي إلى ملف القالب داخل الحاوية كما هي داخل الكتالوج. على سبيل المثال، خذ الدليل التالي:
├───SampleCatalog
├───EnvironmentDefinition1
│ file1.bicep
│ main.bicep
│ environment.yaml
│
└───TestFolder
test1.txt
test2.txt
في هذه الحالة، $ADE_TEMPLATE_FILE=/ade/repository/SampleCatalog/EnvironmentDefinition1/main.bicep
. بالإضافة إلى ذلك، ستكون ملفات مثل file1.bicep موجودة داخل الحاوية في /ade/repository/SampleCatalog/EnvironmentDefinition1/file1.bicep
، وسيكون test2.txt موجودا في /ade/repository/SampleCatalog/EnvironmentDefinition1/TestFolder/test2.txt
.
ADE_ENVIRONMENT_NAME
اسم البيئة المعطاة في وقت النشر.
ADE_ENVIRONMENT_LOCATION
الموقع الذي يتم نشر البيئة فيه. هذا الموقع هو منطقة المشروع.
ADE_RESOURCE_GROUP_NAME
اسم مجموعة الموارد التي تم إنشاؤها بواسطة ADE لنشر الموارد الخاصة بك إليها.
ADE_ENVIRONMENT_TYPE
اسم نوع بيئة المشروع المستخدم لنشر هذه البيئة.
ADE_OPERATION_PARAMETERS
كائن JSON للمعلمات المتوفرة لنشر البيئة. وفيما يلي مثال لكائن المعلمات:
{
"location": "locationInput",
"name": "nameInput",
"sampleObject": {
"sampleProperty": "sampleValue"
},
"sampleArray": [
"sampleArrayValue1",
"sampleArrayValue2"
]
}
ADE_OPERATION_NAME
نوع العملية التي يتم تنفيذها على البيئة. اليوم، هذه القيمة هي إما "نشر" أو "حذف".
ADE_HTTP__OPERATIONID
معرف العملية المعين للعملية التي يتم تنفيذها على البيئة. يتم استخدام معرف العملية كتحقق من الصحة لاستخدام ADE CLI، وهو المعرف الرئيسي في استرداد السجلات من العمليات السابقة.
ADE_HTTP__DEVCENTERID
معرف مركز التطوير للبيئة. يتم أيضا استخدام معرف مركز التطوير كتحقق من الصحة لاستخدام ADE CLI.
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ