AzureVmssDeployment@0 — zadanie wdrażania zestawu skalowania maszyn wirtualnych platformy Azure w wersji 0

To zadanie służy do wdrażania obrazu zestawu skalowania maszyn wirtualnych.

Składnia

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

Wejścia

subskrypcji platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane.

Określa subskrypcję usługi Azure Resource Manager dla zestawu skalowania.

action - akcja
string. Wymagane. Dozwolone wartości: Update image (Aktualizowanie zestawu skalowania maszyn wirtualnych przy użyciu obrazu), Configure application startup (Uruchamianie rozszerzenia niestandardowego skryptu maszyny wirtualnej w zestawie skalowania maszyn wirtualnych maszyn wirtualnych). Wartość domyślna: Update image.

Aktualizuje zestaw skalowania maszyn wirtualnych według wybranej metody przy użyciu obrazu wirtualnego dysku twardego i/lub uruchamiając skrypty wdrażania/instalacji przy użyciu rozszerzenia maszyny wirtualnej niestandardowego skryptu.

Podejście do obrazu wirtualnego dysku twardego jest lepsze do szybkiego skalowania i wycofywania. Po utworzeniu zestawu skalowania maszyn wirtualnych przy użyciu obrazu niestandardowego można go zaktualizować przy użyciu obrazu wirtualnego dysku twardego. Aktualizacja zakończy się niepowodzeniem, jeśli zestaw skalowania maszyn wirtualnych został utworzony przy użyciu obrazu platformy/galerii dostępnego na platformie Azure.

podejście rozszerzenia maszyny wirtualnej niestandardowego skryptu jest przydatne w przypadku konfiguracji po wdrożeniu, instalacji oprogramowania lub dowolnego innego zadania konfiguracji/zarządzania. Niestandardowe podejście rozszerzenia maszyny wirtualnej skryptu można użyć dla zestawu skalowania maszyn wirtualnych utworzonego przy użyciu obrazu niestandardowego lub obrazu platformy/galerii.

nazwa zestawu skalowania maszyn wirtualnych vmssName -
string. Wymagane.

Określa nazwę ustawienia skalowania maszyn wirtualnych do zaktualizowania. Użyj obrazu wirtualnego dysku twardego lub rozszerzenia niestandardowego skryptu maszyny wirtualnej.

vmssOsType - typ systemu operacyjnego
string. Wymagane. Dozwolone wartości: Windows, Linux.

Określa typ systemu operacyjnego zestawu skalowania maszyn wirtualnych.

adres URL obrazu imageUrl -
string. Wymagane, gdy action = Update image || action = UpdateImage.

Określa adres URL obrazu wirtualnego dysku twardego. Jeśli jest to adres URL obiektu blob usługi Azure Storage, lokalizacja konta magazynu jest taka sama jak lokalizacja zestawu skalowania.

customScriptsDirectory - katalogu skryptów niestandardowych
string. Fakultatywny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Fakultatywny. Ścieżka do katalogu zawierającego skrypty niestandardowe, które są uruchamiane przy użyciu rozszerzenia maszyny wirtualnej niestandardowego skryptu. Podejście rozszerzenia jest przydatne w przypadku konfiguracji po wdrożeniu, instalacji aplikacji/oprogramowania lub dowolnego innego zadania konfiguracji/zarządzania aplikacjami. Na przykład skrypt może ustawić zmienną środowiskową na poziomie maszyny, której używa aplikacja, na przykład parametry połączenia bazy danych.

customScript - polecenia
string. Fakultatywny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Fakultatywny. Skrypt uruchamiany przy użyciu rozszerzenia niestandardowego skryptu maszyny wirtualnej. Ten skrypt może wywołać inne skrypty w katalogu i jest wywoływany z argumentami przekazanymi poniżej.
W połączeniu z takimi argumentami ten skrypt może służyć do wykonywania poleceń.

Na przykład:

1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd) aktualizuje parametry połączenia w web.config aplikacji internetowej.
2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey tworzy zaszyfrowany plik zawierający klucz jednostki usługi.

customScriptArguments - argumenty
string. Fakultatywny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Fakultatywny. Skrypt niestandardowy zostanie wywołany z przekazanymi argumentami. Można użyć zmiennych kompilacji/wydania, co ułatwia korzystanie z wpisów tajnych.

customScriptsStorageAccount - konto usługi Azure Storage, na którym zostaną przekazane niestandardowe skrypty
string. Fakultatywny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Fakultatywny. Rozszerzenie niestandardowego skryptu pobiera i wykonuje podane skrypty na każdej maszynie wirtualnej w zestawie skalowania maszyn wirtualnych. Te skrypty będą przechowywane na istniejącym koncie magazynu usługi ARM określonym w tym miejscu.

skipArchivingCustomScripts - pomiń archiwizowanie skryptów niestandardowych
boolean. Wartość domyślna: false.

Fakultatywny. Domyślnie to zadanie tworzy skompresowane archiwum katalogu zawierającego skrypty niestandardowe. Zwiększa to wydajność i niezawodność podczas przekazywania do usługi Azure Storage. Jeśli nie zostanie wybrane, archiwizacja nie zostanie wykonana, a wszystkie pliki zostaną przekazane indywidualnie.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

To zadanie służy do wdrażania obrazu zestawu skalowania maszyn wirtualnych.

Wykonanie skryptu jest zgłaszane jako pomyślne, jednak wystąpienia usługi VMSS nie są aktualizowane

Zestawy skalowania mają zasady uaktualniania, które określają sposób, w jaki maszyny wirtualne są wprowadzane up-to— data z najnowszym modelem zestawu skalowania, a jeśli zasady uaktualniania zostały ustawione na ręczne, należy ręcznie uaktualnić każdą maszynę wirtualną. Aby uzyskać więcej informacji, zobacz How to bring VMs up-to-date with the latest scale set model. Możesz zmienić zasady aktualizacji lub ręcznie uaktualnić każdą maszynę wirtualną. Aby na przykład uaktualnić zasady do Automatic, użyj następującego polecenia az interfejsu wiersza polecenia: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

Błąd: "Odmowa uprawnień: skrypt nie jest wykonywalny"

Ten problem występuje, jeśli spróbujesz uruchomić skrypt niestandardowy, ale skrypt nie jest wykonywalny.

Aby rozwiązać ten problem, najpierw upewnij się, że dane wejściowe customScript nie mają ./ ani żadnych innych elementów przed nazwą skryptu 'test.sh':

    customScript: 'test.sh'

Następnie spróbuj dodać zadanie wiersza polecenia przed zadaniem zestawu skalowania maszyn wirtualnych:

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

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	2.209.0 lub nowsza
Kategoria zadań	Wdrożyć