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

Artigo
08/19/2024

Utilize esta tarefa para implementar, iniciar, parar e eliminar Grupos de Recursos do Azure.

Esta tarefa foi preterida; utilizar 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 Ligação do Azure
string. Valores permitidos: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure Classic). Valor predefinido: ConnectedServiceName.

Obrigatório. Seleciona a ligação de serviço que contém uma Subscrição do Azure para a implementação.

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

Obrigatório. Seleciona a ligação de serviço que contém uma Subscrição do Azure para a implementação.

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

Seleciona uma subscrição clássica do Azure para a implementação.

action - Ação
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName. Valores permitidos: Create Or Update Resource Group, StartSelect Resource Group(Iniciar Máquinas Virtuais), Stop (Parar Máquinas Virtuais), Restart (Reiniciar Máquinas Virtuais), Delete (Eliminar Máquinas Virtuais), DeleteRG (Eliminar Grupo de Recursos). Valor predefinido: Create Or Update Resource Group.

A ação a ser efetuada no grupo de recursos ou recursos do Azure.

actionClassic - Ação
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameClassic. Valores permitidos: Select Resource Group (Selecione Serviço Cloud). Valor predefinido: Select Resource Group.

A ação a ser efetuada nos recursos do Azure ou no serviço cloud.

resourceGroupName - Grupo de Recursos
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

Fornece o nome do grupo de recursos.

cloudService - Serviço Cloud
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Fornece o nome do serviço cloud.

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, East AsiaCentral US, East US, East US 2 , Japan East, Japan West, North Central US, , South Central USNorth Europe, , South India, Southeast Asia, UK South, , UK West, West Central US, West Europe, West India, , West US. West US 2 Valor predefinido: East US.

A localização para implementar o grupo de recursos. Se o grupo de recursos já existir na subscrição, este 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 de Resource Manager do Azure. Saiba mais sobre os modelos de Resource Manager do Azure. Para começar imediatamente, utilize este modelo de exemplo.

csmParametersFile - Parâmetros de Modelo
string. Opcional. Utilize quando action = Create Or Update Resource Group.

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

Para utilizar um ficheiro armazenado numa conta de armazenamento privado, obtenha e inclua o token de assinatura de acesso partilhado (SAS) no URL do modelo. Exemplo: <blob_storage_url>/template.json?<SAStoken> para carregar um ficheiro de parâmetros para uma conta de armazenamento e gerar um token de SAS, utilize a tarefa de cópia de ficheiros do Azure ou siga os passos com o PowerShell ou a CLI do Azure.

Para ver os parâmetros do modelo numa grelha, clique em … junto à caixa de texto substituir parâmetros de modelo. Esta funcionalidade requer que as regras CORS estejam ativadas na origem. Se os modelos estiverem no blob de armazenamento do Azure, veja Partilha de Recursos Entre Origens para ativar o CORS.

overrideParameters - Substituir Parâmetros de Modelo
string. Opcional. Utilize quando action = Create Or Update Resource Group.

Especifica os parâmetros do modelo a substituir.

Para ver os parâmetros do modelo numa grelha, clique em ... junto à caixa de texto Substituir Parâmetros. Esta funcionalidade requer que as regras CORS estejam ativadas na origem. Se os modelos estiverem no blob de armazenamento do Azure, faça referência a esta cadeia para ativar o CORS ou escreva os parâmetros do modelo a substituir 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 múltiplas palavras, coloque as palavras entre aspas, mesmo que esteja a transmitir o valor através de variáveis. Por exemplo, -name "parameter value" -name2 "$(var)". Para substituir os parâmetros do tipo de objeto, utilize objetos JSON com cadeias. Por exemplo, -options ["option1"] -map {"key1": "value1" }.

deploymentMode - Modo de Implementação
string. Necessário quando action = Create Or Update Resource Group. Valores permitidos: Validation (Apenas Validação), Incremental, Complete. Valor predefinido: Incremental.

O Incremental modo processa as implementações como atualizações incrementais para o grupo de recursos. Deixa os recursos inalterados que existem no grupo de recursos, mas não são especificados no modelo.

Complete o modo elimina recursos que não estão no seu modelo. O modo completo demora relativamente mais tempo do que o modo incremental. Se a tarefa exceder o limite de tempo, considere aumentar o tempo limite ou mudar para o Incremental modo.

Aviso

O modo completo eliminará todos os recursos existentes no grupo de recursos que não estão especificados no modelo. Analise se o grupo de recursos para o qual está a implementar não contém quaisquer recursos necessários que não estejam especificados no modelo.

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

Nota

O Validate modo cria sempre um grupo de recursos, mesmo que não sejam implementados recursos.

Saiba mais sobre os modos de implementação.

enableDeploymentPrerequisitesForCreate - Ativar Pré-requisitos de Implementação
boolean. Opcional. Utilize quando action = Create Or Update Resource Group. Valor predefinido: false.

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

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

Selecionar a opção WinRM configura o serviço de escuta da Gestão Remota do Windows (WinRM) através do protocolo HTTPS na porta 5986 com um certificado autoassinado. Esta configuração é necessária para executar a operação de implementação em máquinas do Azure. Se as máquinas virtuais de destino forem suportadas por um balanceador de carga, certifique-se de que as regras NAT de entrada estão configuradas para a porta de destino (5986).

enableDeploymentPrerequisitesForSelect - Ativar Pré-requisitos de Implementação
boolean. Opcional. Utilize quando action = Select Resource Group. Valor predefinido: false.

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

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

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 utilizada para $(variableName) se referir ao grupo de recursos em tarefas subsequentes, como na tarefa Do PowerShell em Máquinas de Destino para implementar aplicações.

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

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente, DeploymentGroup
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizam esta tarefa: azureps
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	1.103.0 ou superior
Categoria da tarefa	Implementação

Partilhar via