Condividi tramite


AzureVmssDeployment@0 - Attività distribuzione del set di scalabilità di macchine virtuali di Azure v0

Questa attività distribuisce un'immagine del set di scalabilità di macchine virtuali.

Sintassi

# 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.
# Azure VM scale set Deployment v0
# Deploy 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.

Input

azureSubscription - Sottoscrizione di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio.

Specifica la sottoscrizione di Azure Resource Manager per il set di scalabilità.


action - Azione
string. Obbligatorio. Valori consentiti: Update image (aggiornare il set di scalabilità di macchine virtuali usando un'immagine), Configure application startup (Eseguire l'estensione della macchina virtuale script personalizzata nel set di scalabilità di macchine virtuali). Valore predefinito: Update image.

Aggiornamenti un set di scalabilità di macchine virtuali tramite il metodo scelto, usando un'immagine del disco rigido virtuale e/o eseguendo script di distribuzione/installazione usando l'estensione macchina virtuale script personalizzata.

L'approccio alle immagini del disco rigido virtuale è migliore per il ridimensionamento rapido e l'operazione di rollback. Quando un set di scalabilità di macchine virtuali viene creato usando un'immagine personalizzata, può essere aggiornato da un'immagine del disco rigido virtuale. L'aggiornamento avrà esito negativo se il set di scalabilità di macchine virtuali è stato creato usando un'immagine della piattaforma o della raccolta disponibile in Azure.

L'approccio dell'estensione macchina virtuale script personalizzato è utile per la configurazione post-distribuzione, l'installazione del software o qualsiasi altra attività di configurazione/gestione. L'approccio dell'estensione vm script personalizzato può essere usato per un set di scalabilità di macchine virtuali creato usando un'immagine personalizzata o un'immagine della piattaforma/raccolta.


vmssName - Nome del set di scalabilità di macchine virtuali
string. Obbligatorio.

Specifica il nome dell'impostazione di scalabilità della macchina virtuale da aggiornare. Usare un'immagine del disco rigido virtuale o un'estensione macchina virtuale script personalizzata.


vmssOsType - Tipo di sistema operativo
string. Obbligatorio. Valori consentiti: Windows, Linux.

Specifica il tipo di sistema operativo del set di scalabilità di macchine virtuali.


imageUrl - URL immagine
string. Obbligatorio quando action = Update image || action = UpdateImage.

Specifica l'URL dell'immagine del disco rigido virtuale. Se si tratta di un URL del BLOB di archiviazione di Azure, il percorso dell'account di archiviazione corrisponde al percorso del set di scalabilità.


customScriptsDirectory - Directory script personalizzata
string. facoltativo. Usare quando action = Configure application startup || action = Update image || action = UpdateImage.

facoltativo. Percorso della directory contenente gli script personalizzati eseguiti tramite l'estensione della macchina virtuale script personalizzata. L'approccio di estensione è utile per la configurazione post-distribuzione, l'installazione di applicazioni/software o qualsiasi altra attività di configurazione/gestione dell'applicazione. Ad esempio, lo script può impostare una variabile di ambiente a livello di computer usata dall'applicazione, ad esempio le stringhe di connessione del database.


customScript - Comando
string. facoltativo. Usare quando action = Configure application startup || action = Update image || action = UpdateImage.

facoltativo. Script eseguito usando l'estensione della macchina virtuale script personalizzata. Questo script può richiamare altri script nella directory e viene richiamato con gli argomenti passati di seguito.
In combinazione con tali argomenti, questo script può essere usato per eseguire i comandi.

Ad esempio:

  1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd)aggiorna il stringa di connessione nell'applicazione web.config Web.
  2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey crea un file crittografato contenente una chiave dell'entità servizio.

customScriptArguments - Argomenti
string. facoltativo. Usare quando action = Configure application startup || action = Update image || action = UpdateImage.

facoltativo. Lo script personalizzato verrà richiamato con argomenti passati. È possibile usare variabili di compilazione/rilascio, che semplificano l'uso dei segreti.


customScriptsStorageAccount - Account di archiviazione di Azure in cui verranno caricati script personalizzati
string. facoltativo. Usare quando action = Configure application startup || action = Update image || action = UpdateImage.

facoltativo. L'estensione script personalizzata scarica ed esegue gli script forniti in ogni macchina virtuale nel set di scalabilità di macchine virtuali. Questi script verranno archiviati nell'account di archiviazione ARM preesistente specificato qui.


skipArchivingCustomScripts - Ignorare gli script personalizzati di archiviazione
boolean. Valore predefinito: false.

facoltativo. Per impostazione predefinita, questa attività crea un archivio compresso della directory contenente gli script personalizzati. Ciò migliora le prestazioni e l'affidabilità durante il caricamento in Archiviazione di Azure. Se non è selezionata, l'archiviazione non verrà eseguita e tutti i file verranno caricati singolarmente.


Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per distribuire un'immagine del set di scalabilità di macchine virtuali.

L'esecuzione dello script viene segnalata come riuscita, ma le istanze del set di scalabilità di macchine virtuali non vengono aggiornate

I set di scalabilità dispongono di criteri di aggiornamento che determinano come le macchine virtuali vengono aggiornate con il modello del set di scalabilità più recente e, se i criteri di aggiornamento sono impostati su manuale, è necessario aggiornare manualmente ogni macchina virtuale. Per altre informazioni, vedere Come aggiornare le macchine virtuali con il modello del set di scalabilità più recente. È possibile modificare i criteri di aggiornamento o aggiornare manualmente ogni macchina virtuale. Ad esempio, per aggiornare il criterio a Automatic, usare il comando az cli seguente: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Errore: 'Autorizzazione negata: Lo script non è eseguibile'

Questo problema si verifica se si tenta di eseguire uno script personalizzato, ma lo script non è eseguibile.

Per risolvere il problema, assicurarsi innanzitutto che l'input customScript non abbia ./ o altro prima del nome 'test.sh'dello script :

    customScript: 'test.sh'

Provare quindi ad aggiungere un'attività della riga di comando prima dell'attività del set di scalabilità di macchine virtuali:

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

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 2.0.0 o versione successiva
Categoria attività Distribuire