az image builder

Verwalten und Erstellen von Bild-Generatorvorlagen.

Befehle

az image builder cancel

Abbrechen des langfristig ausgeführten Bildbuilds basierend auf der Bildvorlage.

az image builder create

Erstellen Sie eine Bild-Generatorvorlage.

az image builder customizer

Image Builder-Vorlagenanpassung verwalten.

az image builder customizer add

Fügen Sie einem Bild-Generator-Anpassungsgeber eine Bild-Generatorvorlage hinzu.

az image builder customizer clear

Entfernen Sie alle Bild-Generator-Anpassungen aus einer Bild-Generatorvorlage.

az image builder customizer remove

Entfernen Sie einen Bild-Generator-Customizer aus einer Bild-Generatorvorlage.

az image builder delete

Bild-Generatorvorlage löschen.

az image builder list

Listenbild-Generatorvorlagen.

az image builder output

Image Builder-Vorlagenausgabeverteiler verwalten.

az image builder output add

Fügen Sie einen Ausgabeverteiler eines Bild-Generators zu einer Bild-Generator-Vorlage hinzu.

az image builder output clear

Entfernen Sie alle Ausgabeverteiler des Bild-Generators aus einer Bild-Generator-Vorlage.

az image builder output remove

Entfernen Sie einen Ausgabeverteiler eines Bild-Generators aus einer Bild-Generatorvorlage.

az image builder run

Erstellen Sie eine Bild-Generatorvorlage.

az image builder show

Zeigen Sie eine Bild-Generatorvorlage an.

az image builder show-runs

Zeigen Sie die Ausführungsausgabe einer Bild-Generatorvorlage an.

az image builder update

Aktualisieren einer Bild-Generatorvorlage.

az image builder validator

Verwalten der Vorlagenvorlage für den Bild-Generator.

az image builder validator add

Fügen Sie eine vorhandene Bild-Generatorvorlage hinzu.

az image builder validator remove

Entfernen Sie die Überprüfung aus einer vorhandenen Bild-Generatorvorlage.

az image builder validator show

Zeigen Sie die Überprüfung einer vorhandenen Bild-Generatorvorlage an.

az image builder wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist.

az image builder cancel

Abbrechen des langfristig ausgeführten Bildbuilds basierend auf der Bildvorlage.

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

Beispiele

Abbrechen eines Bildbuilds.

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

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name der Bildvorlage.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az image builder create

Erstellen Sie eine Bild-Generatorvorlage.

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]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--vm-size]
                        [--vnet]

Beispiele

Erstellen Sie eine Image-Generatorvorlage aus einem UbuntuLTS 18.04-Bild. Verteilen Sie es als verwaltetes Bild und eine freigegebene Bildkatalogversion. Geben Sie die Id der Bereitstellungsressourcengruppe als Bildvorlage an, die zum Erstellen des Bilds verwendet wird.

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 myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Erstellen Sie eine Bild-Generatorvorlage mithilfe einer Bildvorlagendatei.

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

[Erweitert] Erstellen Sie eine Bildvorlage mit mehreren Anpassbaren und Vertriebspartnern mithilfe des CLI-Objektcaches über --defer. Unterstützt Features wie: Anpassungs- und Ausgabenamen, PowerShell-Exitcodes, Inlineskripts, Windows Neustart, Dateianpassungen, Artefaktetags und Vhd-Ausgabeverteiler.

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 myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --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 myGroup \
    --customizer-name myFileCustomizer --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 myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --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 myGroup

Erforderliche Parameter

--name -n

Der Name der Bildvorlage.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--build-timeout

Die maximale Dauer zum Warten beim Erstellen der Bildvorlage in Minuten. Der Standardwert ist 60.

--build-vm-identities

Optionale Konfiguration des virtuellen Netzwerks, mit dem der Build-virtuelle Computer bereitgestellt werden soll. Lassen Sie diese Angabe aus, wenn kein bestimmtes virtuelles Netzwerk verwendet werden muss.

--checksum

Die SHA256-Prüfsumme des Red Hat ISO-Bilds.

--defer

Speichert das Objekt temporär im lokalen Cache, anstatt es an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.

--identity

Liste der vom Benutzer zugewiesenen Identitäten (Name oder ID, Leerzeichen getrennt) der Bildvorlage.

--image-source -i

Das Basisbild, das angepasst werden soll. Muss ein gültiges Plattformimage-URN, Plattformimage-Alias, Red Hat ISO-Image-URI, verwalteter Bildname/ID oder freigegebene Imageversions-ID sein.

Wert aus: az vm image list, az vm image show
--image-template

