AzureResourceGroupDeployment@2 - مهمة توزيع مجموعة موارد Azure v2

توزيع قالب Azure Resource Manager (ARM) إلى مجموعة موارد وإدارة الأجهزة الظاهرية.

توزيع قالب إدارة موارد Azure (ARM) إلى مجموعة موارد. يمكنك أيضا بدء تشغيل جميع الأجهزة الظاهرية (VM) وإيقافها وحذفها وإلغاء تخصيصها في مجموعة موارد.

بناء الجملة

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.
    #useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group. Use individual output values without JSON.Stringify applied. Default: false.
# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.
# Azure Resource Group Deployment v2
# Deploy an Azure resource manager (ARM) template to a resource group. You can also start, stop, delete, deallocate all Virtual Machines (VM) in a resource group.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Outputs
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs.

الإدخالات

azureSubscription - اشتراك Azure
الاسم المستعار للإدخل: ConnectedServiceName. string. مطلوب

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


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

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


resourceGroupName - مجموعة الموارد
string. مطلوب

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


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

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


templateLocation - موقع القالب
string. مطلوب عند action = Create Or Update Resource Group. القيم المسموح بها: Linked artifact، . URL of the file القيمة الافتراضية: Linked artifact.

حدد إما البيانات الاصطناعية المرتبطة أو عنوان URL للملف.


csmFileLink - ارتباط القالب
string. مطلوب عند templateLocation = URL of the file && action = Create Or Update Resource Group.

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

لنشر قالب مخزن في حساب تخزين خاص، قم باسترداد وتضمين الرمز المميز لتوقيع الوصول المشترك (SAS) في عنوان URL للقالب. مثال: <blob_storage_url>/template.json?<SAStoken>

لتحميل ملف قالب (أو قالب مرتبط) إلى حساب تخزين وإنشاء رمز SAS مميز، استخدم مهمة نسخ ملف Azure أو اتبع الخطوات باستخدام PowerShell أو Azure CLI.

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


csmParametersFileLink - ارتباط معلمات القالب
string. ‏‏اختياري. استخدم عندما templateLocation = URL of the file && action = Create Or Update Resource Group.

يحدد عنوان URL لملف المعلمات. مثال: https://raw.githubusercontent.com/Azure/...

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

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


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

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


csmParametersFile - معلمات القالب
string. ‏‏اختياري. استخدم عندما templateLocation = Linked artifact && 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 لتمكين 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. القيم المسموح بها: Incremental، Complete، Validation (التحقق فقط). القيمة الافتراضية: Incremental.

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

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

تحذير

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

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

ملاحظة

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

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


enableDeploymentPrerequisites - تمكين المتطلبات الأساسية
string. ‏‏اختياري. استخدم عندما action = Create Or Update Resource Group || action = Select Resource Group. القيم المسموح بها: None، ConfigureVMwithWinRM (تكوين باستخدام عامل WinRM)، ConfigureVMWithDGAgent (تكوين باستخدام عامل مجموعة النشر). القيمة الافتراضية: None.

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

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

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


teamServicesConnection - اتصال خدمة Azure Pipelines
الاسم المستعار للإدخل: deploymentGroupEndpoint. string. مطلوب عند enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

يحدد اتصال الخدمة للاتصال بمؤسسة أو مجموعة Azure DevOps لتسجيل العامل.

يمكنك إنشاء اتصال خدمة باستخدام +New ثم تحديد Token-based authentication. تحتاج إلى رمز وصول شخصي (PAT) لإعداد اتصال خدمة. انقر Manage لتحديث تفاصيل اتصال الخدمة.


teamServicesConnection - اتصال خدمة Azure Pipelines/TFS
الاسم المستعار للإدخل: deploymentGroupEndpoint. string. مطلوب عند enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

يحدد اتصال الخدمة للاتصال بمؤسسة أو مجموعة Azure DevOps لتسجيل العامل.

يمكنك إنشاء اتصال خدمة باستخدام +New ثم تحديد Token-based authentication. تحتاج إلى رمز وصول شخصي (PAT) لإعداد اتصال خدمة. انقر Manage لتحديث تفاصيل اتصال الخدمة.


teamProject - مشروع الفريق
الاسم المستعار للإدخل: project. string. مطلوب عند enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

