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

  • Artigo

Implante um modelo do ARM (Azure Resource Manager) em um grupo de recursos e gerencie máquinas virtuais.

Implante um modelo do ARM (Azure Resource Manager) em um grupo de recursos. Você também pode iniciar, parar, excluir e desalocar todas as Máquinas Virtuais (VM) em um 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 - Assinatura do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatórios.

Seleciona a conexão de serviço que contém uma Assinatura do Azure para a implantação.


action - Ação
string. Obrigatórios. Valores permitidos: Create Or Update Resource Group, Select Resource Group (Configurar opções de implantação de máquina virtual), Start (Iniciar máquinas virtuais), Stop (Parar máquinas virtuais), StopWithDeallocate (Parar e desalocar máquinas virtuais), Restart (Reiniciar máquinas virtuais) Delete (Excluir máquinas virtuais) DeleteRG (Excluir grupo de recursos). Valor padrão: 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órios.

Fornece o nome do grupo de recursos.


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

O local para implantar o grupo de recursos. Se o grupo de recursos já existir na assinatura, esse valor será ignorado.


templateLocation - Local do modelo
string. Obrigatório quando action = Create Or Update Resource Group. Valores Permitidos: Linked artifact e URL of the file. Valor padrão: Linked artifact.

Selecione Artefato vinculado ou URL do arquivo.


csmFileLink - Link do modelo
string. Obrigatório quando templateLocation = URL of the file && action = Create Or Update Resource Group.

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

Para implantar um modelo armazenado em uma conta de armazenamento privada, recupere e inclua o token SAS (assinatura de acesso compartilhado) na URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken>

Para carregar um arquivo de modelo (ou um modelo vinculado) em uma conta de armazenamento e gerar um token SAS, use a tarefa de cópia de arquivo do Azure ou siga as etapas usando o PowerShell ou a CLI do Azure.

Para exibir os parâmetros de modelo em uma grade, clique em ... ao lado da caixa de texto Substituir parâmetros de modelo. Esse recurso exige que as regras do CORS sejam habilitadas na fonte. Se os modelos estiverem em um blob de armazenamento do Azure, consulte Noções básicas sobre solicitações CORS para habilitar o CORS.


csmParametersFileLink - Link de parâmetros de modelo
string. Opcional. Use quando templateLocation = URL of the file && action = Create Or Update Resource Group.

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

Para usar um arquivo armazenado em uma conta de armazenamento privada, recupere e inclua o token SAS (assinatura de acesso compartilhado) na URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken> para carregar um arquivo de parâmetros em uma conta de armazenamento e gerar um token SAS, você pode usar a tarefa de cópia de arquivo do Azure ou seguir as etapas usando o PowerShell ou a CLI do Azure.

Para exibir os parâmetros de modelo em uma grade, clique em ... ao lado da caixa de texto Substituir parâmetros de modelo. Esse recurso exige que as regras do CORS sejam habilitadas na fonte. Se os modelos estiverem em um blob de armazenamento do Azure, consulte Noções básicas sobre solicitações CORS para habilitar o CORS.


csmFile - Modelo
string. Obrigató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 modelos de Resource Manager do Azure. Para começar imediatamente, use este modelo de exemplo.


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

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

Para usar um arquivo armazenado em uma conta de armazenamento privada, recupere e inclua o token SAS (assinatura de acesso compartilhado) na URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken> para carregar um arquivo de parâmetros em uma conta de armazenamento e gerar um token SAS, use a tarefa de cópia de arquivo do Azure ou siga as etapas usando o PowerShell ou a CLI do Azure.

Para exibir os parâmetros de modelo em uma grade, clique em ... ao lado da caixa de texto Substituir parâmetros de modelo. Esse recurso exige que as regras do CORS sejam habilitadas na fonte. Se os modelos estiverem em um blob de armazenamento do Azure, consulte Noções básicas sobre solicitações CORS para habilitar o CORS.


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

Especifica os parâmetros de modelo a serem substituídos.

Para exibir os parâmetros de modelo em uma grade, clique em ... ao lado da caixa de texto parâmetros de substituição. Esse recurso exige que as regras do CORS sejam habilitadas na fonte. Se os modelos estiverem no blob de armazenamento do Azure, faça referência a essa cadeia de caracteres para habilitar o CORS ou digite os parâmetros de modelo a serem substituídos 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 várias palavras, coloque as palavras entre aspas, mesmo que você esteja passando o valor usando variáveis. Por exemplo, -name "parameter value" -name2 "$(var)". Para substituir parâmetros de tipo de objeto, use objetos JSON com cadeia de caracteres. Por exemplo, -options ["option1"] -map {"key1": "value1" }.


deploymentMode - Modo de implantação
string. Obrigatório quando action = Create Or Update Resource Group. Valores permitidos: Incremental, Complete, Validation (somente validação). Valor padrão: Incremental.

