Sdílet prostřednictvím


AzureVmssDeployment@0 – Úloha nasazení škálovací sady virtuálních počítačů Azure v0

Tato úloha nasadí image škálovací sady virtuálních počítačů.

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.

Vstupy

azureSubscription - Předplatné Azure
Alias vstupu: ConnectedServiceName. string. Povinná hodnota.

Určuje předplatné Azure Resource Manager pro škálovací sadu.


action - Akce
string. Povinná hodnota. Povolené hodnoty: Update image (Aktualizujte škálovací sadu virtuálních počítačů pomocí image) Configure application startup (Spuštění rozšíření virtuálního počítače s vlastním skriptem ve škálovací sadě virtuálních počítačů). Výchozí hodnota: Update image.

Aktualizace škálovací sadu virtuálních počítačů zvolenou metodou pomocí image virtuálního pevného disku nebo spuštěním skriptů nasazení/instalace pomocí rozšíření virtuálního počítače vlastních skriptů.

Přístup k imagi virtuálního pevného disku je lepší pro rychlé škálování a vrácení zpět. Když je škálovací sada virtuálních počítačů vytvořená pomocí vlastní image, může ji aktualizovat image virtuálního pevného disku. Aktualizace selže, pokud se škálovací sada virtuálních počítačů vytvořila pomocí image platformy nebo galerie dostupné v Azure.

Přístup s rozšířením virtuálních počítačů vlastních skriptů je užitečný pro konfiguraci po nasazení, instalaci softwaru nebo jakoukoli jinou úlohu konfigurace nebo správy. Pro škálovací sadu virtuálních počítačů vytvořenou pomocí vlastní image nebo image platformy nebo galerie je možné použít rozšíření virtuálního počítače s vlastními skripty.


vmssName - Název škálovací sady virtuálních počítačů
string. Povinná hodnota.

Určuje název nastavení škálování virtuálního počítače, které se má aktualizovat. Použijte image virtuálního pevného disku nebo rozšíření virtuálního počítače s vlastním skriptem.


vmssOsType - Typ operačního systému
string. Povinná hodnota. Povolené hodnoty: Windows, Linux.

Určuje typ operačního systému škálovací sady virtuálních počítačů.


imageUrl - Adresa URL obrázku
string. Vyžaduje se, když action = Update image || action = UpdateImage.

Určuje adresu URL image virtuálního pevného disku. Pokud se jedná o adresu URL objektu blob úložiště Azure, umístění účtu úložiště je stejné jako umístění škálovací sady.


customScriptsDirectory - Adresář vlastních skriptů
string. Nepovinný parametr. Použijte, když action = Configure application startup || action = Update image || action = UpdateImage.

Nepovinný parametr. Cesta k adresáři obsahujícímu vlastní skripty, které se spouští pomocí rozšíření vlastních skriptů virtuálního počítače. Tento přístup je užitečný pro konfiguraci po nasazení, instalaci aplikací nebo softwaru nebo pro jakoukoli jinou úlohu konfigurace nebo správy aplikací. Skript může například nastavit proměnnou prostředí na úrovni počítače, kterou aplikace používá, například připojovací řetězce databáze.


customScript - Příkaz
string. Nepovinný parametr. Použijte, když action = Configure application startup || action = Update image || action = UpdateImage.

Nepovinný parametr. Skript, který se spouští pomocí rozšíření virtuálního počítače s vlastním skriptem. Tento skript může volat další skripty v adresáři a je vyvolán s následujícími argumenty.
Ve spojení s těmito argumenty lze tento skript použít ke spouštění příkazů.

Příklad:

  1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd)aktualizuje připojovací řetězec webové web.config aplikace.
  2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey vytvoří šifrovaný soubor obsahující klíč instančního objektu.

customScriptArguments - Argumenty
string. Nepovinný parametr. Použijte, když action = Configure application startup || action = Update image || action = UpdateImage.

Nepovinný parametr. Vlastní skript se vyvolá s předanými argumenty. Je možné použít proměnné sestavení a verze, což usnadňuje použití tajných kódů.


customScriptsStorageAccount - Účet úložiště Azure, do kterého se nahrají vlastní skripty
string. Nepovinný parametr. Použijte, když action = Configure application startup || action = Update image || action = UpdateImage.

Nepovinný parametr. Rozšíření vlastních skriptů stáhne a spustí poskytnuté skripty na každém virtuálním počítači ve škálovací sadě virtuálních počítačů. Tyto skripty se budou ukládat v předem existujícím účtu úložiště ARM, který je tady uvedený.


skipArchivingCustomScripts - Přeskočit archivaci vlastních skriptů
boolean. Výchozí hodnota: false.

Nepovinný parametr. Ve výchozím nastavení tato úloha vytvoří komprimovaný archiv adresáře obsahujícího vlastní skripty. To zvyšuje výkon a spolehlivost při nahrávání do úložiště Azure. Pokud není vybraná, archivace se neprovedou a všechny soubory se nahrají jednotlivě.


Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte k nasazení image škálovací sady virtuálních počítačů.

Spuštění skriptu se hlásí jako úspěšné, ale instance škálovací sady virtuálních počítačů se neaktualizují.

Škálovací sady mají zásady upgradu, které určují, jak se virtuální počítače aktualizují pomocí nejnovějšího modelu škálovací sady, a pokud jsou zásady upgradu nastavené na ruční, musíte každý virtuální počítač upgradovat ručně. Další informace najdete v tématu Jak aktualizovat virtuální počítače pomocí nejnovějšího modelu škálovací sady. Můžete změnit zásady aktualizací nebo ručně upgradovat jednotlivé virtuální počítače. Pokud například chcete upgradovat zásadu na Automatic, použijte následující příkaz Az CLI: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Chyba: Oprávnění odepřeno: Skript není spustitelný

K tomuto problému dochází, pokud se pokusíte spustit vlastní skript, ale skript není spustitelný.

Pokud chcete tento problém vyřešit, nejprve se ujistěte, že customScript vstup nemá ./ před názvem 'test.sh'skriptu ani nic jiného:

    customScript: 'test.sh'

Dále zkuste přidat úlohu příkazového řádku před úlohu škálovací sady virtuálních počítačů:

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

Požadavky

Požadavek Popis
Typy kanálů YAML, klasický build, klasická verze
Běží na Agent, DeploymentGroup
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.0.0 nebo vyšší
Kategorie úloh Nasazení