AzureResourceGroupDeployment@2 – Tarefa de implementação v2 do grupo de recursos do Azure

  • Artigo

Implemente um modelo do Azure Resource Manager (ARM) num grupo de recursos e faça a gestão de máquinas virtuais.

Implementar um modelo do Azure Resource Manager (ARM) num grupo de recursos. Também pode iniciar, parar, eliminar e desalocar todos os Máquinas Virtuais (VM) num grupo de recursos.

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.

Entradas

azureSubscription - Subscrição do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatório.

Seleciona a ligação de serviço que contém uma Subscrição do Azure para a implementação.


action - Ação
string. Obrigatório. Valores permitidos: Create Or Update Resource Group, Select Resource Group (Configurar opções de implementação de máquinas virtuais), Start (Iniciar máquinas virtuais), Stop (Parar máquinas virtuais), StopWithDeallocate (Parar e desalocar máquinas virtuais), Restart (Reiniciar máquinas virtuais), Delete (Eliminar máquinas virtuais) DeleteRG (Eliminar grupo de recursos). Valor predefinido: Create Or Update Resource Group.

A ação a ser executada nos recursos ou no grupo de recursos do Azure.


resourceGroupName - Grupo de recursos
string. Obrigatório.

Fornece o nome do grupo de recursos.


location - Localização
string. Necessário quando action = Create Or Update Resource Group.

A localização para implementar o grupo de recursos. Se o grupo de recursos já existir na subscrição, este valor será ignorado.


templateLocation - Localização do modelo
string. Necessário quando action = Create Or Update Resource Group. Valores permitidos: Linked artifact, URL of the file. Valor predefinido: Linked artifact.

Selecione Artefacto ligado ou URL do ficheiro.


csmFileLink - Ligação do modelo
string. Necessário quando templateLocation = URL of the file && action = Create Or Update Resource Group.

Especifica o URL do ficheiro de modelo. Um URL de exemplo: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json

Para implementar um modelo armazenado numa conta de armazenamento privada, obtenha e inclua o token de assinatura de acesso partilhado (SAS) no URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken>

Para carregar um ficheiro de modelo (ou um modelo ligado) para uma conta de armazenamento e gerar um token de SAS, utilize a tarefa de cópia de ficheiros do Azure ou siga os passos com o PowerShell ou a CLI do Azure.

Para ver os parâmetros do modelo numa grelha, clique em ... junto à caixa de texto Substituir parâmetros de modelo. Esta funcionalidade requer que as regras CORS estejam ativadas na origem. Se os modelos estiverem num blob de armazenamento do Azure, veja Compreender os pedidos CORS para ativar o CORS.


csmParametersFileLink - Ligação de parâmetros de modelo
string. Opcional. Utilize quando templateLocation = URL of the file && action = Create Or Update Resource Group.

Especifica o URL do ficheiro de parâmetros. Exemplo: https://raw.githubusercontent.com/Azure/...

Para utilizar um ficheiro armazenado numa conta de armazenamento privada, obtenha e inclua o token de assinatura de acesso partilhado (SAS) no URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken> para carregar um ficheiro de parâmetros para uma conta de armazenamento e gerar um token de SAS, pode utilizar a tarefa de cópia de ficheiros do Azure ou seguir os passos com o PowerShell ou a CLI do Azure.

Para ver os parâmetros do modelo numa grelha, clique em ... junto à caixa de texto Substituir parâmetros de modelo. Esta funcionalidade requer que as regras CORS estejam ativadas na origem. Se os modelos estiverem num blob de armazenamento do Azure, veja Compreender os pedidos CORS para ativar o CORS.


csmFile - Modelo
string. Necessário quando templateLocation = Linked artifact && action = Create Or Update Resource Group.

Especifica o caminho ou um padrão que aponta para o modelo de Resource Manager do Azure. Saiba mais sobre os modelos do Azure Resource Manager. Para começar imediatamente, utilize este modelo de exemplo.


csmParametersFile - Parâmetros do modelo
string. Opcional. Utilize quando templateLocation = Linked artifact && action = Create Or Update Resource Group.

Especifica o URL do ficheiro de parâmetros. Um URL de exemplo: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Para utilizar um ficheiro armazenado numa conta de armazenamento privada, obtenha e inclua o token de assinatura de acesso partilhado (SAS) no URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken> para carregar um ficheiro de parâmetros para uma conta de armazenamento e gerar um token de SAS, utilize a tarefa de cópia de ficheiros do Azure ou siga os passos com o PowerShell ou a CLI do Azure.