O Incremental modo lida com implantações como atualizações incrementais para o grupo de recursos. Ele deixa inalterados os recursos existentes no grupo de recursos, mas que não foram especificados no modelo.

O modo Complete exclui os recursos que não estão no modelo. O modo completo leva relativamente mais tempo do que o modo incremental. Se a tarefa atingir o tempo limite, considere aumentar o tempo limite ou alterar para o Incremental modo .

Aviso

O modo completo excluirá todos os recursos existentes no grupo de recursos que não são especificados no modelo. Examine se o grupo de recursos no qual você está implantando não contém os recursos necessários que não são especificados no modelo.

O modo Validate permite que você encontre problemas com o modelo antes de criar recursos reais.

Observação

O Validate modo sempre cria um grupo de recursos, mesmo que nenhum recurso seja implantado.

Saiba mais sobre os modos de implantação.


enableDeploymentPrerequisites - Habilitar pré-requisitos
string. Opcional. Use 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 Implantação). Valor padrão: None.

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

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

Selecionar a opção WinRM configura o ouvinte do WinRM (Gerenciamento Remoto do Windows) pelo protocolo HTTPS na porta 5986 usando um certificado autoassinado. Essa configuração é obrigatória para executar a operação de implantação em computadores do Azure. Se as máquinas virtuais de destino forem apoiadas por um balanceador de carga, verifique se as regras NAT de entrada estão configuradas para a porta de destino (5986).


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

Especifica a conexão de serviço para se conectar a uma organização ou coleção do Azure DevOps para registro de agente.

Você pode criar uma conexão de serviço usando +New e, em seguida, selecionar Token-based authentication. Você precisa de um PAT (token de acesso pessoal) para configurar uma conexão de serviço. Clique Manage para atualizar os detalhes da conexão de serviço.


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

Especifica a conexão de serviço para se conectar a uma organização ou coleção do Azure DevOps para registro de agente.

Você pode criar uma conexão de serviço usando +New e, em seguida, selecionar Token-based authentication. Você precisa de um PAT (token de acesso pessoal) para configurar uma conexão de serviço. Clique Manage para atualizar os detalhes da conexão de serviço.


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

Especifica o Projeto de Equipe que define o grupo de implantação.


deploymentGroupName - Grupo de Implantação
string. Obrigatório quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

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


copyAzureVMTags - Copiar marcas de VM do Azure para agentes
boolean. Opcional. Use quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Valor padrão: true.

Escolhe se as marcas configuradas na VM do Azure precisam ser copiadas para o agente do grupo de implantação correspondente.

Por padrão, todas as marcas do Azure são copiadas seguindo o formato: Key: Value. Exemplo: uma Role : Web marca do Azure seria copiada no estado em que se encontra no computador do agente.

Saiba mais sobre como usar marcas para recursos do Azure.


runAgentServiceAsUser - Executar o serviço de agente como um usuário
boolean. Opcional. Use quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Valor padrão: false.

Executa o serviço de agente como um usuário diferente do usuário padrão se o valor for definido truecomo .

O usuário padrão está NT AUTHORITY\\SYSTEM no Windows e root no Linux.


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

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

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

Supõe-se que o mesmo usuário de domínio ou um usuário local com o mesmo nome, respectivamente, esteja presente em todas as máquinas virtuais no grupo de recursos.


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

A senha para o usuário executar o serviço de agente nas VMs do Windows.

Supõe-se que a senha seja a mesma para o usuário especificado em todas as VMs.

Ele pode aceitar variáveis definidas em pipelines de build ou lançamento como $(passwordVariable). Você pode marcar a variável como secret para protegê-la.

Para VMs linux, uma senha não é necessária e será ignorada.


outputVariable - Detalhes da VM para WinRM
string. Opcional. Use 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 usada como $(variableName) para se referir ao grupo de recursos em tarefas subsequentes, como na tarefa PowerShell on Target Machines para implantar aplicativos.

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


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

Especifica o nome da implantação do grupo de recursos a ser criada.


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

Fornece um nome para a variável de saída, que contém a seção de saídas do objeto de implantação atual no formato de cadeia de caracteres. Use o cmdlet do ConvertFrom-Json PowerShell para analisar o objeto JSON e acessar os valores de saída individuais.


addSpnToEnvironment - Acessar detalhes da entidade de serviço em parâmetros de substituição
boolean. Opcional. Use quando action = Create Or Update Resource Group. Valor padrão: false.

Adiciona a ID da entidade de serviço e a chave do ponto de extremidade 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 - Use valores de saída individuais sem JSON. Stringify aplicado
boolean. Opcional. Use quando action = Create Or Update Resource Group. Valor padrão: false.

