Criar uma definição de imagem e uma versão de imagem

Artigo
09/23/2023

Cuidado

Este artigo faz referência ao CentOS, uma distribuição do Linux que está se aproximando do status de EOL (fim da vida útil). Considere seu uso e planeje adequadamente. Para obter mais informações, veja as Diretrizes sobre fim da vida útil do CentOS.

Uma Galeria de Computação do Azure (chamada anteriormente de Galeria de Imagens Compartilhadas) simplifica o compartilhamento de imagens personalizadas em sua organização. Imagens personalizadas são como imagens do marketplace, mas você mesmo as cria. As imagens podem ser criadas com base em uma VM, VHD, instantâneo, imagem gerenciada ou outra versão da imagem.

A Galeria de Computação do Azure permite que você compartilhe suas imagens de VM personalizadas com outras pessoas em sua organização, dentro ou entre regiões, em um locatário do Microsoft Entra ou publicamente usando uma galeria da comunidade. Escolha quais imagens você deseja compartilhar, em quais regiões deseja torná-las disponíveis e com quem deseja compartilhá-las. Você pode criar várias galerias a fim de agrupar logicamente as imagens. Muitos novos recursos, como o ARM64, a rede acelerada e a TrustedVM, só têm suporte por meio da Galeria de Computação do Azure e não estão disponíveis para 'Imagens gerenciadas'.

O recurso da Galeria de Computação do Azure tem vários tipos de recursos:

Recurso	Descrição
Origem da imagem	Este é um recurso que pode ser usado para criar uma versão da imagem em uma galeria. Uma origem de imagem pode ser uma VM do Azure existente generalizada ou especializada, uma imagem gerenciada, um instantâneo ou uma versão de imagem em outra galeria.
Galeria	Assim como o Azure Marketplace, uma galeria é um repositório para gerenciar e compartilhar imagens e aplicativos de VM, mas você controla quem tem acesso.
Definição da imagem	As definições de imagem são criadas dentro de uma galeria e transportam informações sobre a imagem e os requisitos para usá-la internamente. Isso inclui se a imagem é Windows ou Linux, notas sobre a versão e requisitos mínimos e máximos de memória. É uma definição de um tipo de imagem.
Versão da imagem	Uma versão da imagem é usada para criar uma VM ao usar uma galeria. Você pode ter diversas versões de uma imagem conforme necessário para seu ambiente. Como uma imagem gerenciada, quando você usa uma versão da imagem para criar uma VM, a versão da imagem é usada para criar novos discos para a VM. Versões de imagem podem ser usadas várias vezes.

Antes de começar

Para concluir este artigo, você deve ter uma Galeria de Computação do Azure existente e uma fonte para sua imagem disponível no Azure. As fontes de imagem podem ser:

Uma VM em sua assinatura. Você pode capturar uma imagem de VMs especializadas e generalizadas.
Uma imagem gerenciada,
SO gerenciado e discos de dados.
SO e discos de dados como VHDs em uma conta de armazenamento.
Outras versões de imagem na mesma galeria ou em outra galeria na mesma assinatura.

Se a imagem contiver discos de dados, o tamanho do disco de dados não pode ser superior a 1 TB.

Os nomes das definições de imagem podem ser compostos por letras maiúsculas ou minúsculas, dígitos, pontos, traços e pontos finais. Para obter mais informações sobre os valores que pode especificar para uma definição de imagem, confira Definições de imagem.

Os caracteres permitidos para a versão da imagem são números e pontos. Os números devem estar dentro do intervalo de um inteiro de 32 bits. Formato: MajorVersion.MinorVersion.Patch.

Ao trabalhar com este artigo, substitua os nomes do recurso quando for necessário.

Para imagens generalizadas, consulte as diretrizes específicas do sistema operacional antes de capturar a imagem:

Linux
- Etapas genéricas
- CentOS
- Debian
- Flatcar
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

Se você planeja executar o Sysprep antes de carregar o VHD (disco rígido virtual) no Azure pela primeira vez, prepare a VM.

Galeria da comunidade

Se você pretende compartilhar as imagens usando uma galeria da comunidade, crie a galeria, as definições de imagem e as versões de imagem na mesma região.

Quando os usuários pesquisam imagens de galeria da comunidade, apenas a versão mais recente de uma imagem é mostrada.

Importante

As informações de suas definições de imagem estarão disponíveis publicamente, como o que você fornece para Publicação, Oferta e SKU.

Criar uma imagem

Escolha uma opção abaixo para criar sua definição e versão de imagem:

Para criar uma imagem de uma VM no portal, confira Capturar uma imagem de uma VM.

