az image builder

Képszerkesztő-sablonok kezelése és létrehozása.

Parancsok

az image builder cancel	A képsablon alapján szakítsa meg a hosszú ideig futó rendszerkép-összeállítást.
az image builder create	Hozzon létre egy képszerkesztő sablont.
az image builder customizer	Képszerkesztő-sablon testreszabók kezelése.
az image builder customizer add	Képszerkesztő-testreszabó hozzáadása képszerkesztő sablonhoz.
az image builder customizer clear	Távolítsa el az összes képszerkesztő-testreszabót egy képszerkesztő sablonból.
az image builder customizer remove	Képszerkesztő-testreszabó eltávolítása egy képszerkesztő-sablonból.
az image builder delete	Képszerkesztő-sablon törlése.
az image builder list	Képszerkesztő-sablonok listázása.
az image builder output	Képszerkesztő-sablon kimeneti terjesztőinek kezelése.
az image builder output add	Képszerkesztő kimeneti terjesztő hozzáadása képszerkesztő sablonhoz.
az image builder output clear	Távolítsa el az összes képszerkesztő kimeneti terjesztőt egy képszerkesztő sablonból.
az image builder output remove	Képszerkesztő kimeneti terjesztő eltávolítása képszerkesztő sablonból.
az image builder run	Képszerkesztő sablon létrehozása.
az image builder show	Képszerkesztő-sablon megjelenítése.
az image builder show-runs	Képszerkesztő-sablon futtatási kimeneteinek megjelenítése.
az image builder update	Képszerkesztő-sablon frissítése.
az image builder validator	Képszerkesztő-sablon ellenőrzése.
az image builder validator add	Érvényesítés hozzáadása meglévő képszerkesztő sablonhoz.
az image builder validator remove	Érvényesség eltávolítása egy meglévő képszerkesztő sablonból.
az image builder validator show	Meglévő képszerkesztő sablon érvényesítésének megjelenítése.
az image builder wait	Helyezze a parancssori felületet várakozó állapotba, amíg a sablon valamely feltétele nem teljesül.

az image builder cancel

A képsablon alapján szakítsa meg a hosszú ideig futó rendszerkép-összeállítást.

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

Példák

Kép buildelésének megszakítása.

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

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. A --id vagy más "Erőforrás-azonosító" argumentumokat kell megadnia.

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder create

Hozzon létre egy képszerkesztő sablont.

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]

Példák

Képszerkesztő sablon létrehozása UbuntuLTS 18.04-rendszerképből. Terjesztheti felügyelt rendszerképként és megosztott rendszerkép-katalógus képverzióként. Adja meg az átmeneti erőforráscsoport-azonosítót a rendszerkép létrehozásához használni kívánt képsablonként.

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

Képszerkesztő sablon létrehozása képsablonfájllal.

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

[Speciális] Hozzon létre egy képsablont több testreszabóval és terjesztővel a parancssori felület objektum-gyorsítótárának használatával a --defer paranccsal. Olyan funkciókat támogat, mint a testreszabók és a kimeneti nevek, a PowerShell kilépési kódjai, a beágyazott szkriptek, a Windows újraindítása, a fájltestreszabók, az összetevőcímkék és a vhd kimeneti terjesztők.

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

Kötelező paraméterek

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Opcionális paraméterek

--build-timeout

A képsablon létrehozásakor a várakozás maximális időtartama percekben megadva. Az alapértelmezett érték 60.

--build-vm-identities

A virtuális hálózat nem kötelező konfigurációja a virtuális gép buildjének üzembe helyezéséhez. Kihagyás, ha nincs szükség adott virtuális hálózatra.

--checksum

A Red Hat ISO-rendszerkép SHA256 ellenőrzőösszege.

--defer

Ideiglenesen tárolja az objektumot a helyi gyorsítótárban az Azure-ba való küldés helyett. Parancsok használata az cache a megtekintéshez/törléshez.

--identity

A képsablon felhasználóhoz rendelt identitásainak listája (név vagy azonosító, szóközzel tagolt).

--image-source -i

A testre szabandó alaprendszerkép. Érvényes platformrendszerkép-URI-nak, platformrendszerkép-aliasnak, Red Hat ISO-lemezkép URI-jának, felügyelt lemezkép nevének/azonosítójának vagy megosztott lemezkép verzióazonosítójának kell lennie.

érték forrása: az vm image list, az vm image show

--image-template

Képsablonfájl helyi elérési útja vagy URL-címe. A --image-template használatakor a rendszer minden más paramétert figyelmen kívül hagy, kivéve a -g és a -n paramétert. Hivatkozás: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Tartózkodási hely beállításnál. Értékek innen: az account list-locations. Az alapértelmezett helyet a használatával az configure --defaults location=<location>konfigurálhatja.

--managed-image-destinations

A felügyelt lemezképkimenet terjesztői adatai. Kulcs-érték párok szóközzel elválasztott listája. Például: "image_1=westus2 image_2=westus". Minden kulcs a létrehozandó felügyelt rendszerkép neve vagy erőforrás-azonosítója. Minden érték a kép helye.

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

--os-disk-size

Az operációsrendszer-lemez mérete GB-ban. Hagyja ki vagy adja meg a 0 értéket az Azure alapértelmezett operációsrendszer-lemezméretének használatához.

