AzureResourceGroupDeployment@1 - مهمة توزيع مجموعة موارد Azure الإصدار 1

مقالة
06/11/2024

استخدم هذه المهمة لنشر مجموعات موارد Azure وبدء تشغيلها وإيقافها وحذفها.

تم إهمال هذه المهمة؛ استخدم AzureResourceGroupDeployment@2.

بناء الجملة

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

الإدخالات

ConnectedServiceNameSelector - نوع اتصال Azure
string. القيم المسموح بها: ConnectedServiceName (Azure Resource Manager)، ConnectedServiceNameClassic (Azure Classic). القيمة الافتراضية: ConnectedServiceName.

مطلوب تحديد اتصال الخدمة الذي يحتوي على اشتراك Azure للتوزيع.

ConnectedServiceName - اشتراك Azure
string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceName.

مطلوب تحديد اتصال الخدمة الذي يحتوي على اشتراك Azure للتوزيع.

ConnectedServiceNameClassic - اشتراك Azure Classic
string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceNameClassic.

تحديد اشتراك Azure Classic للتوزيع.

action - العمل
string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceName. القيم المسموح بها: Create Or Update Resource Group، ، Select Resource GroupStart (بدء الأجهزة الظاهرية)، Stop (إيقاف الأجهزة الظاهرية)، Restart (إعادة تشغيل الأجهزة الظاهرية)، Delete (حذف الأجهزة الظاهرية)، DeleteRG (حذف مجموعة الموارد). القيمة الافتراضية: Create Or Update Resource Group.

الإجراء الذي سيتم تنفيذه على موارد Azure أو مجموعة الموارد.

actionClassic - العمل
string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceNameClassic. القيم المسموح بها: Select Resource Group (حدد خدمة السحابة). القيمة الافتراضية: Select Resource Group.

الإجراء الذي سيتم تنفيذه على موارد Azure أو الخدمة السحابية.

resourceGroupName - مجموعة الموارد
string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceName.

يوفر اسم مجموعة الموارد.

cloudService - خدمة السحابة
string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceNameClassic.

يوفر اسم الخدمة السحابية.

location - موقع
string. مطلوب عند action = Create Or Update Resource Group. القيم المسموح بها: و و Canada Centralو و Canada Eastو Central IndiaوEast AsiaWest US 2West IndiaSouth Central USNorth EuropeSouth IndiaJapan WestSoutheast AsiaEast US 2 UK SouthEast USWest USWest EuropeWest Central USUK WestNorth Central USCentral USJapan East. Brazil SouthAustralia SoutheastAustralia East القيمة الافتراضية: East US.

موقع توزيع مجموعة الموارد. إذا كانت مجموعة الموارد موجودة بالفعل في الاشتراك، فسيتم تجاهل هذه القيمة.

csmFile - قالب
string. مطلوب عند action = Create Or Update Resource Group.

يحدد المسار أو النمط الذي يشير إلى قالب Azure Resource Manager. تعرف على المزيد حول قوالب Azure Resource Manager. للبدء على الفور، استخدم نموذج القالب هذا.

csmParametersFile - معلمات القالب
string. ‏‏اختياري. استخدم عندما action = Create Or Update Resource Group.

يحدد عنوان URL لملف المعلمات. مثال على URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

لاستخدام ملف مخزن في حساب تخزين خاص، قم باسترداد وتضمين الرمز المميز لتوقيع الوصول المشترك (SAS) في عنوان URL للقالب. مثال: <blob_storage_url>/template.json?<SAStoken> لتحميل ملف معلمات إلى حساب تخزين وإنشاء رمز SAS مميز، استخدم مهمة نسخ ملف Azure أو اتبع الخطوات باستخدام PowerShell أو Azure CLI.

لعرض معلمات القالب في شبكة، انقر فوق … بجوار مربع النص تجاوز معلمات القالب. تتطلب هذه الميزة تمكين قواعد CORS في المصدر. إذا كانت القوالب في كائن ثنائي كبير الحجم لتخزين Azure، فراجع مشاركة الموارد عبر المنشأ لتمكين CORS.

overrideParameters - تجاوز معلمات القالب
string. ‏‏اختياري. استخدم عندما action = Create Or Update Resource Group.

يحدد معلمات القالب لتجاوزها.

لعرض معلمات القالب في شبكة، انقر فوق ... بجوار مربع النص تجاوز المعلمات. تتطلب هذه الميزة تمكين قواعد CORS في المصدر. إذا كانت القوالب موجودة في كائن تخزين Azure الثنائي كبير الحجم، فراجع هذه السلسلة لتمكين CORS، أو اكتب معلمات القالب لتجاوزها في مربع النص.

