مرجع متغيرات 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.