Compartilhar via

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.

Implantar um modelo do ARM (Azure Resource Manager) em um grupo de recursos. Você também pode iniciar, parar, excluir e desalocar todas as VMs (Máquinas Virtuais) em um grupo de recursos.

Sintaxe

# 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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. Necessário.

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


de Ação action -
string. Necessário. 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. Necessário.

Fornece o nome do grupo de recursos.


de Localização location -
string. Necessá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. Necessário quando action = Create Or Update Resource Group. Valores permitidos: Linked artifact, URL of the file. Valor padrão: Linked artifact.

Selecione de artefato vinculado ou URL dode arquivo.


de link do modelo de csmFileLink -
string. Necessá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 do PowerShell ou CLI do Azure.

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


link de parâmetros do modelo de csmParametersFileLink -
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 tarefa cópia de arquivo do Azure ou seguir as etapas usando do PowerShell ou CLI do Azure.

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


de modelo de csmFile -
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 do Azure Resource Manager. Saiba mais sobre modelos do Azure Resource Manager. Para começar imediatamente, use este modelo de exemplo.


parâmetros de modelo de csmParametersFile -
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 do PowerShell ou CLI do Azure.

Para exibir os parâmetros de modelo em uma grade, clique em ... ao lado da caixa de texto de parâmetros de modelo de substituição. Esse recurso requer que as regras cors estejam habilitadas na origem. 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 de parâmetros de substituição. Esse recurso requer que as regras cors estejam habilitadas na origem. 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 se você estiver 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. Necessário quando action = Create Or Update Resource Group. Valores permitidos: Incremental, Complete, Validation (somente validação). Valor padrão: Incremental.

O modo Incremental manipula implantações como atualizações incrementais para o grupo de recursos. Ele deixa recursos inalterados que existem no grupo de recursos, mas não são especificados no modelo.

Complete modo exclui recursos que não estão em seu 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 mudar para o modo de Incremental.

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.

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

Nota

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

Saiba mais sobre 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 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) por meio do protocolo HTTPS na porta 5986 usando um certificado autoassinado. Essa configuração é necessá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 - de conexão de serviço do Azure Pipelines
Alias de entrada: deploymentGroupEndpoint. string. Necessário quando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

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 selecionando Token-based authentication. Você precisa de um de token de acesso pessoal (PAT) para configurar uma conexão de serviço. Clique em Manage para atualizar os detalhes da conexão de serviço.


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

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 selecionando Token-based authentication. Você precisa de um de token de acesso pessoal (PAT) para configurar uma conexão de serviço. Clique em Manage para atualizar os detalhes da conexão de serviço.


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

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


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

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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Valor padrão: true.

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

Por padrão, todas as marcas do Azure são copiadas seguindo o formato: Key: Value. Exemplo: uma marca Role : Web do Azure seria copiada as-is para o computador do agente.

Saiba mais sobre usando marcas para recursos do Azure.


runAgentServiceAsUser - executar o serviço de agente como um usuário
boolean. Opcional. Use quando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. 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 como true.

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


userName - nome de usuário
string. Necessário quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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 - de senha
string. Opcional. Use quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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 (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None).

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


saídas de implantação deploymentOutputs -
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 ConvertFrom-Json PowerShell para analisar o objeto JSON e acessar os valores de saída individuais.


detalhes da entidade de serviço do addSpnToEnvironment - Access 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 - Usar 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 via JSON. Stringify por padrão. Se você quiser usar os valores de saída como estão sem convertê-los via JSON. Stringify, habilite essa opção. Para obter mais detalhes, consulte este.


Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

Há uma nova versão dessa tarefa disponível em AzureResourceManagerTemplateDeployment@3 –de 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 acessível publicamente.
  • UX aprimorado para parâmetros de substituição que agora podem ser exibidos/editados em uma grade.
  • Mapeamento de regra 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 a sintaxe do PowerShell, pois a tarefa agora é baseada em node.js. Verifique se a confidencialidade de maiúsculas e minúsculas dos nomes de parâmetro 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.

Solucionando problemas

Erro: Erro interno do servidor

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 você está tentando implantar. Fique atento ao 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 tempos de inatividade.

No entanto, vimos algumas instâncias em que isso ocorre devido a um erro no modelo do ARM, como 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 vir de dois lugares:

  • 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 estará 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 há um tempo limite que aconteceu 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, ao substituir parâmetros no pipeline, você poderá ver a seguinte mensagem de aviso:

Warning: Failed to download the file from template path.

Esse recurso requer que as regras cors sejam habilitadas na origem. Se os modelos estiverem no blob de armazenamento do Azure, consulte 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 como 0. Para obter mais informações, consulte 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 de olho em 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 de várias linhas. Atualmente, a tarefa Implantação do Grupo de Recursos do Azure não dá suporte a cadeias de caracteres de várias linhas em um modelo do ARM ou arquivo JSON de parâmetro.

Além disso, consulte 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
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.119.1 ou superior
Categoria de tarefa Implantar