az image builder

Görüntü oluşturucu şablonlarını yönetme ve oluşturma.

Komutlar

az image builder cancel

Görüntü şablonunu temel alarak uzun süre çalışan görüntü derlemesini iptal edin.

az image builder create

Görüntü oluşturucu şablonu oluşturun.

az image builder customizer

Görüntü oluşturucu şablon özelleştiricilerini yönetme.

az image builder customizer add

Görüntü oluşturucu şablonuna görüntü oluşturucu özelleştiricisi ekleyin.

az image builder customizer clear

Görüntü oluşturucu şablonundan tüm görüntü oluşturucu özelleştiricilerini kaldırın.

az image builder customizer remove

Görüntü oluşturucu şablonundan görüntü oluşturucu özelleştiricisini kaldırma.

az image builder delete

Görüntü oluşturucu şablonunu silin.

az image builder list

Görüntü oluşturucu şablonlarını listeleyin.

az image builder output

Görüntü oluşturucu şablonu çıkış dağıtımcılarını yönetin.

az image builder output add

Görüntü oluşturucu şablonuna görüntü oluşturucu çıkış dağıtımcısı ekleyin.

az image builder output clear

Görüntü oluşturucu şablonundan tüm görüntü oluşturucu çıkış dağıtımcılarını kaldırın.

az image builder output remove

Görüntü oluşturucusu çıktı dağıtımcısını görüntü oluşturucu şablonundan kaldırma.

az image builder run

Görüntü oluşturucu şablonu oluşturma.

az image builder show

Görüntü oluşturucu şablonunu gösterme.

az image builder show-runs

Görüntü oluşturucu şablonunun çalıştırma çıkışlarını gösterir.

az image builder update

Görüntü oluşturucu şablonunu güncelleştirme.

az image builder wait

Şablonun koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

az image builder cancel

Görüntü şablonunu temel alarak uzun süre çalışan görüntü derlemesini iptal edin.

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

Örnekler

Görüntü derlemeyi iptal etme.

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

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren tam bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az image builder create

Görüntü oluşturucu şablonu oluşturun.

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]

Örnekler

UbuntuLTS 18.04 görüntüsünden görüntü oluşturucu şablonu oluşturun. Yönetilen görüntü ve paylaşılan görüntü galerisi görüntü sürümü olarak dağıtın

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

Görüntü şablonu dosyası kullanarak bir görüntü oluşturucu şablonu oluşturun.

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

[Gelişmiş] --defer aracılığıyla CLI'nın nesne önbelleğini kullanarak birden çok özelleştirici ve dağıtımcı ile bir görüntü şablonu oluşturun. Özelleştirici ve çıkış adları, powershell çıkış kodları, satır içi betikler, windows yeniden başlatma, dosya özelleştiriciler, yapıt etiketleri ve vhd çıkış dağıtımcıları gibi özellikleri destekler.

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

Gerekli Parametreler

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--build-timeout

Görüntü şablonunu oluştururken beklenme süresi üst sınırı (dakika cinsinden). Varsayılan değer 60'tır.

--build-vm-identities

derleme sanal makinesini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla.

--checksum

Red Hat ISO görüntüsünün SHA256 sağlama toplamı.

--defer

Nesneyi Azure'a göndermek yerine geçici olarak yerel önbellekte depolayın. Görüntülemek/temizlemek için komutları kullanın az cache .

--identity

Görüntü şablonunun kullanıcı tarafından atanan kimliklerin (ad veya kimlik, boşlukla ayrılmış) listesi.

--image-source -i

Özelleştirebileceğiniz temel görüntü. Geçerli bir platform görüntüsü URN'si, platform görüntüsü diğer adı, Red Hat ISO görüntü URI'si, yönetilen görüntü adı/kimliği veya paylaşılan görüntü sürümü kimliği olmalıdır.

şuradan alınan değerler:: az vm image list, az vm image show
--image-template

Görüntü şablonu dosyasının yerel yolu veya URL'si. --image-template kullanılırken -g ve -n dışında diğer tüm parametreler yoksayılır. Başvuru: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Konum. Değerleri: az account list-locations. varsayılan konumu kullanarak az configure --defaults location=<location>yapılandırabilirsiniz.

--managed-image-destinations

Yönetilen görüntü çıktı dağıtımcısı bilgileri. Anahtar-değer çiftlerinin boşlukla ayrılmış listesi. Örneğin "image_1=westus2 image_2=westus". Her anahtar, oluşturulacak yönetilen görüntünün adı veya kaynak kimliğidir. Her değer görüntünün konumudur.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