يحدد مشروع الفريق الذي يحدد مجموعة التوزيع.


deploymentGroupName - مجموعة التوزيع
string. مطلوب عند enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

يحدد مجموعة التوزيع التي سيتم تسجيل العامل (العوامل) عليها. تعرف على المزيد حول مجموعات التوزيع.


copyAzureVMTags - نسخ علامات جهاز Azure الظاهري إلى الوكلاء
boolean. ‏‏اختياري. استخدم عندما enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. القيمة الافتراضية: true.

يختار ما إذا كانت العلامات المكونة على جهاز Azure الظاهري بحاجة إلى نسخها إلى عامل مجموعة التوزيع المقابل.

بشكل افتراضي، يتم نسخ جميع علامات Azure باتباع التنسيق: Key: Value. مثال: Role : Web سيتم نسخ علامة Azure كما هي إلى جهاز العامل.

تعرف على المزيد حول استخدام العلامات لموارد Azure.


runAgentServiceAsUser - تشغيل خدمة العامل كمستخدم
boolean. ‏‏اختياري. استخدم عندما enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. القيمة الافتراضية: false.

تشغيل خدمة العامل كمستخدم آخر غير المستخدم الافتراضي إذا تم تعيين القيمة إلى true.

المستخدم الافتراضي موجود NT AUTHORITY\\SYSTEM في Windows وفي root Linux.


userName - اسم المستخدم
string. مطلوب عند enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

اسم المستخدم لتشغيل خدمة العامل على الأجهزة الظاهرية.

بالنسبة لمستخدمي المجال، حدد القيم ك domain\username أو username@domain.com. بالنسبة للمستخدمين المحليين، حدد username.

من المفترض أن نفس مستخدم المجال أو مستخدم محلي بنفس الاسم، على التوالي، موجود على جميع الأجهزة الظاهرية في مجموعة الموارد.


password - كلمه المرور
string. ‏‏اختياري. استخدم عندما enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

كلمة المرور للمستخدم لتشغيل خدمة العامل على أجهزة Windows الظاهرية.

يفترض أن كلمة المرور هي نفسها للمستخدم المحدد على جميع الأجهزة الظاهرية.

يمكنه قبول المتغيرات المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء أو الإصدار على أنها $(passwordVariable). يمكنك وضع علامة على المتغير على أنه secret لتأمينه.

بالنسبة لأجهزة Linux الظاهرية، لا يلزم وجود كلمة مرور وسيتم تجاهلها.


outputVariable - تفاصيل الجهاز الظاهري ل WinRM
string. ‏‏اختياري. استخدم عندما enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

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

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


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

يحدد اسم توزيع مجموعة الموارد المراد إنشاؤه.


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

يوفر اسما لمتغير الإخراج، والذي يحتوي على قسم المخرجات لعنصر التوزيع الحالي بتنسيق السلسلة. ConvertFrom-Json استخدم PowerShell cmdlet لتحليل كائن JSON والوصول إلى قيم الإخراج الفردية.


addSpnToEnvironment - الوصول إلى تفاصيل كيان الخدمة في تجاوز المعلمات
boolean. ‏‏اختياري. استخدم عندما action = Create Or Update Resource Group. القيمة الافتراضية: false.

يضيف معرف كيان الخدمة ومفتاح نقطة نهاية Azure التي تم اختيارها لتكون بيئة تنفيذ البرنامج النصي. يمكن أن تكون المتغيرات $servicePrincipalId و $servicePrincipalKey في تجاوز المعلمات، مثل -key $servicePrincipalKey.


useWithoutJSON - استخدم قيم الإخراج الفردية دون JSON. تم تطبيق Stringify
boolean. ‏‏اختياري. استخدم عندما action = Create Or Update Resource Group. القيمة الافتراضية: false.

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


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

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

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

لا شيء

الملاحظات

يتوفر إصدار جديد من هذه المهمة في AzureResourceManagerTemplateDeployment@3 - مهمة توزيع قالب ARM v3.