Lokaler Pfad oder URL zu einer Bildvorlagendatei. Wenn Sie --image-vorlage verwenden, werden alle anderen Parameter außer -g und -n ignoriert. Referenz: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--managed-image-destinations

Informationen zur verwalteten Bildausgabe. Leerzeichentrennte Liste der Schlüsselwertpaare. Z. B. "image_1=westus2 image_2=westus". Jeder Schlüssel ist der Name oder die Ressourcen-ID des verwalteten Bilds, das erstellt werden soll. Jeder Wert ist die Position des Bilds.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--os-disk-size

Größe des Betriebssystemdatenträgers in GB. Lassen Sie die Standarddatenträgergröße von Azure aus oder geben Sie 0 an, um die Standarddatenträgergröße von Azure zu verwenden.

--proxy-vm-size

Größe des virtuellen Computers, der zum Erstellen, Anpassen und Erfassen von Bildern verwendet wird (Standard_D1_v2 für Gen1-Bilder und Standard_D2ds_v4 für Gen2-Bilder).

--scripts

Leergetrennte Liste der Shell- oder PowerShell-Skripts zum Anpassen des Bilds mit. Jedes Skript muss eine öffentlich zugängliche URL sein. Leitet den Skripttyp aus der Dateierweiterung (.sh' oder '.ps1') oder vom Quelltyp aus. Weitere Anpassungsoptionen und Flexibilität finden Sie unter "az image template customizer add".

--shared-image-destinations

Informationen zu freigegebenen Bildkatalogen (sig) ausgabeverteilerinformationen. Leerzeichentrennte Liste der Schlüsselwertpaare. Z. B. "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth". Jeder Schlüssel ist die Sig-Bilddefinitions-ID oder der Sig-Katalogname und die Sig-Bilddefinition, die durch ein "/" getrennt ist. Jeder Wert ist eine durch Komma getrennte Liste der Replikatspeicherorte.

--staging-resource-group

Die Gruppen-ID der Stagingressourcen in demselben Abonnement wie die Bildvorlage, die zum Erstellen des Bilds verwendet wird.

--subnet

Name oder ID des Subnetzs, um den virtuellen Buildcomputer bereitzustellen.

--tags

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--vm-size

Größe des virtuellen Computers, der zum Erstellen, Anpassen und Erfassen von Bildern verwendet wird. Geben Sie leere Zeichenfolge aus, um die Standardeinstellung (Standard_D1_v2) zu verwenden.

--vnet

Name des VNET zum Bereitstellen des virtuellen Buildcomputers. Sie sollten ihn nur angeben, wenn Subnetz ein Name ist.

az image builder delete

Bild-Generatorvorlage löschen.

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

Beispiele

Bild-Generatorvorlage löschen. (automatisch generiert)

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

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name der Bildvorlage.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az image builder list

Listenbild-Generatorvorlagen.

az image builder list [--resource-group]

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az image builder run

Erstellen Sie eine Bild-Generatorvorlage.

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

Beispiele

Starten Sie einen Vorlagenbuild, und warten Sie dann, bis sie abgeschlossen ist.

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

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name der Bildvorlage.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az image builder show

Zeigen Sie eine Bild-Generatorvorlage an.

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

Beispiele

Anzeigen einer Bild-Generatorvorlage (automatisch generiert)

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

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name der Bildvorlage.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az image builder show-runs

Zeigen Sie die Ausführungsausgabe einer Bild-Generatorvorlage an.

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

Beispiele

Führen Sie eine Vorlagenerstellung aus, und zeigen Sie dann die Ausführungsausgabe an.

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

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name der Bildvorlage.

--output-name

Name der Ausgabe des Bild-Generators.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az image builder update

Aktualisieren einer Bild-Generatorvorlage.

Das Aktualisieren einer Bild-Generatorvorlagen wird derzeit nicht unterstützt. Dieser Befehl kann in Verbindung mit --Defer verwendet werden, um ein Bildvorlagenobjekt im CLI-Cache zu aktualisieren. Ohne --Defer ruft sie die angegebene Bildvorlage aus dem Cache ab und sendet eine Anforderung an Azure, um die Bildvorlage zu erstellen.

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

Beispiele

Erstellen Sie eine Vorlagenressource aus einem Vorlagenobjekt im Cli-Cache.

# 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

Optionale Parameter

--add

Fügen Sie einem Objekt eine Liste von Objekten hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--defer

Speichert das Objekt temporär im lokalen Cache, anstatt es an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name der Bildvorlage.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.

az image builder wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist.

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

Beispiele

Starten Sie einen Vorlagenbuild, und warten Sie dann, bis sie abgeschlossen ist.

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

Optionale Parameter

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--name -n

Der Name der Bildvorlage.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter "Erfolgreich" aktualisiert wurde.