Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use essa tarefa para implantar, iniciar, parar e excluir Grupos de Recursos do Azure.
Essa 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.
Entradas
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
-
assinatura 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 Assinatura Clássica do Azure
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.
Seleciona uma assinatura do Azure Classic para a implantação.
de Ação action -
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 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.
de Ação actionClassic -
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameClassic. Valores permitidos: Select Resource Group (Selecionar 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.
do Grupo de Recursos do resourceGroupName -
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.
Fornece o nome do grupo de recursos.
do Serviço de Nuvem do cloudService -
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.
Fornece o nome do serviço de nuvem.
de Localização location -
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 WestNorth 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.
de modelo de csmFile -
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.
parâmetros de modelo csmParametersFile -
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 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 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 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 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: Validation (somente validação), Incremental, Complete. 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.
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 os 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) 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).
enableDeploymentPrerequisitesForSelect
-
habilitar os 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) 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).
do Grupo de Recursos do outputVariable -
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 na tarefa PowerShell on Target Machines para implantar aplicativos.
Válido somente quando a ação selecionada é Create, Updateou Select.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as 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 |
| Execuções em | Agent, DeploymentGroup |
| de demandas | Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: azureps |
| 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 | 1.103.0 ou superior |
| Categoria de tarefa | Implantar |