Aracılığıyla paylaş

AzureResourceGroupDeployment@2 - Azure kaynak grubu dağıtımı v2 görevi

  • Makale

Azure Resource Manager (ARM) şablonunu bir kaynak grubuna dağıtın ve sanal makineleri yönetin.

Azure Resource Manager (ARM) şablonunu bir kaynak grubuna dağıtma. Ayrıca bir kaynak grubundaki tüm Sanal Makineler (VM) başlatabilir, durdurabilir, silebilir ve serbest bırakabilirsiniz.

Syntax

# 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.

Girişler

azureSubscription - Azure aboneliği
Giriş diğer adı: ConnectedServiceName. string. Gereklidir.

Dağıtım için bir Azure Aboneliği içeren hizmet bağlantısını seçer.


action - Eylem
string. Gereklidir. İzin verilen değerler: Create Or Update Resource Group, Select Resource Group (Sanal makine dağıtım seçeneklerini yapılandırma), Start (Sanal makineleri başlatma), Stop (Sanal makineleri durdurma ve serbest bırakma), StopWithDeallocate (Sanal makineleri yeniden başlatma), RestartDelete (Sanal makineleri silme) DeleteRG (Kaynak grubunu silme). Varsayılan değer: Create Or Update Resource Group.

Azure kaynaklarında veya kaynak grubunda gerçekleştirilecek eylem.


resourceGroupName - Kaynak grubu
string. Gereklidir.

Kaynak grubunun adını sağlar.


location - Konum
string. olduğunda action = Create Or Update Resource Groupgereklidir.

Kaynak grubunun dağıtılacağı konum. Kaynak grubu abonelikte zaten varsa, bu değer yoksayılır.


templateLocation - Şablon konumu
string. olduğunda action = Create Or Update Resource Groupgereklidir. İzin verilen değerler: Linked artifact, URL of the file. Varsayılan değer: Linked artifact.

Bağlı yapıt veya dosyanın URL'sini seçin.


csmFileLink - Şablon bağlantısı
string. olduğunda templateLocation = URL of the file && action = Create Or Update Resource Groupgereklidir.

Şablon dosyasının URL'sini belirtir. Örnek BIR URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json

Özel depolama hesabında depolanan bir şablonu dağıtmak için, şablonun URL'sine paylaşılan erişim imzası (SAS) belirtecini alın ve ekleyin. Örnek: <blob_storage_url>/template.json?<SAStoken>

Bir şablon dosyasını (veya bağlantılı şablonu) depolama hesabına yüklemek ve SAS belirteci oluşturmak için Azure dosya kopyalama görevini kullanın veya PowerShell veya Azure CLI kullanarak adımları izleyin.

Şablon parametrelerini kılavuzda görüntülemek için şablon parametrelerini geçersiz kıl metin kutusunun yanındaki öğesine tıklayın ... . Bu özellik, kaynakta CORS kurallarının etkinleştirilmesini gerektirir. Şablonlar bir Azure depolama blobundaysa bkz. CORS'yi etkinleştirmek için CORS isteklerini anlama .


csmParametersFileLink - Şablon parametreleri bağlantısı
string. İsteğe bağlı. when templateLocation = URL of the file && action = Create Or Update Resource Groupkullanın.

Parametre dosyasının URL'sini belirtir. Örnek: https://raw.githubusercontent.com/Azure/...

Özel depolama hesabında depolanan bir dosyayı kullanmak için, şablonun URL'sine paylaşılan erişim imzası (SAS) belirtecini alın ve ekleyin. Örnek: <blob_storage_url>/template.json?<SAStoken> Parametre dosyasını depolama hesabına yüklemek ve SAS belirteci oluşturmak için Azure dosya kopyalama görevini kullanabilir veya PowerShell veya Azure CLI kullanarak adımları izleyebilirsiniz.

Şablon parametrelerini kılavuzda görüntülemek için şablon parametrelerini geçersiz kıl metin kutusunun yanındaki öğesine tıklayın ... . Bu özellik, kaynakta CORS kurallarının etkinleştirilmesini gerektirir. Şablonlar bir Azure depolama blobundaysa bkz. CORS'yi etkinleştirmek için CORS isteklerini anlama .


