AzureVmssDeployment@0 - Tarefa v0 de implantação do conjunto de escala de VM do Azure

Esta tarefa implanta uma imagem de conjunto de escala de máquina virtual.

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.

Insumos

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

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

action - Ação
string. Necessário. Valores permitidos: Update image (Atualizar escala de VM definida usando uma imagem), Configure application startup (Executar extensão de VM de script personalizado no conjunto de escala de VM). Valor padrão: Update image.

Atualiza uma escala de VM definida 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 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 escala 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 escala de VM criado usando uma imagem personalizada ou uma imagem de plataforma/galeria.

vmssName - nome do conjunto de escala da máquina virtual
string. Necessário.

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

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

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

imageUrl - URL da 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 escala.

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 o(s) script(s) personalizado(s) 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 de nível de máquina que o aplicativo usa, como cadeias de conexão de banco de dados.

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

Opcional. O script que é 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 em web.config do aplicativo Web.
2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey cria um ficheiro encriptado que contém uma chave principal de serviço.

customScriptArguments - Argumentos
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 compilação/liberação podem ser usadas, o que facilita o uso de segredos.

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

Opcional. A Extensão de Script Personalizada baixa e executa os scripts fornecidos em cada máquina virtual no conjunto de escala de VM. Esses scripts serão armazenados na conta de armazenamento 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 for selecionado, o arquivamento não será feito e todos os arquivos serão carregados individualmente.

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

Nenhuma.

Comentários

Use esta tarefa para implantar uma imagem de conjunto de escala de máquina virtual.

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 atualizadas up-tocom o modelo de conjunto de escala mais recente e, se a política de atualização estiver definida como manual, você deverá atualizar manualmente cada VM. Para obter mais informações, consulte Como atualizar as VMs up-tocom o modelo de conjunto de escala 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 Az CLI: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

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

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

Para resolver o problema, primeiro certifique-se de que a entrada customScript não tenha ./ 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 de dimensionamento da máquina virtual:

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

Requerimentos

Exigência	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
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	2.209.0 ou superior
Categoria de tarefa	Implantar