az image builder

Odwołanie

Zarządzanie szablonami konstruktora obrazów i tworzenie ich.

Polecenia

az image builder cancel	Anuluj długotrwałą kompilację obrazu na podstawie szablonu obrazu.
az image builder create	Utwórz szablon konstruktora obrazów.
az image builder customizer	Zarządzanie konfiguratorami szablonów konstruktora obrazów.
az image builder customizer add	Dodaj konfigurator konstruktora obrazów do szablonu konstruktora obrazów.
az image builder customizer clear	Usuń wszystkie konfiguratory konstruktora obrazów z szablonu konstruktora obrazów.
az image builder customizer remove	Usuń konfigurator konstruktora obrazów z szablonu konstruktora obrazów.
az image builder delete	Usuń szablon konstruktora obrazów.
az image builder list	Wyświetlanie listy szablonów konstruktora obrazów.
az image builder output	Zarządzanie dystrybutorami wyjściowymi szablonu konstruktora obrazów.
az image builder output add	Dodaj dystrybutora danych wyjściowych konstruktora obrazów do szablonu konstruktora obrazów.
az image builder output clear	Usuń wszystkich dystrybutorów wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.
az image builder output remove	Usuń dystrybutora danych wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.
az image builder run	Tworzenie szablonu konstruktora obrazów.
az image builder show	Pokaż szablon konstruktora obrazów.
az image builder show-runs	Pokaż dane wyjściowe uruchamiania szablonu konstruktora obrazów.
az image builder update	Aktualizowanie szablonu konstruktora obrazów.
az image builder wait	Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku szablonu.

az image builder cancel

Anuluj długotrwałą kompilację obrazu na podstawie szablonu obrazu.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]

Przykłady

Anulowanie kompilacji obrazu.

az image builder cancel -n mytemplate -g my-group

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien on być kompletnym identyfikatorem zasobu zawierającym wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder create

Utwórz szablon konstruktora obrazów.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--subnet]
                        [--tags]
                        [--vm-size]
                        [--vnet]

Przykłady

Utwórz szablon konstruktora obrazów na podstawie obrazu UbuntuLTS 18.04. Dystrybuowanie go jako obrazu zarządzanego i wersji obrazu galerii obrazów udostępnionych

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:UbuntuServer:18.04-LTS:18.04.201903060"

az image builder create --image-source $imagesource -n mytemplate -g my-group \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myidentity

Utwórz szablon konstruktora obrazów przy użyciu pliku szablonu obrazu.

az image builder create -g my-group -n mytemplate --image-template filename

[Zaawansowane] Utwórz szablon obrazu z wieloma konfiguratorami i dystrybutorami przy użyciu pamięci podręcznej obiektów interfejsu wiersza polecenia za pośrednictwem funkcji --defer. Obsługuje funkcje, takie jak: konfigurator i nazwy wyjściowe, kody zakończenia programu PowerShell, skrypty wbudowane, ponowne uruchomienie systemu Windows, konfiguratory plików, tagi artefaktów i dystrybutorów danych wyjściowych wirtualnego dysku twardego.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n mytemplate \
    -g my-group --scripts $script --identity myidentity --defer

# add customizers
az image builder customizer add -n mytemplate -g my-group  \
    --customizer-name my-pwsh-script --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n mytemplate -g my-group \
    --customizer-name my-file-customizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n mytemplate -g my-group --is-vhd \
    --output-name my-win-image-vhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n mytemplate -g my-group \
    --output-name my-win-image-managed --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n mytemplate -g my-group

Parametry wymagane

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--build-timeout

Maksymalny czas trwania oczekiwania podczas kompilowania szablonu obrazu w minutach. Wartość domyślna to 60.

--build-vm-identities

Opcjonalna konfiguracja sieci wirtualnej do użycia w celu wdrożenia maszyny wirtualnej kompilacji. Pomiń, jeśli nie trzeba używać określonej sieci wirtualnej.

--checksum

Suma kontrolna SHA256 obrazu ISO systemu Red Hat.

--defer

Tymczasowo przechowuj obiekt w lokalnej pamięci podręcznej zamiast wysyłania na platformę Azure. Użyj az cache poleceń, aby wyświetlić/wyczyścić.

--identity

Lista tożsamości przypisanych przez użytkownika (nazwa lub identyfikator, spacja rozdzielana) szablonu obrazu.

--image-source -i

Obraz podstawowy do dostosowania. Musi być prawidłowym identyfikatorem URI obrazu platformy, aliasem obrazu platformy, identyfikatorem URI obrazu ISO systemu Red Hat, nazwą/identyfikatorem obrazu zarządzanego lub identyfikatorem wersji obrazu udostępnionego.

wartość od: az vm image list, az vm image show

--image-template

Ścieżka lokalna lub adres URL do pliku szablonu obrazu. W przypadku korzystania z --image-template wszystkie inne parametry są ignorowane z wyjątkiem -g i -n. Dokumentacja: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--managed-image-destinations

