AzureVmssDeployment@0 – Azure VM Scale Set Deployment v0 task

Diese Aufgabe stellt ein Skalierungssatzimage für virtuelle Computer bereit.

Syntax

# 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.

Eingänge

azureSubscription - Azure-Abonnement
Eingabealias: ConnectedServiceName. string. Erforderlich.

Gibt das Azure Resource Manager-Abonnement für den Skalierungssatz an.

action - Aktion
string. Erforderlich. Zulässige Werte: Update image (VM Scale set by using an image), Configure application startup (Run Custom Script VM extension on VM scale set). Standardwert: Update image.

Aktualisiert eine VM-Skalierung, die von der ausgewählten Methode festgelegt wurde, mithilfe eines VHD-Images und/oder durch Ausführen von Bereitstellungs-/Installationsskripts mithilfe der Erweiterung für benutzerdefinierte Skript-VM.

Der VHD-Imageansatz ist besser für die schnelle Skalierung und das Durchführen eines Rollbacks geeignet. Wenn ein VM-Skalierungssatz mithilfe eines benutzerdefinierten Images erstellt wird, kann er von einem VHD-Image aktualisiert werden. Das Update schlägt fehl, wenn der VM-Skalierungssatz mithilfe eines Plattform-/Katalogimages erstellt wurde, das in Azure verfügbar ist.

Der Ansatz für die VM-Erweiterung für benutzerdefinierte Skripts ist für die Bereitstellungskonfiguration, Softwareinstallation oder andere Konfigurations-/Verwaltungsaufgaben nützlich. Der Ansatz für die VM-Erweiterung für benutzerdefinierte Skripts kann für einen VM-Skalierungssatz verwendet werden, der entweder mit einem benutzerdefinierten Image oder einem Plattform-/Katalogimage erstellt wurde.

vmssName - Vm-Skalierungssatzname
string. Erforderlich.

Gibt den Namen der zu aktualisierenden VM-Skalierungseinstellung an. Verwenden Sie entweder ein VHD-Image oder eine benutzerdefinierte Skript-VM-Erweiterung.

vmssOsType - Betriebssystemtyp
string. Erforderlich. Zulässige Werte: Windows, Linux.

Gibt den Betriebssystemtyp des VM-Skalierungssatzes an.

imageUrl - Bild-URL
string. Erforderlich, wenn action = Update image || action = UpdateImage.

Gibt die URL des VHD-Bilds an. Wenn es sich um eine Azure Storage Blob-URL handelt, entspricht der Speicherort des Speicherkontos dem Skalierungssatzspeicherort.

customScriptsDirectory - Benutzerdefiniertes Skriptverzeichnis
string. Wahlfrei. Wird verwendet, wenn action = Configure application startup || action = Update image || action = UpdateImage.

Wahlfrei. Der Pfad zum Verzeichnis, das die benutzerdefinierten Skripts enthält, die mithilfe der Erweiterung für benutzerdefinierte Skript-VM ausgeführt werden. Der Erweiterungsansatz ist nützlich für die Bereitstellungskonfiguration, Anwendungs-/Softwareinstallation oder eine andere Anwendungskonfigurations-/Verwaltungsaufgabe. Beispielsweise kann das Skript eine Umgebungsvariable auf Computerebene festlegen, die von der Anwendung verwendet wird, z. B. Datenbankverbindungszeichenfolgen.

customScript - Command
string. Wahlfrei. Wird verwendet, wenn action = Configure application startup || action = Update image || action = UpdateImage.

Wahlfrei. Das Skript, das mithilfe der Vm-Erweiterung für benutzerdefinierte Skripts ausgeführt wird. Dieses Skript kann andere Skripts im Verzeichnis aufrufen und mit den unten übergebenen Argumenten aufgerufen werden.
In Verbindung mit solchen Argumenten kann dieses Skript zum Ausführen von Befehlen verwendet werden.

Zum Beispiel:

1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd) aktualisiert die Verbindungszeichenfolge in web.config der Webanwendung.
2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey erstellt eine verschlüsselte Datei mit einem Dienstprinzipalschlüssel.

customScriptArguments - Argumente
string. Wahlfrei. Wird verwendet, wenn action = Configure application startup || action = Update image || action = UpdateImage.

Wahlfrei. Das benutzerdefinierte Skript wird mit übergebenen Argumenten aufgerufen. Build-/Releasevariablen können verwendet werden, wodurch geheime Schlüssel einfach verwendet werden können.

customScriptsStorageAccount - Azure-Speicherkonto, in das benutzerdefinierte Skripts hochgeladen werden
string. Wahlfrei. Wird verwendet, wenn action = Configure application startup || action = Update image || action = UpdateImage.

Wahlfrei. Die Benutzerdefinierte Skripterweiterung lädt die bereitgestellten Skripts auf jedem virtuellen Computer im VM-Skalierungssatz herunter und führt sie aus. Diese Skripts werden im hier angegebenen vorhandenen ARM-Speicherkonto gespeichert.

skipArchivingCustomScripts - Archivierung benutzerdefinierter Skripts überspringen
boolean. Standardwert: false.

Wahlfrei. Standardmäßig erstellt diese Aufgabe ein komprimiertes Archiv des Verzeichnisses, das die benutzerdefinierten Skripts enthält. Dies verbessert die Leistung und Zuverlässigkeit beim Hochladen in Azure Storage. Wenn nicht ausgewählt, erfolgt die Archivierung nicht, und alle Dateien werden einzeln hochgeladen.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Nichts.

Bemerkungen

Verwenden Sie diese Aufgabe, um ein Skalierungssetimage für virtuelle Computer bereitzustellen.

Die Skriptausführung wird als erfolgreich gemeldet, die VMSS-Instanzen werden jedoch nicht aktualisiert.

Skalierungssätze verfügen über eine Upgraderichtlinie, die bestimmt, wie VMs mit dem neuesten Skalierungssatzmodell up-to-Datum gebracht werden, und wenn die Upgraderichtlinie auf manuell festgelegt ist, müssen Sie jede VM manuell aktualisieren. Weitere Informationen finden Sie unter How to bring VMs up-to-date with the latest scale set model. Sie können die Updaterichtlinie ändern oder jede VM manuell aktualisieren. Um beispielsweise die Richtlinie auf Automaticzu aktualisieren, verwenden Sie den folgenden Az CLI-Befehl: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Fehler: 'Berechtigung verweigert: Skript ist nicht ausführbare Datei'

Dieses Problem tritt auf, wenn Sie versuchen, ein benutzerdefiniertes Skript auszuführen, das Skript jedoch nicht ausführbar ist.

Um das Problem zu beheben, stellen Sie zuerst sicher, dass die customScript Eingabe nicht über ./ oder etwas anderes verfügt, bevor der Skriptname 'test.sh':

    customScript: 'test.sh'

Versuchen Sie als Nächstes, eine Befehlszeilenaufgabe hinzuzufügen, bevor Sie die Skalierungssatzaufgabe des virtuellen Computers ausführen:

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

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.209.0 oder höher
Vorgangskategorie	Aufstellen