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

Artigo
10/18/2023

Atenção

Este artigo faz referência ao CentOS, uma distribuição Linux que está se aproximando do status de Fim da Vida Útil (EOL). Por favor, considere o seu uso e planeje de acordo. Para obter mais informações, consulte as diretrizes de Fim da Vida Útil do CentOS.

Uma Galeria de Computação do Azure (anteriormente conhecida como Galeria de Imagens Compartilhadas) simplifica o compartilhamento de imagens personalizadas em sua organização. As imagens personalizadas são como imagens do marketplace, mas são criadas por si. As imagens podem ser criadas a partir de uma VM, VHD, instantâneo, imagem gerenciada ou outra versão de 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, dentro de um locatário do Microsoft Entra ou publicamente usando uma galeria da comunidade. Escolha as imagens que pretende partilhar, em que regiões pretende disponibilizá-las e com quem pretende partilhá-las. Você pode criar várias galerias para que possa agrupar imagens logicamente. Muitos recursos novos, como ARM64, Rede Acelerada e TrustedVM, são suportados apenas pela Galeria de Computação do Azure e não estão disponíveis para imagens gerenciadas.

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

Recurso	Description
Fonte da imagem	Este é um recurso que pode ser usado para criar uma versão de imagem em uma galeria. Uma fonte de imagem pode ser uma VM do Azure existente que é generalizada ou especializada, uma imagem gerenciada, um instantâneo ou uma versão de imagem em outra galeria.
Galeria	Como o Azure Marketplace, uma galeria é um repositório para gerenciar e compartilhar imagens e aplicativos VM, mas você controla quem tem acesso.
Definição de imagem	As definições de imagem são criadas dentro de uma galeria e carregam informações sobre a imagem e os requisitos para usá-la internamente. Isso inclui se a imagem é Windows ou Linux, notas de 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 de imagem é o que você usa para criar uma VM ao usar uma galeria. Você pode ter várias versões de uma imagem conforme necessário para seu ambiente. Como uma imagem gerenciada, quando você usa uma versão de imagem para criar uma VM, a versão da imagem é usada para criar novos discos para a VM. As 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 na sua subscrição. 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 de definição de imagem podem ser compostos por letras maiúsculas ou minúsculas, dígitos, pontos, traços e pontos. Para obter mais informações sobre os valores que você pode especificar para uma definição de imagem, consulte 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.Versão Menor.Adesivo.

Ao trabalhar neste artigo, substitua os nomes dos recursos onde necessário.

Para imagens generalizadas , consulte as orientações específicas do SO antes de capturar a imagem:

Linux
- Passos genéricos
- CentOS
- Debian
- Carro plano
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

Se você planeja executar o Sysprep antes de carregar seu disco rígido virtual (VHD) no Azure pela primeira vez, certifique-se de ter preparado sua VM.

Galeria da comunidade

Se você estiver compartilhando suas imagens usando uma galeria da comunidade, certifique-se de criar sua galeria, definições de imagem e versões de imagem na mesma região.

Quando os utilizadores pesquisam imagens da galeria da comunidade, apenas é apresentada a versão mais recente de uma imagem.

Importante

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

Criar uma imagem

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

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

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

Vá para o portal do Azure e, em seguida, procure e selecione Galeria de Computação do Azure.
Selecione a galeria que deseja usar na lista.
Na página da sua galeria, selecione Adicionar na 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 Noções básicas, selecione uma Região.
Em Image definition name, digite um nome como myImageDefinition.
Para Sistema operacional, selecione a opção correta com base na sua fonte.
Para geração de VM, selecione a opção com base na sua origem. Na maioria dos casos, será a Gen 1. Para obter mais informações, consulte Suporte para VMs de 2ª geração.
Em Estado do sistema operacional, selecione a opção com base na sua origem. Para obter mais informações, consulte Generalizado e especializado.
Em Publisher, digite um nome exclusivo como myPublisher.
Em Oferta, digite um nome exclusivo como myOffer.
Para SKU, digite um nome exclusivo como mySKU.
Na parte inferior da página, selecione Rever + criar.
Depois que a definição da imagem passar na validação, selecione Criar.
Quando a implantação estiver concluída, selecione Ir para recurso.
Na página da definição da imagem, na guia Introdução , selecione Criar uma versão.
Em Região, selecione a região onde deseja que a imagem seja criada. Em alguns casos, a fonte deve estar na mesma região onde a imagem é 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 mais tarde.
Em Número da versão, digite um número como 1.0.0. O nome da versão da imagem deve seguir o principal.menor.formato de patch usando inteiros.

Em Origem, selecione o tipo de arquivo que você está usando para sua fonte na lista suspensa. Consulte a tabela abaixo para obter detalhes específicos para cada tipo de fonte.