Para criar uma imagem usando uma fonte diferente de uma VM, siga estas etapas.

Vá até o portal do Azure, pesquise por Galeria de Computação do Azure e selecione essa opção.
Selecione a galeria que você deseja usar a partir da lista.
Na página da sua galeria, selecione Adicionar da parte superior da página e, em seguida, selecione definição de imagem da VM na lista suspensa.
Na página Adicionar nova definição de imagem à Galeria de Computação do Azure, na guia Básico, selecione uma Região.
Em Nome de definição da imagem, digite algo como myImageDefinition.
Para Sistema operacional, selecione a opção correta com base na origem.
Para Geração da VM, selecione a opção com base na origem. Na maioria dos casos, ela estará em Gen 1. Para obter mais informações, veja Suporte para VMs de geração 2.
Para Estado do sistema operacional, selecione a opção com base na origem. Para obter mais informações, veja Generalizado e especializado.
Para Editor, digite um nome exclusivo como myPublisher.
Para Oferta, digite um nome exclusivo como myOffer.
Para SKU, digite um nome exclusivo como mySKU.
Na parte inferior da página, selecione Examinar + criar.
Após a definição da imagem passar na validação, selecione Criar.
Depois que a implantação for concluída, selecione Ir para o recurso.
Na página de definição de imagem, na guia Introdução, selecione Criar uma versão.
Em Região, selecione a região em que deseja criar a imagem. Em alguns casos, a origem deve estar na mesma região onde a imagem foi criada. Se você não estiver vendo sua fonte listada em menus suspensos posteriores, tente alterar a região da imagem. Você sempre pode replicar a imagem para outras regiões posteriormente.
Em Número de versão, digite um número como 1.0.0. O nome da versão da imagem deve seguir o formato principal.secundária.patch usando inteiros.

Em Origem, selecione o tipo de arquivo que você está usando para sua origem no menu suspenso. Confira a tabela abaixo para obter detalhes específicos para cada tipo de origem.

Fonte	Outros campos
Discos ou instantâneos	– Em Disco do sistema operacional, selecione o disco ou o instantâneo na lista suspensa. – Para adicionar um disco de dados, digite o número LUN e selecione o disco de dados na lista suspensa.
Versão da imagem	– Selecione a Galeria de origem na lista suspensa. – Selecione a definição de imagem correta na lista suspensa. – Selecione a versão da imagem existente que você deseja usar na lista suspensa.
Imagem gerenciada	Selecione a Imagem de origem na lista suspensa. A imagem gerenciada deve estar na mesma região que você escolheu em Detalhes da instância.
VHD em uma conta de armazenamento	Selecione Procurar para escolher a conta de armazenamento para o VHD.

Em Excluir do mais recente, deixe o valor padrão Não, a menos que você não queira que essa versão seja usada ao criar uma VM usando latest em vez de um número de versão.
Para Data de fim da vida útil, selecione uma data no calendário para quando você acha que esta versão deve parar de ser usada.
Na guia Replicação, selecione o tipo de armazenamento na lista suspensa.
Defina a Contagem de réplicas padrão, você pode substituir esse valor para cada região que adicionar.
Você precisa replicar para a região de origem, portanto, a primeira réplica da lista deverá estar na região em que você criou a imagem. Você pode adicionar mais réplicas selecionando a região na lista suspensa e ajustando a contagem de réplicas conforme necessário.
Quando terminar, selecione Revisar + criar. O Azure validará a configuração.
Quando a versão da imagem passar na validação, selecione Criar.
Depois que a implantação for concluída, selecione Ir para o recurso.

Pode levar algum tempo para replicar a imagem para todas as regiões de destino.

Você também pode capturar uma VM existente como imagem por meio do portal. Para obter mais informações, confira Criar uma imagem de uma VM no portal.

As definições de imagem criam um agrupamento lógico para as imagens. Elas são usadas para gerenciar informações sobre as versões da imagem que são criadas dentro delas.

Crie uma definição de imagem em uma galeria usando az sig image-definition create. Verifique se a definição da imagem é do tipo correto. Se tiver generalizado a VM (usando o waagent -deprovision para Linux ou Sysprep para Windows), você precisará criar uma definição de imagem generalizada usando --os-state generalized. Se quiser usar a VM sem remover contas de usuário existentes, crie uma definição de imagem especializada usando --os-state specialized.

Para obter mais informações sobre os parâmetros que pode especificar para uma definição de imagem, confira Definições de imagem.

Neste exemplo, a definição da imagem se chama myImageDefinition e é referente a uma imagem especializada do SO Linux. Para criar uma definição para imagens usando um SO Windows, use --os-type Windows.

