Partilhar via


AzureResourceGroupDeployment@1 - Tarefa de Implantação do Grupo de Recursos do Azure v1

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

Esta tarefa foi preterida; use AzureResourceGroupDeployment@2.

Sintaxe

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

Insumos

ConnectedServiceNameSelector - Tipo de Conexão do Azure
string. Valores permitidos: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure Classic). Valor padrão: ConnectedServiceName.

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


ConnectedServiceName - Subscrição do Azure
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

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


ConnectedServiceNameClassic - de Subscrição Clássica do Azure
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Seleciona uma assinatura do Azure Classic para a implantação.


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


actionClassic - Ação
string. Necessá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. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

Fornece o nome do grupo de recursos.


cloudService - de serviço na nuvem
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Fornece o nome do serviço de nuvem.


location - Localização
string. Necessário quando action = Create Or Update Resource Group. Valores permitidos: 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. 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. Necessário quando 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 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 no blob de armazenamento do Azure, consulte de 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 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" }.


do modo de implantação deploymentMode -
string. Necessário quando action = Create Or Update Resource Group. Valores permitidos: Validation (Somente validação), IncrementalComplete. 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.


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


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


outputVariable - Grupo de Recursos
string.

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.


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

Nenhum.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: azureps
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 1.103.0 ou superior
Categoria de tarefa Desplegar