--proxy-vm-size

A rendszerképek létrehozásához, testreszabásához és rögzítéséhez használt virtuális gép mérete (gen1-es és Standard_D2ds_v4 Gen2-rendszerképekhez Standard_D1_v2).

--scripts

A rendszerhéj- vagy PowerShell-szkriptek szóközzel elválasztott listája a kép testreszabásához. Minden szkriptnek nyilvánosan elérhető URL-címnek kell lennie. Fájlkiterjesztésből ('.sh' vagy '.ps1') vagy forrástípusból származó parancsfájltípust következtet. További testreszabási lehetőségek és rugalmasság: "az image template customizer add" (az image template customizer add).

--shared-image-destinations

Megosztott képkatalógus (sig) kimeneti forgalmazói információi. Kulcs-érték párok szóközzel elválasztott listája. Például: "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth." Minden kulcs a sig képdefiníció azonosítója vagy a sig-katalógus neve, valamint a "/" karakterrel tagolt sig képdefiníció. Minden érték a replikahelyek vesszővel tagolt listája.

--staging-resource-group

Az átmeneti erőforráscsoport azonosítója ugyanabban az előfizetésben, mint a rendszerkép létrehozásához használt rendszerképsablon.

--subnet

Az alhálózat neve vagy azonosítója a build virtuális gép üzembe helyezéséhez.

--tags

Szóközzel elválasztott címkék: kulcs[=érték] [kulcs[=érték] ...]. A "" használatával törölheti a meglévő címkéket.

--vm-size

A képek létrehozásához, testreszabásához és rögzítéséhez használt virtuális gép mérete. Az alapértelmezett (Standard_D1_v2) használatához hagyja ki vagy adja meg az üres sztringet.

--vnet

A build virtuális gép üzembe helyezéséhez szükséges virtuális hálózat neve. Csak akkor adja meg, ha az alhálózat név.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder delete

Képszerkesztő-sablon törlése.

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

Példák

Képszerkesztő-sablon törlése. (automatikusan generált)

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

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. A --id vagy más "Erőforrás-azonosító" argumentumokat kell megadnia.

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder list

Képszerkesztő-sablonok listázása.

az image builder list [--resource-group]

Opcionális paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder run

Képszerkesztő sablon létrehozása.

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

Példák

Indítsa el a sablon buildfuttatását, majd várja meg, amíg befejeződik.

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

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. A --id vagy más "Erőforrás-azonosító" argumentumokat kell megadnia.

--name -n

A képsablon neve.

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder show

Képszerkesztő-sablon megjelenítése.

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

Példák

Képszerkesztő-sablon megjelenítése (automatikusan létrehozva)

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

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. A --id vagy más "Erőforrás-azonosító" argumentumokat kell megadnia.

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder show-runs

Képszerkesztő-sablon futtatási kimeneteinek megjelenítése.

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

Példák

Futtasson egy sablon buildfuttatását, majd tekintse meg a futtatási kimeneteket.

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

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. A --id vagy más "Erőforrás-azonosító" argumentumokat kell megadnia.

--name -n

A képsablon neve.

--output-name

A képszerkesztő futtatási kimenetének neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder update

Képszerkesztő-sablon frissítése.

A képszerkesztő-sablonok frissítése jelenleg nem támogatott. Ez a parancs a --defer paranccsal együtt használható egy képsablon-objektum frissítéséhez a CLI-gyorsítótárban. Halasztás nélkül lekéri a megadott képsablont a gyorsítótárból, és kérést küld az Azure-nak a képsablon létrehozásához.

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

Példák

Sablonerőforrás létrehozása sablonobjektumból a parancssori felület gyorsítótárában.

# 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

Opcionális paraméterek

--add

Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string vagy JSON string>.

--defer

Ideiglenesen tárolja az objektumot a helyi gyorsítótárban az Azure-ba való küldés helyett. Parancsok használata az cache a megtekintéshez/törléshez.

--force-string

A "set" vagy a "add" használatakor a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. A --id vagy más "Erőforrás-azonosító" argumentumokat kell megadnia.

--name -n

A képsablon neve.

--remove

Tulajdonság vagy elem eltávolítása egy listából. Példa: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

--set

Objektum frissítése egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder wait

Helyezze a parancssori felületet várakozó állapotba, amíg a sablon valamely feltétele nem teljesül.

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

Példák

Indítsa el a sablon buildfuttatását, majd várja meg, amíg befejeződik.

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

Opcionális paraméterek

--created

Várjon, amíg létre nem jön a "provisioningState" a "Succeeded" helyen.

--custom

Várja meg, amíg a feltétel megfelel egy egyéni JMESPath-lekérdezésnek. Például provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running"?.

--deleted

Várja meg a törlést.

--exists

Várjon, amíg az erőforrás létezik.

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. A --id vagy más "Erőforrás-azonosító" argumentumokat kell megadnia.

--interval

Lekérdezési időköz másodpercben.

alapértelmezett érték: 30

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

--timeout

Maximális várakozás másodpercben.

alapértelmezett érték: 3600

--updated

Várjon, amíg frissül a provisioningState a "Succeeded" (Sikeres) időpontban.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.