Valores de saída individuais estão sendo convertidos por meio de JSON. Stringify por padrão. Se você quiser usar os valores de saída como estão sem convertê-los por meio de JSON. Stringify, habilite essa opção. Para obter mais detalhes, consulte isso.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Há uma nova versão dessa tarefa disponível em AzureResourceManagerTemplateDeployment@3 – tarefa de implantação de modelo do ARM v3.

Novidades na versão 2 da tarefa

  • Funciona com agentes multiplataforma (Linux, macOS ou Windows)
  • Dá suporte a JSONs de modelo localizados em qualquer URL http/https publicamente acessível.
  • UX avançado para parâmetros de substituição que agora podem ser exibidos/editados em uma grade.
  • Mapeamento de regras nat para VMs que são apoiadas por um balanceador de carga.
  • O campo "Grupo de recursos" agora é renomeado como "Detalhes da VM para WinRM" e está incluído na seção "Opções avançadas de implantação para máquinas virtuais".
  • Limitações:
    • Não há suporte para assinaturas clássicas. Há suporte apenas para assinaturas do ARM.
    • Não há suporte para sintaxe do PowerShell, pois a tarefa agora é baseada em node.js. Verifique se a confidencialidade de maiúsculas e minúsculas dos nomes dos parâmetros corresponde, quando você substitui os parâmetros de modelo. Além disso, remova os cmdlets do PowerShell como "ConvertTo-SecureString" ao migrar da versão 1.0 para a versão 2.0.

Solução de problemas

Erro: erro no servidor interno

Esses problemas são, em sua maioria, transitórios por natureza. Há várias razões pelas quais isso pode estar acontecendo:

  • Um dos serviços do Azure que você está tentando implantar está passando por manutenção na região em que está tentando implantar. Fique atento a https://status.azure.com/ para verificar os tempos de inatividade dos Serviços do Azure.
  • O próprio serviço do Azure Pipelines está passando por manutenção. Fique de olho em https://status.dev.azure.com/ para ver os tempos de inatividade.

No entanto, vimos algumas instâncias em que isso ocorre devido a um erro no modelo do ARM, por exemplo, o serviço do Azure que você está tentando implantar não dá suporte à região escolhida para o recurso.

Erro: tempo limite

Problemas de tempo limite podem ocorrer por dois motivos:

  • Agente do Azure Pipelines
  • Implantação do portal

Você pode identificar se o tempo limite é do portal verificando o link de implantação do portal que fica nos logs de tarefas. Se não houver nenhum link, isso provavelmente ocorrerá devido ao agente do Azure Pipelines. Se houver um link, siga o link para ver se houve tempo limite na implantação do portal.

Erro: regras CORS a serem habilitadas durante a substituição de parâmetros

Se o arquivo de modelo estiver sendo referenciado de um BLOB, enquanto substitui parâmetros no pipeline, você poderá ver a seguinte mensagem de aviso:

Warning: Failed to download the file from template path.

Esse recurso exige que as regras do CORS sejam habilitadas na fonte. Se os modelos estiverem no blob de Armazenamento do Azure, confira Suporte ao compartilhamento de recursos entre origens para habilitar o CORS.

Além de habilitar o CORS, verifique se o token SAS especificado no link do modelo é "srt-sco". Esse token é necessário para que você baixe o arquivo e prossiga.

Agente do Azure Pipelines

Se o problema for proveniente do agente do Azure Pipelines, você poderá aumentar o tempo limite definindo timeoutInMinutes como chave no YAML com valor 0. Para obter mais informações, confira Especificar trabalhos em seu pipeline.

Implantação do portal

Confira este documento sobre como identificar se o erro veio do portal do Azure: Exibir o histórico de implantação com o Azure Resource Manager.

No caso da implantação do portal, tente definir "timeoutInMinutes" no modelo do ARM como "0". Se não for especificado, o valor assumido será de 60 minutos. 0 garante que a implantação será executada pelo máximo que puder para ter êxito.

Isso também pode estar acontecendo devido a problemas transitórios no sistema. Fique atento a https://status.dev.azure.com/ para verificar se há um tempo de inatividade no serviço do Azure Pipelines.

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

Esse problema ocorre principalmente devido a um parâmetro inválido no modelo do ARM, como uma SKU ou região sem suporte. Se a validação falhar, verifique a mensagem de erro. Ele deve apontar para o recurso e o parâmetro inválidos.

Esse problema também pode ocorrer devido a cadeias de caracteres com várias linhas. Atualmente, a tarefa Implantação do Grupo de Recursos do Azure não dá suporte a cadeias de caracteres com várias linhas em um modelo do ARM ou arquivo JSON de parâmetro.

Além disso, confira este artigo sobre a estrutura e a sintaxe dos modelos do ARM: Entenda a estrutura e a sintaxe dos modelos do ARM.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.119.1 ou superior
Categoria da tarefa Implantar