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
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.
Görüntü şablonunun adı.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
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
Görüntü şablonunun adı.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
İsteğe Bağlı Parametreler
Görüntü şablonunu oluştururken beklenme süresi üst sınırı (dakika cinsinden). Varsayılan değer 60'tır.
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.
Red Hat ISO görüntüsünün SHA256 sağlama toplamı.
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 .
Görüntü şablonunun kullanıcı tarafından atanan kimliklerin (ad veya kimlik, boşlukla ayrılmış) listesi.
Ö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.
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.
Konum. Değerleri: az account list-locations. varsayılan konumu kullanarak az configure --defaults location=<location>yapılandırabilirsiniz.
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.
Uzun süre çalışan işlemin bitmesini beklemeyin.
İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin.
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).
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'.
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.
Derleme sanal makinesinin dağıtılacağı alt ağın adı veya kimliği.
Boşlukla ayrılmış etiketler: anahtar[=değer] [anahtar[=değer] ...]. Mevcut etiketleri temizlemek için "" kullanın.
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.
Derleme sanal makinesinin dağıtılacağı sanal ağın adı. Bunu yalnızca alt ağ bir ad olduğunda belirtmeniz gerekir.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
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
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.
Görüntü şablonunun adı.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az image builder list
Görüntü oluşturucu şablonlarını listeleyin.
az image builder list [--resource-group]
İsteğe Bağlı Parametreler
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
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
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.
Görüntü şablonunun adı.
Uzun süre çalışan işlemin bitmesini beklemeyin.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
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
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.
Görüntü şablonunun adı.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
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
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.
Görüntü şablonunun adı.
Görüntü oluşturucu çalıştırma çıkışının adı.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
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
Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string veya JSON string>.
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 .
'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.
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.
Görüntü şablonunun adı.
Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list OR --remove propertyToRemove.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.
Ayarlanacağı özellik yolunu ve değerini belirterek bir nesneyi güncelleştirin. Örnek: --set property1.property2=.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
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
'provisioningState' ile 'Succeeded' konumunda oluşturulana kadar bekleyin.
Koşul özel bir JMESPath sorgusunu karşılayana kadar bekleyin. Örneğin provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Silinene kadar bekleyin.
Kaynak var olana kadar bekleyin.
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.
Saniye cinsinden yoklama aralığı.
Görüntü şablonunun adı.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.
Saniye cinsinden maksimum bekleme.
provisioningState değeri 'Başarılı' olarak güncelleştirilene kadar bekleyin.
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir, uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.