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.

Dane wejściowe

azureSubscription - Subskrypcja platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane.

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

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

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

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 innych zadań konfiguracji/zarządzania. W przypadku zestawu skalowania maszyn wirtualnych utworzonego przy użyciu obrazu niestandardowego lub obrazu platformy/galerii można użyć niestandardowego rozszerzenia maszyny wirtualnej skryptu.

vmssName - Nazwa zestawu skalowania maszyn wirtualnych
string. Wymagane.

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

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

Określa typ systemu operacyjnego zestawu skalowania maszyn wirtualnych.

imageUrl - Adres URL obrazu
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 - Katalog skryptów niestandardowych
string. Opcjonalny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Opcjonalny. Ścieżka do katalogu zawierającego skrypty niestandardowe uruchamiane przy użyciu rozszerzenia niestandardowego skryptu maszyny wirtualnej. Takie podejście jest przydatne w przypadku konfiguracji po wdrożeniu, instalacji aplikacji/oprogramowania lub innych zadań 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. Opcjonalny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Opcjonalny. 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. Opcjonalny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Opcjonalny. Skrypt niestandardowy zostanie wywołany z przekazanymi argumentami. Można używać 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. Opcjonalny. Użyj polecenia , gdy action = Configure application startup || action = Update image || action = UpdateImage.

Opcjonalny. 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 tutaj.

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

Opcjonalny. 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 zadania

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

Zmienne wyjściowe

Brak.

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 zestawu skalowania maszyn wirtualnych nie są aktualizowane

Zestawy skalowania mają zasady uaktualniania, które określają, w jaki sposób maszyny wirtualne są uaktualniane przy użyciu najnowszego modelu 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 (Jak zapewnić aktualną wersję maszyn wirtualnych przy użyciu najnowszego modelu zestawu skalowania). Możesz zmienić zasady aktualizacji lub ręcznie uaktualnić każdą maszynę wirtualną. Aby na przykład uaktualnić zasady do Automaticpolecenia , użyj następującego polecenia interfejsu wiersza polecenia az: 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 próbujesz uruchomić skrypt niestandardowy, ale skrypt nie jest wykonywalny.

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

    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 w	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	2.0.0 lub nowsza
Kategoria zadania	Wdrażanie