AzureVmssDeployment@0 – Distribution av vm-skalningsuppsättningar i Azure v0

Den här uppgiften distribuerar en vm-skalningsuppsättningsbild.

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

Ingångar

azureSubscription - Azure-prenumeration
Indataalias: ConnectedServiceName. string. Krävs.

Anger Azure Resource Manager-prenumerationen för skalningsuppsättningen.


action - åtgärd
string. Krävs. Tillåtna värden: Update image (Uppdatera VM-skalningsuppsättning med hjälp av en avbildning), Configure application startup (Kör tillägget för anpassad skript-VM på VM-skalningsuppsättningen). Standardvärde: Update image.

Uppdaterar en VM-skalningsuppsättning med den valda metoden med hjälp av en VHD-avbildning och/eller genom att köra distributions-/installationsskript med hjälp av tillägget för den virtuella datorn med anpassat skript.

VHD-avbildningsmetoden är bättre för snabb skalning och återställning. När en VM-skalningsuppsättning skapas med hjälp av en anpassad avbildning kan den uppdateras av en VHD-avbildning. Uppdateringen misslyckas om VM-skalningsuppsättningen skapades med hjälp av en plattforms-/galleriavbildning som är tillgänglig i Azure.

Metoden för vm-tillägg för anpassade skript är användbar för konfiguration efter distribution, programvaruinstallation eller någon annan konfigurations-/hanteringsuppgift. Metoden för vm-tillägg för anpassade skript kan användas för en VM-skalningsuppsättning som skapats med hjälp av antingen en anpassad avbildning eller en plattforms-/galleriavbildning.


vmssName - vm-skalningsuppsättningens namn
string. Krävs.

Anger namnet på vm-skalningsinställningen som ska uppdateras. Använd antingen en VHD-avbildning eller ett tillägg för en virtuell dator med anpassat skript.


vmssOsType - operativsystemtyp
string. Krävs. Tillåtna värden: Windows, Linux.

Anger operativsystemtypen för VM-skalningsuppsättningen.


imageUrl - bild-URL
string. Krävs när action = Update image || action = UpdateImage.

Anger URL:en för VHD-avbildningen. Om det är en Azure Storage-blob-URL är lagringskontots plats samma som platsen för skalningsuppsättningen.


customScriptsDirectory - Anpassad skriptkatalog
string. Valfri. Använd när action = Configure application startup || action = Update image || action = UpdateImage.

Valfri. Sökvägen till katalogen som innehåller de anpassade skript som körs med hjälp av tillägget för den virtuella datorn med anpassat skript. Tilläggsmetoden är användbar för konfiguration efter distribution, program-/programvaruinstallation eller någon annan programkonfigurations-/hanteringsuppgift. Skriptet kan till exempel ange en miljövariabel på datornivå som programmet använder, till exempel databasanslutningssträngar.


customScript - kommando
string. Valfri. Använd när action = Configure application startup || action = Update image || action = UpdateImage.

Valfri. Skriptet som körs med hjälp av tillägget för den virtuella datorn med anpassat skript. Det här skriptet kan anropa andra skript i katalogen och anropas med de argument som skickas nedan.
Tillsammans med sådana argument kan det här skriptet användas för att köra kommandon.

Till exempel:

  1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd) uppdaterar anslutningssträngen i web.config för webbprogrammet.
  2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey skapar en krypterad fil som innehåller en nyckel för tjänstens huvudnamn.

customScriptArguments - argument
string. Valfri. Använd när action = Configure application startup || action = Update image || action = UpdateImage.

Valfri. Det anpassade skriptet anropas med argument som skickas. Du kan använda versionsvariabler, vilket gör det enkelt att använda hemligheter.


customScriptsStorageAccount - Azure Storage-konto där anpassade skript laddas upp
string. Valfri. Använd när action = Configure application startup || action = Update image || action = UpdateImage.

Valfri. Tillägget för anpassat skript laddar ned och kör de angivna skripten på varje virtuell dator i VM-skalningsuppsättningen. Dessa skript lagras i det befintliga ARM-lagringskontot som anges här.


skipArchivingCustomScripts - Hoppa över arkivering av anpassade skript
boolean. Standardvärde: false.

Valfri. Som standard skapar den här uppgiften ett komprimerat arkiv för katalogen som innehåller de anpassade skripten. Detta förbättrar prestanda och tillförlitlighet vid uppladdning till Azure Storage. Om det inte är markerat kommer arkivering inte att göras och alla filer laddas upp individuellt.


Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften för att distribuera en vm-skalningsuppsättningsbild.

Skriptkörningen rapporteras som lyckad, men VMSS-instanserna uppdateras inte

Skalningsuppsättningar har en uppgraderingsprincip som avgör hur virtuella datorer tas med up-to-date med den senaste skalningsuppsättningsmodellen, och om uppgraderingsprincipen är inställd på manuell måste du uppgradera varje virtuell dator manuellt. Mer information finns i How to bring VMs up-to-date with the latest scale set model. Du kan ändra uppdateringsprincipen eller uppgradera varje virtuell dator manuellt. Om du till exempel vill uppgradera principen till Automaticanvänder du följande Az CLI-kommando: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Fel: "Behörighet nekad: Skriptet kan inte köras"

Det här problemet uppstår om du försöker köra ett anpassat skript, men skriptet kan inte köras.

Lös problemet genom att först se till att customScript indata inte har ./ eller något annat innan skriptnamnet 'test.sh':

    customScript: 'test.sh'

Försök sedan att lägga till en kommandoradsaktivitet före vm-skalningsuppsättningsaktiviteten:

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

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Någon
variabler som kan Någon
Agentversion 2.209.0 eller senare
Aktivitetskategori Gruppera
Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Någon
variabler som kan Någon
Agentversion 2.0.0 eller senare
Aktivitetskategori Gruppera