az image builder

Gerenciar e compilar modelos do Image Builder.

Comandos

az image builder cancel

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

az image builder create

Crie um modelo do Image Builder.

az image builder customizer

Gerencie os personalizadores de modelo do Image Builder.

az image builder customizer add

Adicione um personalizador do construtor de imagem a um modelo do Image Builder.

az image builder customizer clear

Remova todos os personalizadores do Image Builder de um modelo do Image Builder.

az image builder customizer remove

Remova um personalizador do Image Builder de um modelo do Image Builder.

az image builder delete

Excluir modelo do construtor de imagem.

az image builder list

Listar modelos do Image Builder.

az image builder output

Gerenciar distribuidores de saída de modelo do Image Builder.

az image builder output add

Adicione um distribuidor de saída do construtor de imagem a um modelo do Image Builder.

az image builder output clear

Remova todos os distribuidores de saída do Image Builder de um modelo do Image Builder.

az image builder output remove

Remova um distribuidor de saída do construtor de imagem de um modelo do Image Builder.

az image builder run

Crie um modelo do Image Builder.

az image builder show

Mostrar um modelo do Image Builder.

az image builder show-runs

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

az image builder update

Atualizar um modelo do Image Builder.

az image builder wait

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

az image builder cancel

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações dos argumentos ' Resource ID '. Você deve fornecer--IDs ou outros argumentos ' Resource ID '.

--name -n

O nome do modelo de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az image builder create

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

--name -n

O nome do modelo de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--build-timeout

A duração máxima a aguardar ao criar o modelo de imagem, em minutos. O padrão é 60.

--checksum

A soma de verificação SHA256 da imagem ISO do Red Hat.

--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache comandos para exibir/limpar.

--identity

Lista de identidades atribuídas ao usuário (nome ou ID, delimitados por espaço) do modelo de imagem.

--image-source -i

A imagem base a ser personalizada. Deve ser uma imagem de plataforma URN válida, o alias da imagem da plataforma, o URI da imagem ISO do Red Hat, o nome/ID da imagem gerenciada ou a ID da versão da imagem compartilhada.

valor de: az vm image list, az vm image show
--image-template

Caminho local ou URL para um arquivo de modelo de imagem. Ao usar--Image-template, todos os outros parâmetros são ignorados, exceto-g e-n. Referência: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/image-builder-json.

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--managed-image-destinations

Informações do distribuidor de saída de imagem gerenciada. Lista separada por espaços de pares chave-valor. Por exemplo, "image_1 = westus2 image_2 = westus". Cada chave é o nome ou a ID de recurso da imagem gerenciada a ser criada. Cada valor é o local da imagem.

--no-wait

Não aguarde a conclusão da operação de execução longa.

--os-disk-size

Tamanho do disco do sistema operacional em GB. Omita ou especifique 0 para usar o tamanho do disco do sistema operacional padrão do Azure.

--scripts

Lista separada por espaços de scripts do Shell ou do PowerShell para personalizar a imagem com o. Cada script deve ser uma URL acessível publicamente. Infere o tipo de script da extensão de arquivo ('. sh ' ou '. ps1 ') ou do tipo de origem. Mais opções e flexibilidade de personalização, consulte: ' AZ Image template customizator Add '.

--shared-image-destinations

Informações do distribuidor de saída da Galeria de imagens compartilhadas (SIG). Lista separada por espaços de pares chave-valor. Por exemplo, "my_gallery_1/image_def_1 = eastus, oesteus my_gallery_2/image_def_2 = uksouth, canadaeast, francesouth." Cada chave é a ID de definição da imagem SIG ou o nome da Galeria SIG e a definição de imagem SIG delimitada por um "/". Cada valor é uma lista delimitada por vírgulas de locais de réplica.

--subnet

Nome ou ID da sub-rede para implantar a máquina virtual de compilação.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

--tags

Marcas separadas por espaço: chave [= valor] [chave [= valor]...]. Use "" para limpar as marcas existentes.

--vm-size

Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique uma cadeia de caracteres vazia para usar o padrão (Standard_D1_v2).

--vnet

Nome da VNET para implantar a máquina virtual de compilação. Você só deve especificá-lo quando a sub-rede for um nome.

az image builder delete

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações dos argumentos ' Resource ID '. Você deve fornecer--IDs ou outros argumentos ' Resource ID '.

--name -n

O nome do modelo de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az image builder list

Listar modelos do Image Builder.

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

Parâmetros Opcionais

--query-examples

Recomende uma cadeia de caracteres JMESPath para você. Você pode copiar uma da consulta e colá-la após o parâmetro--Query entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que possamos dar sugestões com base nessas palavras-chaves.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az image builder run

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações dos argumentos ' Resource ID '. Você deve fornecer--IDs ou outros argumentos ' Resource ID '.

--name -n

O nome do modelo de imagem.

--no-wait

Não aguarde a conclusão da operação de execução longa.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az image builder show

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações dos argumentos ' Resource ID '. Você deve fornecer--IDs ou outros argumentos ' Resource ID '.

--name -n

O nome do modelo de imagem.

--query-examples

Recomende uma cadeia de caracteres JMESPath para você. Você pode copiar uma da consulta e colá-la após o parâmetro--Query entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que possamos dar sugestões com base nessas palavras-chaves.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az image builder show-runs

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações dos argumentos ' Resource ID '. Você deve fornecer--IDs ou outros argumentos ' Resource ID '.

--name -n

O nome do modelo de imagem.

--output-name

Nome da saída de execução do construtor de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az image builder update

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

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares chave-valor. Exemplo:--Adicionar Property. ListProperty <chave = valor, Cadeia de caracteres ou cadeia de caracteres JSON>.

--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache comandos para exibir/limpar.

--force-string

Ao usar "set" ou "Add", preserve cadeias de caracteres literais em vez de tentar converter em JSON.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações dos argumentos ' Resource ID '. Você deve fornecer--IDs ou outros argumentos ' Resource ID '.

--name -n

O nome do modelo de imagem.

--remove

Remove uma propriedade ou um elemento de uma lista. Exemplo:--Remove Property. List ou--remove propertyToRemove.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo:--Set Property1. Property2 =.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az image builder wait

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

--created

Aguarde até que seja criado com ' provisioningState ' em ' êxito '.

--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por ex.: provisioningState! = ' em andamento ', instanceView. status [? código = = ' PowerState/em execução '].

--deleted

Aguarde até que seja excluído.

--exists

Aguarde até que o recurso exista.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações dos argumentos ' Resource ID '. Você deve fornecer--IDs ou outros argumentos ' Resource ID '.

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--name -n

O nome do modelo de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em ' Succeeded '.