--os-disk-size

İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin.

--proxy-vm-size

Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4).

--scripts

Görüntüyü özelleştirmek için kabuk veya powershell betiklerinin boşlukla ayrılmış listesi. Her betik genel olarak erişilebilen bir URL olmalıdır. Dosya uzantısından ('.sh' veya'.ps1') veya kaynak türünden betik türünü çıkarsar. Daha fazla özelleştirici seçeneği ve esneklik için bkz. 'az image template customizer add'.

--shared-image-destinations

Paylaşılan görüntü galerisi (sig) çıkış dağıtımcısı bilgileri. Anahtar-değer çiftlerinin boşlukla ayrılmış listesi. Örneğin"my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth." Her anahtar, sig görüntü tanımı kimliği veya sig galeri adı ve "/" ile sınırlandırılmış sig görüntü tanımıdır. Her değer, çoğaltma konumlarının virgülle ayrılmış bir listesidir.

--subnet

Derleme sanal makinesinin dağıtılacağı alt ağın adı veya kimliği.

--tags

Boşlukla ayrılmış etiketler: anahtar[=değer] [anahtar[=değer] ...]. Mevcut etiketleri temizlemek için "" kullanın.

--vm-size

Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılan (Standard_D1_v2) kullanmak için boş dizeyi atla veya belirt.

--vnet

Derleme sanal makinesinin dağıtılacağı sanal ağın adı. Bunu yalnızca alt ağ bir ad olduğunda belirtmeniz gerekir.

az image builder delete

Görüntü oluşturucu şablonunu silin.

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

Örnekler

Görüntü oluşturucu şablonunu silin. (otomatik olarak oluşturulur)

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

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren tam bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az image builder list

Görüntü oluşturucu şablonlarını listeleyin.

az image builder list [--resource-group]

İsteğe Bağlı Parametreler

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az image builder run

Görüntü oluşturucu şablonu oluşturma.

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

Örnekler

Bir şablon derleme çalıştırması başlatın ve tamamlanmasını bekleyin.

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

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren tam bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az image builder show

Görüntü oluşturucu şablonunu gösterme.

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

Örnekler

Görüntü oluşturucu şablonunu gösterme (otomatik olarak oluşturulmuş)

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

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren tam bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az image builder show-runs

Görüntü oluşturucu şablonunun çalıştırma çıkışlarını gösterir.

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

Örnekler

Bir şablon derleme çalıştırması çalıştırın ve çalıştırma çıkışlarını görüntüleyin.

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

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren tam bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--output-name

Görüntü oluşturucu çalıştırma çıkışının adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az image builder update

Görüntü oluşturucu şablonunu güncelleştirme.

Görüntü oluşturucu şablonlarının güncelleştirilmesi şu anda desteklenmiyor. Bu komut CLI önbelleğindeki bir görüntü şablonu nesnesini güncelleştirmek için --defer ile birlikte kullanılabilir. --defer olmadan, belirtilen görüntü şablonunu önbellekten alır ve görüntü şablonunu oluşturmak için Azure'a bir istek gönderir.

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

Örnekler

Cli önbelleğindeki bir şablon nesnesinden şablon kaynağı oluşturun.

# 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

İsteğe Bağlı Parametreler

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string veya JSON string>.

--defer

Nesneyi Azure'a göndermek yerine geçici olarak yerel önbellekte depolayın. Görüntülemek/temizlemek için komutları kullanın az cache .

--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren tam bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--set

Ayarlanacağı özellik yolunu ve değerini belirterek bir nesneyi güncelleştirin. Örnek: --set property1.property2=.

az image builder wait

Şablonun koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

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

Örnekler

Bir şablon derleme çalıştırması başlatın ve ardından bitmesini bekleyin.

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

İsteğe Bağlı Parametreler

--created

'provisioningState' ile 'Succeeded' konumunda oluşturulana kadar bekleyin.

--custom

Koşul özel bir JMESPath sorgusunu karşılayana kadar bekleyin. Örneğin provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Silinene kadar bekleyin.

--exists

Kaynak var olana kadar bekleyin.

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren tam bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--interval

Saniye cinsinden yoklama aralığı.

varsayılan değer: 30
--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--timeout

Saniye cinsinden maksimum bekleme.

varsayılan değer: 3600
--updated

provisioningState değeri 'Başarılı' olarak güncelleştirilene kadar bekleyin.