Informacje o dystrybutorze danych wyjściowych obrazu zarządzanego. Rozdzielona spacjami lista par klucz-wartość. Np. "image_1=westus2 image_2=westus". Każdy klucz jest nazwą lub identyfikatorem zasobu obrazu zarządzanego do utworzenia. Każda wartość to lokalizacja obrazu.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

--os-disk-size

Rozmiar dysku systemu operacyjnego w GB. Pomiń lub określ wartość 0, aby użyć domyślnego rozmiaru dysku systemu operacyjnego platformy Azure.

--proxy-vm-size

Rozmiar maszyny wirtualnej używanej do kompilowania, dostosowywania i przechwytywania obrazów (Standard_D1_v2 dla obrazów gen1 i Standard_D2ds_v4 obrazów gen2).

--scripts

Rozdzielona spacjami lista skryptów powłoki lub programu PowerShell w celu dostosowania obrazu za pomocą polecenia . Każdy skrypt musi być publicznie dostępnym adresem URL. Wnioskowa typ skryptu z rozszerzenia pliku (.sh' lub'.ps1') lub typu źródłowego. Więcej opcji i elastyczności konfiguratora można znaleźć w temacie" "az image template customizer add".

--shared-image-destinations

Informacje o dystrybutorze danych wyjściowych z galerii obrazów udostępnionych (sig). Rozdzielona spacjami lista par klucz-wartość. Np. "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth". Każdy klucz to sig image definition ID lub sig gallery name i sig image definition delimited przez "/". Każda wartość jest rozdzielaną przecinkami listą lokalizacji replik.

--subnet

Nazwa lub identyfikator podsieci w celu wdrożenia maszyny wirtualnej kompilacji.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--vm-size

Rozmiar maszyny wirtualnej używanej do tworzenia, dostosowywania i przechwytywania obrazów. Pomiń lub określ pusty ciąg, aby użyć wartości domyślnej (Standard_D1_v2).

--vnet

Nazwa sieci wirtualnej do wdrożenia maszyny wirtualnej kompilacji. Należy określić ją tylko wtedy, gdy podsieć jest nazwą.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder delete

Usuń szablon konstruktora obrazów.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]

Przykłady

Usuń szablon konstruktora obrazów. (automatycznie wygenerowane)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

Parametry opcjonalne

--ids

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder list

Wyświetlanie listy szablonów konstruktora obrazów.

az image builder list [--resource-group]

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder run

Tworzenie szablonu konstruktora obrazów.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]

Przykłady

Uruchom uruchomienie kompilacji szablonu, a następnie poczekaj na jego zakończenie.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='running'"

az image builder show -n mytemplate -g my-group

Parametry opcjonalne

--ids

--name -n

Nazwa szablonu obrazu.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder show

Pokaż szablon konstruktora obrazów.

az image builder show [--ids]
                      [--name]
                      [--resource-group]

Przykłady

Pokaż szablon konstruktora obrazów (wygenerowany automatycznie)

az image builder show --name mytemplate  --resource-group my-group

Parametry opcjonalne

--ids

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder show-runs

Pokaż dane wyjściowe uruchamiania szablonu konstruktora obrazów.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]

Przykłady

Uruchom przebieg kompilacji szablonu, a następnie wyświetl jego dane wyjściowe przebiegu.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='running'"

az image builder show-runs -n mytemplate -g my-group

Parametry opcjonalne

--ids

--name -n

Nazwa szablonu obrazu.

--output-name

Nazwa uruchomienia danych wyjściowych konstruktora obrazów.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder update

Aktualizowanie szablonu konstruktora obrazów.

Aktualizowanie szablonów konstruktora obrazów jest obecnie nieobsługiwane. To polecenie może służyć w połączeniu z --defer do aktualizowania obiektu szablonu obrazu w pamięci podręcznej interfejsu wiersza polecenia. Bez parametru — odroczy pobiera określony szablon obrazu z pamięci podręcznej i wysyła żądanie do platformy Azure w celu utworzenia szablonu obrazu.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]

Przykłady

Utwórz zasób szablonu na podstawie obiektu szablonu w pamięci podręcznej interfejsu wiersza polecenia.

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string lub JSON string>.

--defer

Tymczasowo przechowuj obiekt w lokalnej pamięci podręcznej zamiast wysyłania na platformę Azure. Użyj az cache poleceń, aby wyświetlić/wyczyścić.

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować przekonwertować na kod JSON.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.

az image builder wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku szablonu.

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--timeout]
                      [--updated]

Przykłady

Uruchom uruchomienie kompilacji szablonu, a następnie poczekaj na zakończenie.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='running'"

az image builder show -n mytemplate -g my-group

Parametry opcjonalne

--created

Zaczekaj na utworzenie polecenia "provisioningState" w lokalizacji "Powodzenie".

--custom

Zaczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Na przykład provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Zaczekaj na usunięcie.

--exists

Zaczekaj, aż zasób istnieje.

--ids

--interval

Interwał sondowania w sekundach.

wartość domyślna: 30

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600

--updated

Zaczekaj na aktualizację za pomocą parametru provisioningState w lokalizacji "Powodzenie".

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.