مثال:-storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

إذا كانت قيمة المعلمة تحتوي على كلمات متعددة، فقم بإحاطة الكلمات بعلامات اقتباس، حتى إذا كنت تمرر القيمة باستخدام المتغيرات. على سبيل المثال، ⁧-name "parameter value" -name2 "$(var)"⁩. لتجاوز معلمات نوع العنصر، استخدم كائنات JSON سلسلة. على سبيل المثال، ⁧-options ["option1"] -map {"key1": "value1" }⁩.

deploymentMode - وضع التوزيع
string. مطلوب عند action = Create Or Update Resource Group. القيم المسموح بها: Validation (التحقق فقط)، Incremental، ، Complete. القيمة الافتراضية: Incremental.

Incremental يعالج الوضع عمليات التوزيع ك تحديثات تزايدية لمجموعة الموارد. يترك الموارد التي لم تتغير الموجودة في مجموعة الموارد ولكن لم يتم تحديدها في القالب.

Complete يحذف الوضع الموارد غير الموجودة في القالب الخاص بك. يستغرق الوضع الكامل وقتا أطول نسبيا من الوضع التزايدي. إذا انتهت مهلة المهمة، ففكر في زيادة المهلة أو التغيير إلى Incremental الوضع .

تحذير

سيقوم الوضع الكامل بحذف جميع الموارد الموجودة في مجموعة الموارد غير المحددة في القالب. راجع ما إذا كانت مجموعة الموارد التي تقوم بتوزيعها لا تحتوي على أي موارد ضرورية لم يتم تحديدها في القالب.

Validate يمكنك الوضع من العثور على مشكلات في القالب قبل إنشاء الموارد الفعلية.

ملاحظة

Validate يقوم الوضع دائما بإنشاء مجموعة موارد، حتى إذا لم يتم نشر أي موارد.

تعرف على المزيد حول أوضاع التوزيع.

enableDeploymentPrerequisitesForCreate - تمكين المتطلبات الأساسية للتوزيع
boolean. ‏‏اختياري. استخدم عندما action = Create Or Update Resource Group. القيمة الافتراضية: false.

ينطبق فقط عندما تحتوي مجموعة الموارد على أجهزة ظاهرية.

يؤدي اختيار خيار Deployment Group إلى تكوين عامل Deployment Group على كل جهاز من الأجهزة الظاهرية.

يؤدي تحديد خيار WinRM إلى تكوين وحدة استماع Windows Remote Management (WinRM) عبر بروتوكول HTTPS على المنفذ 5986 باستخدام شهادة موقعة ذاتيا. هذا التكوين مطلوب لتنفيذ عملية التوزيع على أجهزة Azure. إذا كانت الأجهزة الظاهرية الهدف مدعومة بموازن تحميل، فتأكد من تكوين قواعد NAT الواردة للمنفذ الهدف (5986).

enableDeploymentPrerequisitesForSelect - تمكين المتطلبات الأساسية للتوزيع
boolean. ‏‏اختياري. استخدم عندما action = Select Resource Group. القيمة الافتراضية: false.

ينطبق فقط عندما تحتوي مجموعة الموارد على أجهزة ظاهرية.

يؤدي اختيار خيار Deployment Group إلى تكوين عامل Deployment Group على كل جهاز من الأجهزة الظاهرية.

يؤدي تحديد خيار WinRM إلى تكوين وحدة استماع Windows Remote Management (WinRM) عبر بروتوكول HTTPS على المنفذ 5986 باستخدام شهادة موقعة ذاتيا. هذا التكوين مطلوب لتنفيذ عملية التوزيع على أجهزة Azure. إذا تم دعم الأجهزة الظاهرية الهدف بواسطة موازن تحميل، فتأكد من تكوين قواعد NAT الواردة للمنفذ الهدف (5986).

outputVariable - مجموعة الموارد
string.

مطلوب عند تحديد مجموعة موارد موجودة. يوفر اسما لمتغير مجموعة الموارد. يمكن استخدام المتغير للإشارة $(variableName) إلى مجموعة الموارد في المهام اللاحقة، كما هو الحال في مهمة PowerShell على الأجهزة الهدف لنشر التطبيقات.

صالح فقط عندما يكون الإجراء المحدد هو Createأو Updateأو Select.

خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	يجب أن يكون لدى العوامل المستضافة ذاتيا قدرات تطابق الطلبات التالية لتشغيل المهام التي تستخدم هذه المهمة: azureps
القدرات	لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	1.103.0 أو أحدث
فئة المهمة	نشر

مشاركة عبر