Para ver os parâmetros do modelo numa grelha, clique em ... junto à caixa de texto Substituir parâmetros de modelo. Esta funcionalidade requer que as regras CORS estejam ativadas na origem. Se os modelos estiverem num blob de armazenamento do Azure, veja Compreender os pedidos CORS para ativar o CORS.


overrideParameters - Substituir parâmetros de modelo
string. Opcional. Utilize quando action = Create Or Update Resource Group.

Especifica os parâmetros do modelo a substituir.

Para ver os parâmetros do modelo numa grelha, clique em ... junto à caixa de texto Substituir parâmetros. Esta funcionalidade requer que as regras CORS estejam ativadas na origem. Se os modelos estiverem no blob de armazenamento do Azure, faça referência a esta cadeia para ativar o CORS ou escreva os parâmetros do modelo a substituir na caixa de texto.

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

Se o valor do parâmetro tiver múltiplas palavras, coloque as palavras entre aspas, mesmo que esteja a transmitir o valor através de variáveis. Por exemplo, -name "parameter value" -name2 "$(var)". Para substituir parâmetros de tipo de objeto, utilize objetos JSON com cadeias de carateres. Por exemplo, -options ["option1"] -map {"key1": "value1" }.


deploymentMode - Modo de implementação
string. Necessário quando action = Create Or Update Resource Group. Valores permitidos: Incremental, Complete, Validation (apenas validação). Valor predefinido: Incremental.

O Incremental modo processa as implementações como atualizações incrementais para o grupo de recursos. Deixa recursos inalterados que existem no grupo de recursos, mas não são especificados no modelo.

Complete o modo elimina os recursos que não estão no seu modelo. O modo completo demora relativamente mais tempo do que o modo incremental. Se a tarefa exceder o limite de tempo, considere aumentar o tempo limite ou mudar para o Incremental modo.

Aviso

O modo completo eliminará todos os recursos existentes no grupo de recursos que não estão especificados no modelo. Analise se o grupo de recursos no qual está a implementar não contém quaisquer recursos necessários que não estejam especificados no modelo.

Validate O modo permite-lhe encontrar problemas com o modelo antes de criar recursos reais.

Nota

O Validate modo cria sempre um grupo de recursos, mesmo que não sejam implementados recursos.

Saiba mais sobre os modos de implementação.


enableDeploymentPrerequisites - Ativar pré-requisitos
string. Opcional. Utilize quando action = Create Or Update Resource Group || action = Select Resource Group. Valores permitidos: None, ConfigureVMwithWinRM (Configurar com o agente WinRM) ConfigureVMWithDGAgent (Configurar com o agente do Grupo de Implementação). Valor predefinido: None.

Aplicável apenas quando o grupo de recursos contém máquinas virtuais.

Escolher a opção Grupo de Implementação configura o agente do Grupo de Implementação em cada uma das máquinas virtuais.

Selecionar a opção WinRM configura o serviço de escuta da Gestão Remota do Windows (WinRM) através do protocolo HTTPS na porta 5986 com um certificado autoassinado. Esta configuração é necessária para executar a operação de implementação em máquinas do Azure. Se as máquinas virtuais de destino forem suportadas por um balanceador de carga, certifique-se de que as regras NAT de entrada estão configuradas para a porta de destino (5986).


teamServicesConnection - Ligação do serviço Azure Pipelines
Alias de entrada: deploymentGroupEndpoint. string. Necessário quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Especifica a ligação de serviço para ligar a uma organização ou coleção do Azure DevOps para o registo de agentes.

Pode criar uma ligação de serviço com +New e, em seguida, selecionar Token-based authentication. Precisa de um token de acesso pessoal (PAT) para configurar uma ligação de serviço. Clique Manage para atualizar os detalhes da ligação do serviço.


teamServicesConnection - Ligação do serviço TFS/Pipelines do Azure
Alias de entrada: deploymentGroupEndpoint. string. Necessário quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Especifica a ligação de serviço para ligar a uma organização ou coleção do Azure DevOps para o registo de agentes.

Pode criar uma ligação de serviço com +New e, em seguida, selecionar Token-based authentication. Precisa de um token de acesso pessoal (PAT) para configurar uma ligação de serviço. Clique Manage para atualizar os detalhes da ligação do serviço.