az sig image-definition create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --publisher myPublisher \
   --offer myOffer \
   --sku mySKU \
   --os-type Linux \
   --os-state specialized

Observação

Para definições de imagem com imagens descendentes de imagens de mercado de terceiros, as informações do plano precisam corresponder exatamente às informações do plano da imagem de terceiros. Inclua as informações do plano na definição de imagem adicionando --plan-name, --plan-product e --plan-publisher ao criar a definição de imagem.

Criar a versão da imagem

Crie uma versão de imagem usando az sig image version create.

A sintaxe para criar a imagem mudará, dependendo do que você está usando como origem. Você pode misturar os tipos de origem, desde que você tenha apenas uma origem do sistema operacional. Você também pode ter origens diferentes para cada disco de dados.

Fonte	Conjunto de Parâmetros
Disco do SO:
VM usando a ID da VM	`--managed-image <Resource ID of the VM>`
Imagem gerenciada ou outra versão de imagem	`--managed-image <Resource ID of the managed image or image version`
Instantâneo ou disco gerenciado	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD em uma conta de armazenamento	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Disco de dados:
Instantâneo ou disco gerenciado	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD em uma conta de armazenamento	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Para obter exemplos detalhados de como especificar fontes diferentes para sua imagem, confira az sig image-version create examples.

No exemplo a seguir, estamos criando uma imagem de uma VM. A versão de nossa imagem é 1.0.0 e criaremos duas réplicas na região do Centro-Oeste dos EUA, uma na região Centro-Sul dos EUA e uma na região Leste dos EUA 2 usando o armazenamento com redundância de zona. As regiões de replicação precisam incluir a região em que a VM de origem fica localizada.

É uma melhor prática interromper\desalocar a VM antes de criar uma imagem.

Substitua o valor de --managed-image neste exemplo pela ID da sua VM.

az sig image-version create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --target-regions "westcentralus" "southcentralus=1" "eastus=1=standard_zrs" \
   --replica-count 2 \
   --managed-image "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Observação

Você precisa esperar que a versão da imagem seja compilada e replicada completamente antes de poder usar a mesma imagem gerenciada para criar outra versão da imagem.

Você também pode armazenar a imagem no armazenamento Premium adicionando --storage-account-type premium_lrs, ou no Armazenamento com Redundância de Zona adicionando --storage-account-type standard_zrs ao criar a versão da imagem.

As definições de imagem criam um agrupamento lógico para as imagens. Ao fazer a definição da imagem, verifique se todas as informações estão corretas. Se você generalizou a VM de origem generalizada, deve criar uma definição de imagem usando -OsState generalized. Se você não recebeu a origem generalizada, crie uma definição de imagem usando -OsState specialized.

Para obter mais informações sobre os valores que pode especificar para uma definição de imagem, confira Definições de imagem.

Crie a definição de imagem usando New-AzGalleryImageDefinition.

Neste exemplo, a definição da imagem se chama myImageDefinition e se refere a uma VM especializada executando Windows. Para criar uma definição para imagens usando Linux, use -OsType Linux.

$imageDefinition = New-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -Name 'myImageDefinition' `
   -OsState specialized `
   -OsType Windows `
   -Publisher 'myPublisher' `
   -Offer 'myOffer' `
   -Sku 'mySKU'

Observação

Para definições de imagem com imagens descendentes de imagens de terceiros, as informações do plano devem corresponder exatamente às informações do plano da imagem de terceiros. Inclua as informações do plano na definição de imagem adicionando -PurchasePlanName, -PurchasePlanProduct e -PurchasePlanPublisher ao criar a definição de imagem.

Criar uma versão de imagem

Crie uma versão da imagem usando New-AzGalleryImageVersion.

A sintaxe para criar a imagem mudará, dependendo do que você está usando como origem.

Fonte	Conjunto de Parâmetros
Disco do SO
VM usando a ID da VM	`-SourceImageId <Resource ID of the VM>`
Imagem gerenciada ou outra versão de imagem	`-SourceImageId <Resource ID of the managed image or image version`
Instantâneo ou disco gerenciado	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Disco de dados
Instantâneo ou disco gerenciado	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

No exemplo a seguir, estamos criando uma versão de imagem de uma VM. É uma melhor prática interromper\desalocar a VM antes de criar uma imagem usando Stop-AzVM.

Neste exemplo, a versão da imagem é 1.0.0 e ela é replicado para os datacenters Centro-Oeste dos EUA e Centro-Sul dos EUA. Ao escolher as regiões de destino da replicação, lembre-se de que você também precisa incluir a região de origem como destino para a replicação.

   $region1 = @{Name='South Central US';ReplicaCount=1}
   $region2 = @{Name='East US';ReplicaCount=2}
   $targetRegions = @($region1,$region2)

$job = $imageVersion = New-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition.Name`
   -GalleryImageVersionName '1.0.0' `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -TargetRegion $targetRegions  `
   -SourceImageId $sourceVm.Id.ToString() `
   -PublishingProfileEndOfLifeDate '2020-12-01' `  
   -asJob