csmFile - Şablon
string. olduğunda templateLocation = Linked artifact && action = Create Or Update Resource Groupgereklidir.

Azure Resource Manager şablonunu işaret eden yolu veya deseni belirtir. Azure Resource Manager şablonları hakkında daha fazla bilgi edinin. Hemen başlamak için bu örnek şablonu kullanın.


csmParametersFile - Şablon parametreleri
string. İsteğe bağlı. when templateLocation = Linked artifact && action = Create Or Update Resource Groupkullanın.

Parametre dosyasının URL'sini belirtir. Örnek BIR URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Özel depolama hesabında depolanan bir dosyayı kullanmak için, şablonun URL'sine paylaşılan erişim imzası (SAS) belirtecini alın ve ekleyin. Örnek: <blob_storage_url>/template.json?<SAStoken> Parametre dosyasını depolama hesabına yüklemek ve SAS belirteci oluşturmak için Azure dosya kopyalama görevini kullanın veya PowerShell veya Azure CLI kullanarak adımları izleyin.

Şablon parametrelerini kılavuzda görüntülemek için şablon parametrelerini geçersiz kıl metin kutusunun yanındaki öğesine tıklayın ... . Bu özellik, kaynakta CORS kurallarının etkinleştirilmesini gerektirir. Şablonlar bir Azure depolama blobundaysa bkz. CORS'yi etkinleştirmek için CORS isteklerini anlama .


overrideParameters - Şablon parametrelerini geçersiz kılma
string. İsteğe bağlı. when action = Create Or Update Resource Groupkullanın.

Geçersiz kılınacak şablon parametrelerini belirtir.

Şablon parametrelerini kılavuzda görüntülemek için geçersiz kılma parametreleri metin kutusunun yanındaki öğesine tıklayın ... . Bu özellik, kaynakta CORS kurallarının etkinleştirilmesini gerektirir. Şablonlar Azure depolama blobundaysa CORS'yi etkinleştirmek için bu dizeye başvurun veya metin kutusuna geçersiz kılınacak şablon parametrelerini yazın.

Örnek: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

Parametre değerinin birden çok sözcüğü varsa, değerleri değişkenleri kullanarak geçiriyor olsanız bile sözcükleri tırnak içine alın. Örneğin, -name "parameter value" -name2 "$(var)". Nesne türü parametrelerini geçersiz kılmak için dizeli JSON nesnelerini kullanın. Örneğin, -options ["option1"] -map {"key1": "value1" }.


deploymentMode - Dağıtım modu
string. olduğunda action = Create Or Update Resource Groupgereklidir. İzin verilen değerler: Incremental, Complete, Validation (Yalnızca doğrulama). Varsayılan değer: Incremental.

Mod, Incremental dağıtımları kaynak grubuna yönelik artımlı güncelleştirmeler olarak işler. Kaynak grubunda var olan ancak şablonda belirtilmeyen değişmemiş kaynakları bırakır.

Complete modu, şablonunuzda olmayan kaynakları siler. Tam mod, artımlı moddan nispeten daha uzun sürer. Görev zaman aşımına uysa zaman aşımını artırmayı veya moda geçmeyi Incremental göz önünde bulundurun.

Uyarı

Tamamlama modu, kaynak grubundaki şablonda belirtilmeyen tüm mevcut kaynakları siler. Dağıttığınız kaynak grubunun şablonda belirtilmeyen gerekli kaynakları içerip içermediğini gözden geçirin.

Validate modu, gerçek kaynakları oluşturmadan önce şablonla ilgili sorunları bulmanıza olanak tanır.

Not

Hiçbir Validate kaynak dağıtılmasa bile mod her zaman bir kaynak grubu oluşturur.

Dağıtım modları hakkında daha fazla bilgi edinin.


enableDeploymentPrerequisites - Önkoşulları etkinleştirme
string. İsteğe bağlı. when action = Create Or Update Resource Group || action = Select Resource Groupkullanın. İzin verilen değerler: None, ConfigureVMwithWinRM (WinRM aracısı ile yapılandırma), ConfigureVMWithDGAgent (Dağıtım Grubu aracısı ile yapılandırma). Varsayılan değer: None.

Yalnızca kaynak grubu sanal makineler içerdiğinde geçerlidir.

