Partilhar via

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

  • Artigo

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

Implante um modelo do Gerenciador de Recursos do Azure (ARM) 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.

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.

Insumos

azureSubscription - de 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.


action - Ação
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 grupo de recursos do Azure.


resourceGroupName - Grupo de recursos
string. Necessário.

Fornece o nome do grupo de recursos.


location - Localização
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 - Localização 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 do arquivo.


csmFileLink - Link do modelo
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 privado, recupere e inclua o token de assinatura de acesso compartilhado (SAS) na URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken>

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

Para exibir os parâmetros do modelo em uma grade, clique em ... ao lado da caixa de texto Substituir parâmetros do modelo. 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.


csmParametersFileLink - Parâmetros do modelo de link
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 privado, recupere e inclua o token de assinatura de acesso compartilhado (SAS) 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 de cópia de arquivo do Azure ou seguir as etapas usando PowerShell ou da CLI do Azure.

Para exibir os parâmetros do modelo em uma grade, clique em ... ao lado da caixa de texto Substituir parâmetros do modelo. 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.


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


csmParametersFile - Parâmetros do 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 privado, recupere e inclua o token de assinatura de acesso compartilhado (SAS) 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 cópia de arquivo do Azure ou siga as etapas usando PowerShell ou da CLI do Azure.

Para exibir os parâmetros do modelo em uma grade, clique em ... ao lado da caixa de texto Substituir parâmetros do modelo. 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 do modelo a serem substituídos.

Para exibir os parâmetros do modelo em uma grade, clique em ... ao lado da caixa de texto Substituir parâmetros. 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 do 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 stringificados. 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 lida com implantações como atualizações incrementais para o grupo de recursos. Ele deixa inalterados os recursos que existem no grupo de recursos, mas não são especificados no modelo.

Complete modo exclui recursos que não estão no seu modelo. O modo completo leva relativamente mais tempo do que o modo incremental. Se o tempo limite da tarefa expirar, considere aumentar o tempo limite ou mudar para o modo Incremental.

Advertência

O modo Concluído excluirá todos os recursos existentes no grupo de recursos que não estão especificados no modelo. Analise se o grupo de recursos no qual você está implantando não contém recursos necessários que não estejam especificados no modelo.

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

Observação

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

Saiba mais sobre modos de implantação.


enableDeploymentPrerequisites - Ativar 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 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 Gerenciamento Remoto do Windows (WinRM) sobre o protocolo HTTPS na porta 5986 usando um certificado autoassinado. Essa configuração é necessária para executar a operação de implantação em máquinas 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 a ser conectada 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, selecionando Token-based authentication. Você precisa de um 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 a ser conectada 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, selecionando Token-based authentication. Você precisa de um 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.


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

Especifica o grupo de implantação no qual o(s) agente(s) será(ão) registrado(s). 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 do grupo de implantação correspondente.

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

Saiba mais sobre usando tags para recursos do Azure.


runAgentServiceAsUser - Executar o serviço do 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 do agente como um usuário diferente do usuário padrão se o valor estiver definido como true.

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


userName - Nome de utilizador
string. Necessário quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

O nome de usuário para executar o serviço do 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 do grupo de recursos.


password - Palavra-passe
string. Opcional. Use quando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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

Presume-se que a senha é a mesma para o usuário especificado em todas as VMs.

Ele pode aceitar variáveis definidas em pipelines de compilação ou liberação 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 o WinRM
string. Opcional. Use quando (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None).

Obrigatório quando um grupo de recursos existente é selecionado. Fornece um nome para a variável de 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 outputs do objeto de implantação atual em formato de cadeia de caracteres. Use o cmdlet 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.

Os 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á sem convertê-los via JSON. Stringify, habilite esta opção. Para obter mais detalhes, consulte este.


Opções de controlo de tarefas

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

Variáveis de saída

Nenhuma.

Comentários

Há uma nova versão desta tarefa disponível em AzureResourceManagerTemplateDeployment@3 - ARM template deployment v3 task.

O que há de novo na versão 2 da tarefa

  • Funciona com agentes multiplataforma (Linux, macOS ou Windows)
  • Suporta JSONs de modelo localizados em qualquer URL http/https acessível publicamente.
  • UX aprimorado para parâmetros de substituição que agora podem ser visualizados/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 Classic. Apenas subscrições ARM são suportadas.
    • Não há suporte para sintaxe do PowerShell, pois a tarefa agora é baseada em node.js. Certifique-se de que a diferenciação de maiúsculas e minúsculas dos nomes dos parâmetros corresponda quando você substituir os parâmetros do 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 interno do servidor

Estas questões são, na sua maioria, de natureza transitória. 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 de olho em https://status.azure.com/ verificar os períodos de inatividade dos Serviços do Azure.
  • O próprio serviço Azure Pipelines está passando por manutenção. Fique de olho em https://status.dev.azure.com/ para tempos de inatividade.

No entanto, vimos alguns casos em que isso se deve a um erro no modelo ARM, como o serviço do Azure que você está tentando implantar não oferece suporte à região escolhida para o recurso.

Erro: Tempo limite

Os problemas de tempo limite podem vir de dois lugares:

  • Agente de Pipelines do Azure
  • 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 se deve 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 ativadas ao substituir 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 do CORS sejam habilitadas na origem. Se os modelos estiverem no blob de armazenamento do Azure, consulte de suporte ao compartilhamento de recursos entre origens para habilitar o CORS.

Além de habilitar o CORS, certifique-se de que o token SAS especificado no link do modelo é "srt-sco". Este token é necessário para você baixar o arquivo e prosseguir.

Agente de Pipelines do Azure

Se o problema estiver vindo 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 histórico de implantação com o Azure Resource Manager.

Em caso de implantação do portal, tente definir "timeoutInMinutes" no modelo ARM como "0". Se não for especificado, o valor assumido é de 60 minutos. 0 garante que a implantação será executada pelo tempo que puder para ser bem-sucedida.

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 Azure Pipelines.

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

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

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

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

Requerimentos

Exigência Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências 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 de tarefa Implantar