teamProject - Projeto de equipa
Alias de entrada: project. string. Necessário quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Especifica o Projeto de Equipa que define o grupo de implementação.


deploymentGroupName - Grupo de Implementação
string. Necessário quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Especifica o grupo de implementação no qual os agentes serão registados. Saiba mais sobre os grupos de implementação.


copyAzureVMTags - Copiar etiquetas de VM do Azure para agentes
boolean. Opcional. Utilize quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Valor predefinido: true.

Escolhe se as etiquetas configuradas na VM do Azure têm de ser copiadas para o agente do grupo de implementação correspondente.

Por predefinição, todas as etiquetas do Azure são copiadas seguindo o formato: Key: Value. Exemplo: uma Role : Web etiqueta do Azure seria copiada tal como está para o computador do agente.

Saiba mais sobre como utilizar etiquetas para recursos do Azure.


runAgentServiceAsUser - Executar o serviço de agente como um utilizador
boolean. Opcional. Utilize quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Valor predefinido: false.

Executa o serviço de agente como um utilizador diferente do utilizador predefinido se o valor estiver definido como true.

O utilizador predefinido encontra-se NT AUTHORITY\\SYSTEM no Windows e root no Linux.


userName - Nome de utilizador
string. Necessário quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

O nome de utilizador para executar o serviço de agente nas máquinas virtuais.

Para utilizadores de domínio, especifique valores como domain\username ou username@domain.com. Para utilizadores locais, especifique username.

Presume-se que o mesmo utilizador de domínio ou um utilizador local com o mesmo nome, respetivamente, está presente em todas as máquinas virtuais no grupo de recursos.


password - Palavra-passe
string. Opcional. Utilize quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

A palavra-passe para o utilizador executar o serviço de agente nas VMs do Windows.

Presume-se que a palavra-passe é a mesma para o utilizador especificado em todas as VMs.

Pode aceitar variáveis definidas em pipelines de compilação ou versão como $(passwordVariable). Pode marcar a variável como secret para a proteger.

Para VMs do Linux, não é necessária uma palavra-passe e será ignorada.


outputVariable - Detalhes da VM para WinRM
string. Opcional. Utilize quando enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

Necessário quando um grupo de recursos existente é selecionado. Fornece um nome para a variável do grupo de recursos. A variável pode ser utilizada para $(variableName) se referir ao grupo de recursos em tarefas subsequentes, como na tarefa Do PowerShell em Máquinas de Destino para implementar aplicações.

Válido apenas quando a ação selecionada for Create, Updateou Select.


deploymentName - Nome da implementação
string. Opcional. Utilize quando action = Create Or Update Resource Group.

Especifica o nome da implementação do grupo de recursos a criar.


deploymentOutputs - Saídas de implementação
string. Opcional. Utilize quando action = Create Or Update Resource Group.

Fornece um nome para a variável de saída, que contém a secção de saídas do objeto de implementação atual no formato de cadeia. Utilize o cmdlet do ConvertFrom-Json PowerShell para analisar o objeto JSON e aceder aos valores de saída individuais.


addSpnToEnvironment - Detalhes do principal de serviço do Access nos parâmetros de substituição
boolean. Opcional. Utilize quando action = Create Or Update Resource Group. Valor predefinido: false.

Adiciona o ID do principal de serviço e a chave do ponto final do Azure escolhido para ser o ambiente de execução do script. As variáveis $servicePrincipalId e $servicePrincipalKey podem estar em parâmetros de substituição, como -key $servicePrincipalKey.


useWithoutJSON - Utilize valores de saída individuais sem JSON. Stringify aplicado
boolean. Opcional. Utilize quando action = Create Or Update Resource Group. Valor predefinido: false.

Os valores de saída individuais estão a ser convertidos através de JSON. Stringify por predefinição. Se quiser utilizar os valores de saída tal como estão sem os converter através de JSON. Stringify, ative esta opção. Para obter mais detalhes, veja isto.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Existe uma nova versão desta tarefa disponível na tarefa AzureResourceManagerTemplateDeployment@3 – implementação de modelos do ARM v3.

