az image builder

Comandos

Cancele a compilação da imagem de longa execução com base no modelo de imagem.

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

Exemplos

Cancelar uma compilação de imagem.

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

Parâmetros Opcionais

Crie um modelo do Image Builder.

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

Exemplos

Crie um modelo do Image Builder de uma imagem do UbuntuLTS 18, 4. Distribuí-lo como uma imagem gerenciada e uma versão de imagem da Galeria de imagens compartilhada

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

Crie um modelo do Image Builder usando um arquivo de modelo de imagem.

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

Avançadas Crie um modelo de imagem com vários personalizadores e distribuidores usando o cache de objetos da CLI via--Defer. Oferece suporte a recursos como: personalizador e nomes de saída, códigos de saída do PowerShell, scripts embutidos, reinicialização do Windows, personalizadores de arquivo, marcas de artefato e distribuidores de saída VHD.

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

Parâmetros Exigidos

Parâmetros Opcionais

Excluir modelo do construtor de imagem.

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

Exemplos

Excluir modelo do construtor de imagem. gerado automaticamente

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

Parâmetros Opcionais

Listar modelos do Image Builder.

az image builder list [--query-examples]
                      [--resource-group]
                      [--subscription]

Parâmetros Opcionais

Crie um modelo do Image Builder.

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

Exemplos

Inicie uma execução de compilação de modelo e aguarde até que ela seja concluída.

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

Parâmetros Opcionais

Mostrar um modelo do Image Builder.

az image builder show [--ids]
                      [--name]
                      [--query-examples]
                      [--resource-group]
                      [--subscription]

Exemplos

Mostrar um modelo do Image Builder (gerado automaticamente)

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

Parâmetros Opcionais

Mostrar as saídas de execução de um modelo do Image Builder.

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

Exemplos

Execute uma execução de compilação de modelo e, em seguida, exiba suas saídas de execução.

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

Parâmetros Opcionais

Atualizar um modelo do Image Builder.

Não há suporte para a atualização de modelos do Image Builder no momento. Esse comando pode ser usado em conjunto com--Defer para atualizar um objeto de modelo de imagem dentro do cache da CLI. Sem--Defer, ele recupera o modelo de imagem especificado do cache e envia uma solicitação ao Azure para criar o modelo de imagem.

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

Exemplos

Crie um recurso de modelo a partir de um objeto de modelo no cache da CLI.

# 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

Parâmetros Opcionais

Coloque a CLI em um estado de espera até que uma condição do modelo seja atendida.

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

Exemplos

Inicie uma execução de compilação de modelo e aguarde até que ela seja concluída.

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

Parâmetros Opcionais