AzureVmssDeployment@0 - Implementatie van Azure VM-schaalset v0-taak

Met deze taak wordt een installatiekopieën van een virtuele-machineschaalset geïmplementeerd.

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.

Invoerwaarden

azureSubscription - Azure-abonnement
Invoeralias: ConnectedServiceName. string. Vereist.

Hiermee geeft u het Azure Resource Manager-abonnement voor de schaalset op.

action - Actie
string. Vereist. Toegestane waarden: Update image (Vm-schaalset bijwerken met behulp van een installatiekopieën), Configure application startup (Vm-extensie aangepast script uitvoeren op VM-schaalset). Standaardwaarde: Update image.

Updates een VM-schaalset op basis van de gekozen methode, met behulp van een VHD-installatiekopieën en/of door implementatie-/installatiescripts uit te voeren met behulp van de aangepaste script-VM-extensie.

De VHD-installatiekopieën zijn beter voor snel schalen en terugdraaien. Wanneer een VM-schaalset wordt gemaakt met behulp van een aangepaste installatiekopieën, kan deze worden bijgewerkt door een VHD-installatiekopieën. De update mislukt als de VM-schaalset is gemaakt met behulp van een platform/galerie-installatiekopieën die beschikbaar zijn in Azure.

De aangepaste script-VM-extensie is handig voor configuratie na implementatie, software-installatie of een andere configuratie-/beheertaak. De methode Aangepaste script-VM-extensie kan worden gebruikt voor een VM-schaalset die is gemaakt met behulp van een aangepaste installatiekopieën of een platform/galerie-installatiekopieën.

vmssName - Naam van virtuele-machineschaalset
string. Vereist.

Hiermee geeft u de naam op van de VM-schaalinstelling die moet worden bijgewerkt. Gebruik een VHD-installatiekopieën of een VM-extensie voor aangepast script.

vmssOsType - Type besturingssysteem
string. Vereist. Toegestane waarden: Windows, Linux.

Hiermee geeft u het besturingssysteemtype van de VM-schaalset op.

imageUrl - Afbeeldings-URL
string. Vereist wanneer action = Update image || action = UpdateImage.

Hiermee geeft u de URL van de VHD-installatiekopieën op. Als het een Azure Storage Blob-URL is, is de locatie van het opslagaccount hetzelfde als de locatie van de schaalset.

customScriptsDirectory - Aangepaste scriptmap
string. Optioneel. Gebruik wanneer action = Configure application startup || action = Update image || action = UpdateImage.

Optioneel. Het pad naar de map met de aangepaste scripts die worden uitgevoerd met behulp van de VM-extensie voor aangepast script. De extensiebenadering is handig voor configuratie na implementatie, installatie van toepassingen/software of een andere toepassingsconfiguratie/beheertaak. Het script kan bijvoorbeeld een omgevingsvariabele op computerniveau instellen die door de toepassing wordt gebruikt, zoals databaseverbindingsreeksen.

customScript - Opdracht
string. Optioneel. Gebruik wanneer action = Configure application startup || action = Update image || action = UpdateImage.

Optioneel. Het script dat wordt uitgevoerd met behulp van de AANGEPASTe script-VM-extensie. Dit script kan andere scripts in de map aanroepen en wordt aangeroepen met de argumenten die hieronder worden doorgegeven.
In combinatie met dergelijke argumenten kan dit script worden gebruikt om opdrachten uit te voeren.

Bijvoorbeeld:

1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd)werkt de verbindingsreeks van web.config de webtoepassing bij.
2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey maakt een versleuteld bestand met een service-principalsleutel.

customScriptArguments - Argumenten
string. Optioneel. Gebruik wanneer action = Configure application startup || action = Update image || action = UpdateImage.

Optioneel. Het aangepaste script wordt aangeroepen met argumenten die worden doorgegeven. Build-/releasevariabelen kunnen worden gebruikt, waardoor geheimen eenvoudig kunnen worden gebruikt.

customScriptsStorageAccount - Azure-opslagaccount waar aangepaste scripts worden geüpload
string. Optioneel. Gebruik wanneer action = Configure application startup || action = Update image || action = UpdateImage.

Optioneel. De aangepaste scriptextensie downloadt en voert de opgegeven scripts uit op elke virtuele machine in de VM-schaalset. Deze scripts worden opgeslagen in het bestaande ARM-opslagaccount dat hier is opgegeven.

skipArchivingCustomScripts - Archiveren van aangepaste scripts overslaan
boolean. Standaardwaarde: false.

Optioneel. Deze taak maakt standaard een gecomprimeerd archief van de map met de aangepaste scripts. Dit verbetert de prestaties en betrouwbaarheid tijdens het uploaden naar Azure Storage. Als deze optie niet is geselecteerd, wordt archivering niet uitgevoerd en worden alle bestanden afzonderlijk geüpload.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een installatiekopieën van een virtuele-machineschaalset te implementeren.

De uitvoering van het script wordt gerapporteerd als geslaagd, maar de VMSS-exemplaren worden niet bijgewerkt

Schaalsets hebben een upgradebeleid dat bepaalt hoe VM's worden bijgewerkt met het nieuwste schaalsetmodel. Als het upgradebeleid is ingesteld op handmatig, moet u elke VM handmatig upgraden. Zie VM's up-to-date brengen met het nieuwste schaalsetmodel voor meer informatie. U kunt het updatebeleid wijzigen of elke VM handmatig upgraden. Als u bijvoorbeeld het beleid wilt upgraden naar Automatic, gebruikt u de volgende Az CLI-opdracht: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Fout: 'Machtiging geweigerd: script is niet uitvoerbaar'

Dit probleem treedt op als u probeert een aangepast script uit te voeren, maar het script niet uitvoerbaar is.

U kunt het probleem oplossen door er eerst voor te zorgen dat de customScript invoer geen ./ of iets anders heeft vóór de scriptnaam 'test.sh':

    customScript: 'test.sh'

Probeer vervolgens een opdrachtregeltaak toe te voegen vóór de taak van de virtuele-machineschaalset:

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

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.0.0 of hoger
Taakcategorie	Implementeren