AzureVmssDeployment@0 - Azure VM-schaalsetimplementatie v0-taak

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

Syntaxis

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

Ingangen

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 (Aangepaste script-VM-extensie uitvoeren op VM-schaalset). Standaardwaarde: Update image.

Hiermee werkt u een VM-schaalset bij met behulp 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 benadering van de VHD-installatiekopieën is beter voor het 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-/galerieinstallatiekopieën die beschikbaar zijn in Azure.

De benadering van 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-/galerieinstallatiekopieën.

naam van vmssName - virtuele-machineschaalset
string. Vereist.

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

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. 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. Facultatief. Gebruiken wanneer action = Configure application startup || action = Update image || action = UpdateImage.

Facultatief. Het pad naar de map met de aangepaste script(en) die worden uitgevoerd met behulp van de extensie aangepaste script-VM. De uitbreidingsbenadering is handig voor configuratie na implementatie, toepassing/software-installatie of een andere toepassingsconfiguratie/beheertaak. Het script kan bijvoorbeeld een omgevingsvariabele op machineniveau instellen die door de toepassing wordt gebruikt, zoals databaseverbindingsreeksen.

customScript - opdracht
string. Facultatief. Gebruiken wanneer action = Configure application startup || action = Update image || action = UpdateImage.

Facultatief. 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 onderstaande argumenten.
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 bij in web.config van de webtoepassing.
2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey maakt een versleuteld bestand met een service-principalsleutel.

customScriptArguments - argumenten
string. Facultatief. Gebruiken wanneer action = Configure application startup || action = Update image || action = UpdateImage.

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

customScriptsStorageAccount - Azure-opslagaccount waarin aangepaste scripts worden geüpload
string. Facultatief. Gebruiken wanneer action = Configure application startup || action = Update image || action = UpdateImage.

Facultatief. 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 - Aangepaste scripts overslaan
boolean. Standaardwaarde: false.

Facultatief. 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 dit 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 en algemene taakeigenschappenvoor 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 waarmee wordt bepaald hoe VM's up-to-date worden gebracht met het meest recente schaalsetmodel. Als het upgradebeleid is ingesteld op handmatig, moet u elke VIRTUELE machine handmatig bijwerken. Zie VM's up-to-date brengen met het meest recente schaalsetmodelvoor meer informatie. U kunt het updatebeleid wijzigen of elke VIRTUELE machine handmatig bijwerken. 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 is niet uitvoerbaar.

Als u het probleem wilt oplossen, moet u er eerst voor zorgen dat de customScript invoer geen ./ of iets anders heeft voordat de scriptnaam 'test.sh':

    customScript: 'test.sh'

Voeg vervolgens een opdrachtregeltaak toe vóór de virtuele-machineschaalsettaak:

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

Eisen

Eis	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Enig
variabelen instellen	Enig
Agentversie	2.209.0 of hoger
Taakcategorie	Implementeren