Dağıtım Grubu seçeneğinin belirterek, sanal makinelerin her birinde Dağıtım Grubu aracısını yapılandırabilirsiniz.

WinRM seçeneğinin belirtilmesi, otomatik olarak imzalanan bir sertifika kullanarak bağlantı noktası 5986'da HTTPS protokolü üzerinden Windows Uzaktan Yönetimi (WinRM) dinleyicisini yapılandırıyor. Bu yapılandırma, Azure makinelerinde dağıtım işlemi gerçekleştirmek için gereklidir. Hedef sanal makineler bir yük dengeleyici tarafından destekleniyorsa, Gelen NAT kurallarının hedef bağlantı noktası (5986) için yapılandırıldığından emin olun.


teamServicesConnection - Azure Pipelines hizmet bağlantısı
Giriş diğer adı: deploymentGroupEndpoint. string. olduğunda enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Groupgereklidir.

Aracı kaydı için bir Azure DevOps kuruluşuna veya koleksiyonuna bağlanacak hizmet bağlantısını belirtir.

kullanarak +New ve ardından öğesini seçerek Token-based authenticationbir hizmet bağlantısı oluşturabilirsiniz. Hizmet bağlantısı kurmak için kişisel erişim belirtecine (PAT) ihtiyacınız vardır. Hizmet bağlantısı ayrıntılarını güncelleştirmek için tıklayın Manage .


teamServicesConnection - Azure Pipelines/TFS hizmet bağlantısı
Giriş diğer adı: deploymentGroupEndpoint. string. olduğunda enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Groupgereklidir.

Aracı kaydı için bir Azure DevOps kuruluşuna veya koleksiyonuna bağlanacak hizmet bağlantısını belirtir.

kullanarak +New ve ardından öğesini seçerek Token-based authenticationbir hizmet bağlantısı oluşturabilirsiniz. Hizmet bağlantısı kurmak için kişisel erişim belirtecine (PAT) ihtiyacınız vardır. Hizmet bağlantısı ayrıntılarını güncelleştirmek için tıklayın Manage .


teamProject - Takım projesi
Giriş diğer adı: project. string. olduğunda enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Groupgereklidir.

Dağıtım grubunu tanımlayan Takım Projesini belirtir.


deploymentGroupName - Dağıtım Grubu
string. olduğunda enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Groupgereklidir.

Aracıların kaydedileceği dağıtım grubunu belirtir. Dağıtım grupları hakkında daha fazla bilgi edinin.


copyAzureVMTags - Azure VM etiketlerini aracılara kopyalama
boolean. İsteğe bağlı. when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Groupkullanın. Varsayılan değer: true.

Azure VM'de yapılandırılan etiketlerin ilgili dağıtım grubu aracısına kopyalanması gerekip gerekmediğini seçer.

Varsayılan olarak, tüm Azure etiketleri şu biçimde kopyalanır: Key: Value. Örnek: Azure Role : Web etiketi aracı makinesine olduğu gibi kopyalanır.

Azure kaynakları için etiketleri kullanma hakkında daha fazla bilgi edinin.


runAgentServiceAsUser - Aracı hizmetini kullanıcı olarak çalıştırma
boolean. İsteğe bağlı. when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Groupkullanın. Varsayılan değer: false.

Değer olarak ayarlanırsa truearacı hizmetini varsayılan kullanıcı dışında bir kullanıcı olarak çalıştırır.

Varsayılan kullanıcı Windows ve root Linux'tadırNT AUTHORITY\\SYSTEM.


userName - Kullanıcı adı
string. olduğunda enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Groupgereklidir.

Aracı hizmetini sanal makinelerde çalıştırmak için kullanılan kullanıcı adı.

Etki alanı kullanıcıları için değerleri veya username@domain.comolarak domain\username belirtin. Yerel kullanıcılar için belirtin username.

Kaynak grubundaki tüm sanal makinelerde sırasıyla aynı etki alanı kullanıcısının veya aynı ada sahip bir yerel kullanıcının mevcut olduğu varsayılır.


password - Parola
string. İsteğe bağlı. when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Groupkullanın.

Kullanıcının Windows VM'lerinde aracı hizmetini çalıştırması için parola.

