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ého Azure
Vstupní alias: ConnectedServiceName
.
string
. Požadovaný.
Určuje předplatné Azure Resource Manageru pro škálovací sadu.
action
-
akce
string
. Požadovaný. Povolené hodnoty: Update image
(aktualizace škálovací sady virtuálních počítačů pomocí image), Configure application startup
(spuštění rozšíření vlastních skriptů ve škálovací sadě virtuálních počítačů). Výchozí hodnota: Update image
.
Aktualizuje š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. Pokud byla škálovací sada virtuálních počítačů vytvořená pomocí image platformy nebo galerie dostupná v Azure, aktualizace selže.
přístup rozšíření vlastních skriptů virtuálních počítačů je užitečný pro konfiguraci po nasazení, instalaci softwaru nebo jakoukoli jinou úlohu konfigurace/správy. Pro škálovací sadu virtuálních počítačů vytvořených pomocí vlastní image nebo image galerie je možné použít přístup rozšíření vlastních skriptů virtuálních počítačů.
vmssName
-
název škálovací sady virtuálních počítačů
string
. Požadovaný.
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
. Požadovaný. 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
. Požadováno při 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
. Volitelný. Používá se při action = Configure application startup || action = Update image || action = UpdateImage
.
Volitelný. Cesta k adresáři obsahujícímu vlastní skripty, které se spouští pomocí rozšíření virtuálního počítače vlastních skriptů. Přístup rozšíření je užitečný pro konfiguraci po nasazení, instalaci aplikace nebo softwaru nebo 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
-
command
string
. Volitelný. Používá se při action = Configure application startup || action = Update image || action = UpdateImage
.
Volitelný. Skript, který se spouští pomocí rozšíření virtuálního počítače s vlastním skriptem. Tento skript může vyvolat další skripty v adresáři a je vyvolán s argumenty předanými níže.
Ve spojení s těmito argumenty lze tento skript použít ke spouštění příkazů.
Například:
-
Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd)
aktualizuje připojovací řetězec vweb.config
webové aplikace. -
install-secrets.sh --key-vault-type prod -key serviceprincipalkey
vytvoří šifrovaný soubor obsahující klíč instančního objektu.
argumentů
string
. Volitelný. Používá se při action = Configure application startup || action = Update image || action = UpdateImage
.
Volitelný. Vlastní skript bude vyvolán s předanými argumenty. Můžete použít proměnné sestavení/verze, které usnadňují používání tajných kódů.
customScriptsStorageAccount
-
účtu úložiště Azure, kde se vlastní skripty nahrají
string
. Volitelný. Používá se při action = Configure application startup || action = Update image || action = UpdateImage
.
Volitelný. 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 budou uloženy v předem existujícím účtu úložiště ARM, který je zde uvedený.
skipArchivingCustomScripts
-
přeskočit archivaci vlastních skriptů
boolean
. Výchozí hodnota: false
.
Volitelný. Ve výchozím nastavení tato úloha vytvoří komprimovaný archiv adresáře obsahujícího vlastní skripty. Tím se zvýší výkon a spolehlivost při nahrávání do úložiště Azure. Pokud není vybraná, archivace se neukončí a všechny soubory se nahrají jednotlivě.
Možnosti řízení úkolů
Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.
Výstupní proměnné
Žádný.
Poznámky
Pomocí této úlohy nasaďte image škálovací sady virtuálních počítačů.
Spuštění skriptu je hlášeno jako úspěšné, ale instance VMSS se neaktualizují.
Škálovací sady mají zásadu upgradu, která určuje, jak se virtuální počítače přenesou up-to– datum s nejnovějším modelem škálovací sady a pokud je zásada upgradu nastavená na ruční upgrade, musíte každý virtuální počítač upgradovat ručně. Další informace najdete v tématu Jak přenést virtuální počítače up-to-date s nejnovějším modelem škálovací sady. Zásady aktualizace můžete změnit nebo ručně upgradovat každý virtuální počítač. Pokud například chcete zásadu upgradovat 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 vstupní customScript
nemá ./
nebo nic jiného před názvem skriptu 'test.sh'
:
customScript: 'test.sh'
Dále zkuste před úlohu škálovací sady virtuálních počítačů přidat úlohu příkazového řádku:
- task: CmdLine@2
inputs:
script: 'chmod 777 $(System.DefaultWorkingDirectory)/test.sh'
Požadavky
Požadavek | Popis |
---|---|
Typy kanálů | YAML, klasické sestavení, 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ů | Jakýkoliv |
nastavitelné proměnné | Jakýkoliv |
Verze agenta | 2.209.0 nebo novější |
Kategorie úkolu | Nasadit |
Požadavek | Popis |
---|---|
Typy kanálů | YAML, klasické sestavení, 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ů | Jakýkoliv |
nastavitelné proměnné | Jakýkoliv |
Verze agenta | 2.0.0 nebo vyšší |
Kategorie úkolu | Nasadit |