الجديد في إصدار المهمة 2

  • يعمل مع وكلاء عبر الأنظمة الأساسية (Linux أو macOS أو Windows)
  • يدعم Template JSONs الموجودة في أي عناوين URL http/https يمكن الوصول إليها بشكل عام.
  • تجربة المستخدم المحسنة لتجاوز المعلمات التي يمكن الآن عرضها/تحريرها في شبكة.
  • تعيين قاعدة NAT للأجهزة الظاهرية التي يدعمها موازن التحميل.
  • تتم الآن إعادة تسمية حقل "مجموعة الموارد" ك "تفاصيل الجهاز الظاهري ل WinRM" ويتم تضمينه في قسم "خيارات النشر المتقدمة للأجهزة الظاهرية".
  • القيود:
    • لا يوجد دعم للاشتراكات الكلاسيكية. يتم دعم اشتراكات ARM فقط.
    • لا يوجد دعم لبناء جملة PowerShell لأن المهمة تستند الآن node.js. تأكد من تطابق حساسية حالة أسماء المعلمات، عند تجاوز معلمات القالب. قم أيضا بإزالة أوامر PowerShell cmdlets مثل "ConvertTo-SecureString" عند الترحيل من الإصدار 1.0 إلى الإصدار 2.0.

استكشاف الأخطاء وإصلاحها

خطأ: خطأ داخلي في الخادم

وغالبا ما تكون هذه القضايا عابرة في طبيعتها. هناك أسباب متعددة لماذا يمكن أن يحدث ذلك:

  • تخضع إحدى خدمات Azure التي تحاول توزيعها للصيانة في المنطقة التي تحاول التوزيع إليها. احرص على https://status.azure.com/ التحقق من أوقات تعطل Azure Services.
  • تمر خدمة Azure Pipelines نفسها بالصيانة. احرص على https://status.dev.azure.com/ متابعة أوقات التعطل.

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

خطأ: المهلة

قد تأتي مشكلات المهلة من مكانين:

  • عامل Azure Pipelines
  • نشر المدخل

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

خطأ: قواعد CORS التي سيتم تمكينها أثناء تجاوز المعلمات

إذا كان ملف القالب تتم الإشارة إليه من كائن ثنائي كبير الحجم، أثناء تجاوز المعلمات في البنية الأساسية لبرنامج ربط العمليات التجارية، فقد ترى رسالة التحذير التالية:

Warning: Failed to download the file from template path.

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

إلى جانب تمكين CORS، تأكد من أن رمز SAS المميز المحدد في ارتباط القالب هو "srt-sco". هذا الرمز المميز مطلوب لتنزيل الملف والمتابعة.

عامل Azure Pipelines

إذا كانت المشكلة واردة من عامل Azure Pipelines، يمكنك زيادة المهلة عن طريق تعيين timeoutInMinutes كمفتاح في YAML إلى 0. للحصول على مزيدٍ من المعلومات، اطّلع على تحديد الوظائف في المسار.

نشر المدخل

تحقق من هذا المستند حول كيفية تحديد ما إذا كان الخطأ قد جاء من مدخل Microsoft Azure: عرض محفوظات النشر باستخدام Azure Resource Manager.

في حالة نشر المدخل، حاول تعيين "timeoutInMinutes" في قالب ARM إلى "0". إذا لم يتم تحديدها، فإن القيمة المفترضة هي 60 دقيقة. 0 يتأكد من تشغيل التوزيع طالما أنه يمكن أن ينجح.

يمكن أن يحدث هذا أيضا بسبب مشكلات عابرة في النظام. راقب https://status.dev.azure.com/ ما إذا كان هناك وقت تعطل في خدمة Azure Pipelines.

خطأ: فشل التحقق من صحة قالب Azure Resource Manager (ARM)

تحدث هذه المشكلة في الغالب بسبب معلمة غير صالحة في قالب ARM، مثل SKU أو منطقة غير مدعومة. إذا فشل التحقق من الصحة، فتحقق من رسالة الخطأ. يجب أن يشير إلى المورد والمعلمة غير الصالحة.

قد تحدث هذه المشكلة أيضا بسبب سلاسل متعددة الأسطر. حاليا، لا تدعم مهمة توزيع مجموعة موارد Azure السلاسل متعددة الأسطر في قالب ARM أو ملف JSON للمعلمة.

بالإضافة إلى ذلك، راجع هذه المقالة فيما يتعلق ببنية وبناء جملة قوالب ARM: فهم بنية وبناء جملة قوالب ARM.

المتطلبات

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