Parolanın tüm VM'lerde belirtilen kullanıcı için aynı olduğu varsayılır.

Derleme veya yayın işlem hatlarında tanımlanan değişkenleri olarak $(passwordVariable)kabul edebilir. Değişkeni güvenli olmasını sağlamak için olarak secret işaretleyebilirsiniz.

Linux VM'leri için parola gerekli değildir ve yoksayılır.


outputVariable - WinRM için VM ayrıntıları
string. İsteğe bağlı. when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Groupkullanın.

Mevcut bir kaynak grubu seçildiğinde gereklidir. Kaynak grubu değişkeni için bir ad sağlar. değişkeni, uygulamaları dağıtmak için Hedef Makinelerde PowerShell görevi gibi sonraki görevlerde kaynak grubuna başvurmak için olarak kullanılabilir $(variableName) .

Yalnızca seçili eylem , Updateveya Selectolduğunda Creategeçerlidir.


deploymentName - Dağıtım adı
string. İsteğe bağlı. when action = Create Or Update Resource Groupkullanın.

Oluşturulacak kaynak grubu dağıtımının adını belirtir.


deploymentOutputs - Dağıtım çıkışları
string. İsteğe bağlı. when action = Create Or Update Resource Groupkullanın.

Geçerli dağıtım nesnesinin çıkışlar bölümünü dize biçiminde içeren çıkış değişkeni için bir ad sağlar. ConvertFrom-Json JSON nesnesini ayrıştırmak ve tek tek çıkış değerlerine erişmek için PowerShell cmdlet'ini kullanın.


addSpnToEnvironment - Geçersiz kılma parametrelerindeki hizmet sorumlusu ayrıntılarına erişme
boolean. İsteğe bağlı. when action = Create Or Update Resource Groupkullanın. Varsayılan değer: false.

Betiğin yürütme ortamı olarak seçilen Azure uç noktasının hizmet sorumlusu kimliğini ve anahtarını ekler. ve $servicePrincipalKey değişkenleri $servicePrincipalId gibi -key $servicePrincipalKeygeçersiz kılma parametrelerinde olabilir.


useWithoutJSON - JSON olmadan tek tek çıkış değerleri kullanın. Stringify uygulandı
boolean. İsteğe bağlı. when action = Create Or Update Resource Groupkullanın. Varsayılan değer: false.

Tek tek çıkış değerleri JSON aracılığıyla dönüştürülüyor. Varsayılan olarak stringify. Çıkış değerlerini JSON aracılığıyla dönüştürmeden olduğu gibi kullanmak istiyorsanız. Stringify, bu seçeneği etkinleştirin. Daha fazla ayrıntı için buna bakın.


Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Bu görevin yeni bir sürümü AzureResourceManagerTemplateDeployment@3 - ARM şablonu dağıtımı v3 görevinde kullanılabilir.

Görev sürüm 2'deki yenilikler

  • Platformlar arası aracılarla (Linux, macOS veya Windows) çalışır
  • Genel olarak erişilebilen herhangi bir http/https URL'sinde bulunan Şablon JSON'larını destekler.
  • Artık kılavuzda görüntülenebilen/düzenlenebilen Geçersiz Kılma parametreleri için gelişmiş UX.
  • Yük dengeleyici tarafından yedeklenen VM'ler için NAT kuralı eşlemesi.
  • "Kaynak grubu" alanı artık "WinRM için VM ayrıntıları" olarak yeniden adlandırıldı ve "Sanal makineler için gelişmiş dağıtım seçenekleri" bölümüne eklenmiştir.
  • Sınırlamalar:
    • Klasik abonelikler için destek yoktur. Yalnızca ARM abonelikleri desteklenir.
    • Görev artık node.js tabanlı olduğundan PowerShell söz dizimi desteği yoktur. Şablon parametrelerini geçersiz kıldığınızda parametre adlarının büyük/küçük harf duyarlılığının eşleştiğinden emin olun. Ayrıca, sürüm 1.0'dan sürüm 2.0'a geçiş yaparken "ConvertTo-SecureString" gibi PowerShell cmdlet'lerini kaldırın.

Sorun giderme

Hata: İç Sunucu Hatası

