Compartilhar via

tarefa AzureResourceGroupDeployment@1 – Implantação v1 do Grupo de Recursos do Azure

  • Artigo

Use essa tarefa para implantar, iniciar, parar e excluir Grupos de Recursos do Azure.

Esta tarefa foi preterida; use AzureResourceGroupDeployment@2.

Syntax

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

Entradas

ConnectedServiceNameSelector - Tipo de conexão do Azure
string. Valores permitidos: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Clássico do Azure). Valor padrão: ConnectedServiceName.

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


ConnectedServiceName - Assinatura do Azure
string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceName.

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


ConnectedServiceNameClassic - Assinatura clássica do Azure
string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Seleciona uma assinatura clássica do Azure para a implantação.


action - Ação
string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceName. Valores permitidos: Create Or Update Resource Group, Select Resource Group, Start (Iniciar Máquinas Virtuais), Stop (Parar 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.


actionClassic - Ação
string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceNameClassic. Valores permitidos: Select Resource Group (Selecione Serviço de Nuvem). Valor padrão: Select Resource Group.

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


resourceGroupName - Grupo de Recursos
string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceName.

Fornece o nome do grupo de recursos.


cloudService - Serviço de Nuvem
string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Fornece o nome do serviço de nuvem.


location - Localização
string. Obrigatório quando action = Create Or Update Resource Group. Valores permitidos: Australia East, Australia Southeast, , Brazil South, Canada Central, Canada East, Central India, East AsiaCentral US, East USNorth Central USJapan WestEast US 2 North EuropeJapan East, South Central US, South India, Southeast Asia, , UK South, UK West, West Central US, West Europe, West India, , . West US 2West US Valor padrão: East US.

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


csmFile - Modelo
string. Obrigatório quando 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 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 no blob de armazenamento do Azure, consulte Compartilhamento de recursos entre origens 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 Substituir Parâmetros. 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: Validation (somente validação), Incremental, Complete. 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.


enableDeploymentPrerequisitesForCreate - Habilitar pré-requisitos de implantação
boolean. Opcional. Use quando action = Create Or Update Resource Group. Valor padrão: false.

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


enableDeploymentPrerequisitesForSelect - Habilitar pré-requisitos de implantação
boolean. Opcional. Use quando action = Select Resource Group. Valor padrão: false.

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


outputVariable - Grupo de Recursos
string.

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 no PowerShell na tarefa Computadores de Destino para implantar aplicativos.

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


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.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam essa tarefa: azureps
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 1.103.0 ou superior
Categoria da tarefa Implantar