AzureVmssDeployment@0 – Tarefa v0 de implantação do conjunto de dimensionamento de VMs do Azure

Essa tarefa implanta uma imagem do conjunto de dimensionamento de Máquinas Virtuais.

Sintaxe

# Azure VM scale set deployment v0
# Deploy a virtual machine scale set image.
- task: AzureVmssDeployment@0
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Update image' # 'Update image' | 'Configure application startup'. Required. Action. Default: Update image.
    vmssName: # string. Required. Virtual Machine scale set name. 
    vmssOsType: # 'Windows' | 'Linux'. Required. OS type. 
  # Image Details
    #imageUrl: # string. Required when action = Update image || action = UpdateImage. Image URL. 
  # Configure start-up
    #customScriptsDirectory: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Custom script directory. 
    #customScript: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Command. 
    #customScriptArguments: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Arguments. 
    #customScriptsStorageAccount: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Azure storage account where custom scripts will be uploaded. 
  # Advanced
    #skipArchivingCustomScripts: false # boolean. Skip Archiving custom scripts. Default: false.

Entradas

azureSubscription - assinatura do Azure
Alias de entrada: ConnectedServiceName. string. Necessário.

Especifica a assinatura do Azure Resource Manager para o conjunto de dimensionamento.

de Ação
string. Necessário. Valores permitidos: Update image (atualizar conjunto de dimensionamento de VM usando uma imagem), Configure application startup (executar extensão de VM de script personalizado no conjunto de dimensionamento de VM). Valor padrão: Update image.

Atualiza um conjunto de dimensionamento de VM pelo método escolhido, usando uma imagem VHD e/ou executando scripts de implantação/instalação usando a Extensão de VM de Script Personalizado.

a abordagem de imagem VHD é melhor para dimensionar rapidamente e fazer a reversão. Quando um conjunto de dimensionamento de VM é criado usando uma imagem personalizada, ele pode ser atualizado por uma imagem VHD. A atualização falhará se o conjunto de dimensionamento da VM tiver sido criado usando uma imagem de plataforma/galeria disponível no Azure.

a abordagem de extensão de VM de script personalizado é útil para configuração pós-implantação, instalação de software ou qualquer outra tarefa de configuração/gerenciamento. A abordagem de Extensão de VM de Script Personalizado pode ser usada para um conjunto de dimensionamento de VM criado usando uma imagem personalizada ou uma imagem de plataforma/galeria.

vmssName - nome do conjunto de dimensionamento de máquinas virtuais
string. Necessário.

Especifica o nome da configuração de escala de VM a ser atualizada. Use uma imagem VHD ou uma extensão de VM de script personalizado.

vmssOsType - tipo de sistema operacional
string. Necessário. Valores permitidos: Windows, Linux.

Especifica o tipo de sistema operacional do conjunto de dimensionamento de VM.

imageUrl - de URL de Imagem
string. Necessário quando action = Update image || action = UpdateImage.

Especifica a URL da imagem VHD. Se for uma URL de blob de armazenamento do Azure, o local da conta de armazenamento será o mesmo que o local do conjunto de dimensionamento.

customScriptsDirectory - diretório de script personalizado
string. Opcional. Use quando action = Configure application startup || action = Update image || action = UpdateImage.

Opcional. O caminho para o diretório que contém os scripts personalizados que são executados usando a Extensão de VM de Script Personalizado. A abordagem de extensão é útil para configuração pós-implantação, instalação de aplicativo/software ou qualquer outra tarefa de configuração/gerenciamento de aplicativos. Por exemplo, o script pode definir uma variável de ambiente no nível do computador que o aplicativo usa, como cadeias de conexão de banco de dados.

comando customScript -
string. Opcional. Use quando action = Configure application startup || action = Update image || action = UpdateImage.

Opcional. O script executado usando a Extensão de VM de Script Personalizado. Esse script pode invocar outros scripts no diretório e é invocado com os argumentos passados abaixo.
Em conjunto com esses argumentos, esse script pode ser usado para executar comandos.

Por exemplo:

1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd) atualiza a cadeia de conexão no web.config do aplicativo Web.
2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey cria um arquivo criptografado que contém uma chave de entidade de serviço.

argumentos customScriptArguments -
string. Opcional. Use quando action = Configure application startup || action = Update image || action = UpdateImage.

Opcional. O script personalizado será invocado com argumentos passados. Variáveis de build/versão podem ser usadas, o que facilita o uso de segredos.

customScriptsStorageAccount - conta de armazenamento do Azure em que os scripts personalizados serão carregados
string. Opcional. Use quando action = Configure application startup || action = Update image || action = UpdateImage.

Opcional. A Extensão de Script Personalizado baixa e executa os scripts fornecidos em cada máquina virtual no conjunto de dimensionamento de VM. Esses scripts serão armazenados na conta de armazenamento do ARM pré-existente especificada aqui.

skipArchivingCustomScripts - Ignorar scripts personalizados de arquivamento
boolean. Valor padrão: false.

Opcional. Por padrão, essa tarefa cria um arquivo compactado do diretório que contém os scripts personalizados. Isso melhora o desempenho e a confiabilidade ao carregar no armazenamento do Azure. Se não estiver selecionado, o arquivamento não será feito e todos os arquivos serão carregados individualmente.

Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

Use essa tarefa para implantar uma imagem do conjunto de dimensionamento de máquinas virtuais.

A execução do script é relatada como bem-sucedida, no entanto, as instâncias do VMSS não são atualizadas

Os conjuntos de dimensionamento têm uma política de atualização que determina como as VMs são trazidas up-todata com o modelo de conjunto de dimensionamento mais recente e, se a política de atualização for definida como manual, você deverá atualizar manualmente cada VM. Para obter mais informações, consulte Como colocar as VMs up-to-date com o modelo de conjunto de dimensionamento mais recente. Você pode alterar a política de atualização ou atualizar manualmente cada VM. Por exemplo, para atualizar a política para Automatic, use o seguinte comando da CLI do Az: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Erro: 'Permissão negada: script não é executável'

Esse problema ocorrerá se você tentar executar um script personalizado, mas o script não for executável.

Para resolver o problema, primeiro verifique se a entrada customScript não tem ./ ou qualquer outra coisa antes que o nome do script 'test.sh':

    customScript: 'test.sh'

Em seguida, tente adicionar uma tarefa de linha de comando antes da tarefa do conjunto de dimensionamento de máquinas virtuais:

    - task: CmdLine@2
      inputs:
        script: 'chmod 777 $(System.DefaultWorkingDirectory)/test.sh' 

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
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	2.209.0 ou superior
Categoria de tarefa	Implantar