Bu sorunlar, doğası gereği, çoğunlukla geçicidir. Bunun olmasının birden çok nedeni vardır:

  • Dağıtmaya çalıştığınız Azure hizmetlerinden biri, dağıtmaya çalıştığınız bölgede bakımdan geçiyor. Azure Hizmetleri'nin https://status.azure.com/ kapalı kalma sürelerini kontrol etmek için gözünüz açık olsun.
  • Azure Pipelines hizmetinin kendisi bakımdan geçiyordur. Kapalı kalma süreleri için gözünüz açık https://status.dev.azure.com/ olsun.

Ancak, bunun ARM şablonundaki bir hatadan kaynaklandığı bazı örnekler gördük. Örneğin, dağıtmaya çalıştığınız Azure hizmeti kaynak için seçtiğiniz bölgeyi desteklemiyor.

Hata: Zaman Aşımı

Zaman aşımı sorunları iki yerden geliyor olabilir:

  • Azure Pipelines Aracısı
  • Portal Dağıtımı

Görev günlüklerinde yer alan portal dağıtım bağlantısını denetleyerek zaman aşımının portaldan olup olmadığını belirleyebilirsiniz. Bağlantı yoksa, bunun nedeni büyük olasılıkla Azure Pipelines aracısıdır. Bağlantı varsa, portal dağıtımında gerçekleşen bir zaman aşımı olup olmadığını görmek için bağlantıyı izleyin.

Hata: Parametreleri geçersiz kılarken etkinleştirilecek CORS kuralları

Şablon dosyasına bir BLOB'dan başvurulurken işlem hattındaki parametreler geçersiz kılınıyorsa aşağıdaki uyarı iletisini görebilirsiniz:

Warning: Failed to download the file from template path.

Bu özellik, kaynakta CORS kurallarının etkinleştirilmesini gerektirir. Şablonlar Azure depolama blobundaysa, CORS'yi etkinleştirmek için, bkz. Çıkış noktaları arası kaynak paylaşımı desteği.

CORS'yi etkinleştirmenin yanı sıra, şablonun bağlantısında belirtilen SAS belirtecinin "srt-sco" olduğundan emin olun. Bu belirteç, dosyayı indirip devam etmeniz için gereklidir.

Azure Pipelines Aracısı

Sorun Azure Pipelines aracısından geliyorsa YAML'de anahtar olarak timeoutInMinutes değerini 0 olarak ayarlayarak zaman aşımını artırabilirsiniz. Daha fazla bilgi için, bkz. İşlem hattınızda işleri belirtme.

Portal Dağıtımı

Hatanın Azure portal: Azure Resource Manager ile dağıtım geçmişini görüntüleme sayfasından gelip gelmediğini belirlemeye yönelik bu belgeyi gözden geçirin.

Portal dağıtımı durumunda ARM şablonundaki "timeoutInMinutes" ayarını "0" olarak ayarlamayı deneyin. Belirtilmezse, 60 dakika olduğu varsayılır. 0, dağıtımın başarılı olduğu sürece çalışmasını sağlar.

Bu durum sistemdeki geçici sorunlar nedeniyle de gerçekleşebilir. Azure Pipelines hizmetinde kapalı kalma süresi olup olmadığını kontrol etmek için bir göz https://status.dev.azure.com/ atın.

Hata: Azure Resource Manager (ARM) şablonu doğrulanamadı

Bu sorun, çoğunlukla ARM şablonunda desteklenmeyen bir SKU veya bölge gibi geçersiz bir parametreden kaynaklanır. Doğrulama başarısız olursa, hata iletisini denetleyin. Geçersiz olan kaynak ve parametreye işaret etmelidir.

Bu sorun, çok satırlı dizeler nedeniyle de oluşabilir. Şu anda, Azure Kaynak Grubu Dağıtımı görevi ARM şablonunda veya parametre JSON dosyasındaki çok satırlı dizeleri desteklememektedir.

Buna ek olarak, ARM Şablonlarının yapısı ve söz dizimi ile ilgili bu makaleye bakın: ARM şablonlarının yapısını ve söz dizimini anlama.

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır Agent, DeploymentGroup
Talep Hiçbiri
Özellikler Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.119.1 veya üzeri
Görev kategorisi Dağıtma