Source	Outros domínios
Discos ou snapshots	- Para o disco do sistema operacional, selecione o disco ou instantâneo na lista suspensa. - Para adicionar um disco de dados, digite o número do LUN e selecione o disco de dados na lista suspensa.
Versão da imagem	- Selecione a galeria Fonte 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 escolhida em Detalhes da instância.
VHD em uma conta de armazenamento	Selecione Procurar para escolher a conta de armazenamento para o VHD.

Em Excluir da versão mais recente, deixe o valor padrão de 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.
Em Data de fim de vida, selecione uma data no calendário para quando você acha que essa versão deve parar de ser usada.
Na guia Replicação, selecione o tipo de armazenamento na lista suspensa.
Defina a contagem de réplica padrão, você pode substituí-la para cada região adicionada.
Você precisa replicar para a região de origem, portanto, a primeira réplica na lista estará na região onde 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 Rever + criar. O Azure validará a configuração.
Quando a versão da imagem passar na validação, selecione Criar.
Quando a implantação estiver concluída, selecione Ir para 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 uma imagem, a partir do portal. Para obter mais informações, consulte Criar uma imagem de uma VM no portal.

As definições de imagem criam um agrupamento lógico para imagens. Eles são usados para gerenciar informações sobre as versões de imagem que são criadas dentro deles.

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

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

Neste exemplo, a definição de imagem é chamada myImageDefinition e é para uma imagem especializada do sistema operacional Linux. Para criar uma definição para imagens usando um sistema operacional 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

Nota

Para definições de imagem que conterão imagens descendentes de imagens de mercado 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 da imagem adicionando --plan-name, --plan-producte --plan-publisher quando você criar a definição da 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 será alterada, dependendo do que você está usando como fonte. Você pode misturar os tipos de fonte, desde que tenha apenas uma fonte de sistema operacional. Você também pode ter fontes diferentes para cada disco de dados.

Source	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 da imagem	`--managed-image <Resource ID of the managed image or image version`
Snapshot 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:
Snapshot 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 diferentes fontes para sua imagem, consulte os exemplos az sig image-version create.

No exemplo abaixo, estamos criando uma imagem de uma VM. A versão da nossa imagem é 1.0.0 e vamos criar 2 réplicas na região Centro-Oeste dos EUA , 1 réplica na região Centro-Sul dos EUA e 1 réplica na região Leste dos EUA 2 usando armazenamento redundante de zona. As regiões de replicação devem incluir a região em que a VM de origem está localizada.

É uma prática recomendada parar\desalocar a VM antes de criar uma imagem.

Substitua o valor de --managed-image neste exemplo pelo 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"

Nota

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

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

As definições de imagem criam um agrupamento lógico para imagens. Ao fazer a definição da sua imagem, certifique-se de que tem todas as informações corretas. Se você generalizou a VM de origem, deverá criar uma definição de imagem usando -OsState generalizedo . Se você não generalizou a fonte, crie uma definição de imagem usando -OsState specialized.

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

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

Neste exemplo, a definição de imagem é chamada myImageDefinition e é para uma VM especializada que executa o 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'

Nota

Para definições de imagem que conterão 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 da imagem adicionando -PurchasePlanName, -PurchasePlanProducte -PurchasePlanPublisher quando você criar a definição da imagem.

Criar uma versão de imagem

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

A sintaxe para criar a imagem será alterada, dependendo do que você está usando como fonte.

Source	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 da imagem	`-SourceImageId <Resource ID of the managed image or image version`
Snapshot ou disco gerenciado	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Disco de dados
Snapshot ou disco gerenciado	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

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

Neste exemplo, a versão da imagem é 1.0.0 e é replicada para datacenters do Centro-Oeste dos EUA e do Centro-Sul dos EUA . Ao escolher regiões de destino para replicação, lembre-se de que você também precisa incluir a região de origem como um destino para 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 demorar algum tempo a replicar a imagem para todas as regiões-alvo, pelo que criámos um emprego para podermos acompanhar o progresso. Para ver o progresso do trabalho, digite $job.State.

$job.State

Nota

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

Você também pode armazenar sua imagem no armazenamento Premium adicionando -StorageAccountType Premium_LRS, ou Armazenamento com Redundância de Zona adicionando -StorageAccountType Standard_ZRS quando você cria 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 versão de imagem usando a API REST. Neste exemplo, estamos criando uma versão de imagem de uma VM. Para usar outra fonte, passe o ID do recurso para a origem (por exemplo, passe o ID do instantâneo de 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 em outro locatário

Na subscrição em que a imagem de origem existe, conceda permissões de leitor ao utilizador. Uma vez que o usuário tenha permissão de leitor para a imagem de origem, faça login em ambas as contas (fonte e destino).

Você precisará da tenantID imagem de origem, da subscriptionID assinatura onde a nova imagem será armazenada (destino) e da resourceID 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óximos passos

Para obter informações sobre como fornecer informações do plano de compra, consulte Fornecer 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 em outro locatário

Próximos passos

Recursos adicionais