Novidades na versão 2 da tarefa

  • Funciona com agentes entre plataformas (Linux, macOS ou Windows)
  • Suporta JSONs de Modelo localizados em quaisquer URLs http/https acessíveis publicamente.
  • UX avançado para parâmetros de Substituição que agora podem ser visualizados/editados numa grelha.
  • Mapeamento de regras NAT para VMs que são apoiadas por um Balanceador de carga.
  • O campo "Grupo de recursos" foi agora mudado como "Detalhes da VM para WinRM" e está incluído na secção "Opções de implementação avançadas para máquinas virtuais".
  • Limitações:
    • Não existe suporte para subscrições clássicas. Apenas são suportadas subscrições arm.
    • Não existe suporte para a sintaxe do PowerShell, uma vez que a tarefa está agora node.js baseada. Certifique-se de que a sensibilidade a maiúsculas e minúsculas dos nomes dos parâmetros corresponde ao substituir os parâmetros do modelo. Além disso, remova os cmdlets do PowerShell como "ConvertTo-SecureString" quando migrar da versão 1.0 para a versão 2.0.

Resolução de problemas

Erro: Erro interno do Servidor

Estes problemas são, na sua maioria, de natureza transitória. Existem várias razões pelas quais podem estar a ocorrer:

  • Um dos serviços do Azure que está a tentar implementar está a ser submetido a uma manutenção na região na qual está a tentar implementar. https://status.azure.com/ Fique atento para verificar os tempos de inatividade dos Serviços do Azure.
  • O próprio serviço dos Pipelines do Azure está em manutenção. Fique atento https://status.dev.azure.com/ a tempos de inatividade.

No entanto, vimos algumas instâncias em que tal se deve a um erro no modelo do ARM, como o serviço do Azure que está a tentar implementar não suportar a região que escolheu para o recurso.

Erro: Tempo limite excedido

Os problemas de tempo limite podem ser provenientes de dois locais:

  • Agente dos Pipelines do Azure
  • Implementação do Portal

Pode identificar se o tempo limite é do portal ao verificar a ligação de implementação do portal que estará nos registos de tarefas. Se não existir nenhuma ligação, tal deve-se provavelmente ao agente dos Pipelines do Azure. Se existir uma ligação, siga-a para ver se ocorreu um tempo limite na implementação do portal.

Erro: regras CORS a ativar ao substituir parâmetros

Se o ficheiro de modelo estiver a ser referido a partir de um BLOB, ao substituir parâmetros no pipeline, poderá ver a seguinte mensagem de aviso:

Warning: Failed to download the file from template path.

Esta funcionalidade requer que as regras CORS estejam ativadas na origem. Se os modelos estiverem no blob de armazenamento do Azure, veja Suporte de partilha de recursos entre origens para ativar o CORS.

Além de ativar o CORS, certifique-se de que o token de SAS especificado na ligação do modelo é "srt-sco". Este token é necessário para transferir o ficheiro e continuar.

Agente dos Pipelines do Azure

Se o problema for proveniente do agente do Azure Pipelines, pode aumentar o tempo limite ao definir timeoutInMinutes como chave no YAML para 0. Para obter mais informações, veja Especificar trabalhos no pipeline.

Implementação do Portal

Veja este documento sobre como identificar se o erro veio do portal do Azure: Ver o histórico de implementações com o Azure Resource Manager.

No caso da implementação do portal, experimente definir "timeoutInMinutes" no modelo do ARM como "0". Se não for especificado, o valor assumido será de 60 minutos. 0 garante que a implementação será executada durante o tempo que for possível para ser bem-sucedida.

Isto também pode estar a acontecer devido a problemas transitórios no sistema. Fique atento https://status.dev.azure.com/ para verificar se existe algum tempo de inatividade no serviço Azure Pipelines.

Erro: Falha na validação do modelo do Azure Resource Manager (ARM)

Este problema ocorre principalmente devido a um parâmetro inválido no modelo do ARM, como um SKU ou região não suportados. Se a validação falhar, verifique a mensagem de erro. Deve apontar para o recurso e o parâmetro inválidos.

Este problema também pode ocorrer devido a cadeias com várias linhas. Atualmente, a tarefa de Implementação do Grupo de Recursos do Azure não suporta cadeias com várias linhas num modelo do ARM ou ficheiro JSON de parâmetros.

Além disso, veja este artigo sobre a estrutura e a sintaxe dos Modelos do ARM: Compreender a estrutura e a sintaxe dos modelos do ARM.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente 2.119.1 ou superior
Categoria da tarefa Implementação