Pode levar um tempo para replicar a imagem para todas as regiões de destino, portanto, criamos um trabalho para podermos acompanhar o progresso. Para ver o andamento do trabalho, digite $job.State.

$job.State

Observação

Você precisa esperar que a versão da imagem seja compilada e replicada completamente antes de poder usar a mesma imagem gerenciada para criar outra versão da imagem.

Você também pode armazenar a imagem no armazenamento Premium adicionando -StorageAccountType Premium_LRS, ou no Armazenamento com Redundância de Zona adicionando -StorageAccountType Standard_ZRS ao criar a versão da imagem.

Criar uma definição de imagem usando a API REST

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}?api-version=2019-12-01

{
    "location": "eastus",
    "properties": {
        "hyperVGeneration": "V1",
        "identifier": {
            "offer": "myOffer",
            "publisher": "myPublisher",
            "sku": "mySKU"
        },
        "osState": "Specialized",
        "osType": "Linux",
    },
}

Crie uma definição de imagem usando a API REST. Neste exemplo, estamos criando uma versão de imagem de uma VM. Para usar outra origem, passe a ID do recurso para origem (por exemplo, passe a ID do instantâneo do disco do sistema operacional).

# @name imageVersion
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}/versions/{galleryImageVersionName}?api-version=2019-12-01

{
    "location": "{region}",
    "properties": {
        "publishingProfile": {
            "endOfLifeDate": "2024-12-02T00:00:00+00:00",
            "replicaCount": 1,
            "storageAccountType": "Standard_ZRS",
            "targetRegions": [
                {
                    "name": "eastus",
                    "regionalReplicaCount": 2,
                    "storageAccountType": "Standard_LRS",
                },
                {
                    "name": "westus2",
                }
            ]
        },
        "storageProfile": {
            "source": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
            }
        }
    }
}

Criar uma imagem em um locatário usando a imagem de origem de outro locatário

Na assinatura em que a imagem de origem está localizada, conceda permissões de leitor ao usuário. Depois que o usuário tiver a permissão de leitor na imagem de origem, faça logon em ambas as contas (origem e destino).

Você precisará da tenantID da imagem de origem, da subscriptionID da assinatura em que a nova imagem será armazenada (destino) e da resourceID da imagem de origem.

CLI
PowerShell

# Set some variables
tenantID="<tenant ID for the source image>"
subID="<subscription ID where the image will be creted>"
sourceImageID="<resource ID of the source image>"

# Login to the subscription where the new image will be created
az login

# Log in to the tenant where the source image is available
az login --tenant $tenantID

# Log back in to the subscription where the image will be created and ensure subscription context is set
az login
az account set --subscription $subID

# Create the image
az sig image-version create `
   --gallery-image-definition myImageDef `
   --gallery-image-version 1.0.0 `
   --gallery-name myGallery `
   --resource-group myResourceGroup `
   --image-version $sourceImageID

# Set variables 
$targetSubID = "<subscription ID for the target>"
$sourceTenantID = "<tenant ID where for the source image>"
$sourceImageID = "<resource ID of the source image>"

# Login to the tenant where the source image is published
Connect-AzAccount -Tenant $sourceTenantID -UseDeviceAuthentication 

# Login to the subscription where the new image will be created and set the context
Connect-AzAccount -UseDeviceAuthentication -Subscription $targetSubID
Set-AzContext -Subscription $targetSubID 

# Create the image version from another image version in a different tenant
New-AzGalleryImageVersion `
   -ResourceGroupName myResourceGroup -GalleryName myGallery `
   -GalleryImageDefinitionName myImageDef `
   -Location "West US 2" `
   -Name 1.0.0 `
   -SourceImageId $sourceImageID

Próximas etapas

Saiba mais sobre como obter informações do plano de compra em Obter informações do plano de compra do Azure Marketplace ao criar imagens.

Criar uma definição de imagem e uma versão de imagem

Antes de começar

Galeria da comunidade

Criar uma imagem

Criar uma imagem em um locatário usando a imagem de origem de outro locatário

Próximas etapas

Recursos adicionais