Criar uma definição de imagem e uma 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.

1. Vá para o portal Azure e, em seguida, pesquise e selecione Azure Compute Gallery.

2. Selecione a galeria que você deseja usar a partir da lista.

3. 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.

4. na página Adicionar nova definição de imagem à Galeria de Computação do Azure, na guia Básico, selecione uma Região.

5. Em Nome de definição da imagem, digite algo como myImageDefinition.

6. Para Sistema operacional, selecione a opção correta com base na origem.

7. Para geração de VM, selecione a opção com base na sua origem. Na maioria dos casos, isso será Gen 1. Para obter mais informações, veja Suporte para VMs de geração 2.

8. Para Estado do sistema operacional, selecione a opção com base na origem. Para obter mais informações, veja Generalizado e especializado.

9. Para Publisher, digite um nome exclusivo como myPublisher.

10. Para Oferta, digite um nome exclusivo como myOffer.

11. Para SKU, digite um nome exclusivo como mySKU.

12. Na parte inferior da página, selecione Examinar + criar.

13. Após a definição da imagem passar na validação, selecione Criar.

14. Depois que a implantação for concluída, selecione Ir para o recurso.

15. Na página de definição de imagem, na guia Introdução, selecione Criar uma versão.

16. 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.

17. 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 major.minor.patch usando inteiros.

18. 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.

19. 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.

20. 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.

21. Na guia Replicação, selecione o tipo de armazenamento na lista suspensa.

22. Defina a Contagem de réplicas padrão, você pode substituir esse valor para cada região que adicionar.

23. 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.

24. Quando terminar, selecione Revisar + criar. Azure validará a configuração.

25. Quando a versão da imagem passar na validação, selecione Criar.

26. 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.

Para criar uma imagem usando o CLI do Azure, primeiro você precisa criar uma definição de imagem. 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 você tiver generalizado a VM (usando waagent -deprovision para Linux ou Sysprep para Windows), crie 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 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

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.

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 --virtual-machine 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 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Para criar uma imagem usando o PowerShell, primeiro você precisa criar uma definição de 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, você deve criar uma definição de imagem usando -OsState generalized. 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 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 de imagem é denominada myImageDefinition e é para 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'

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.

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

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}"
            }
        }
    }
}

Use o CLI do Azure para criar uma versão de imagem em um locatário usando a versão da imagem de origem em outro locatário.

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

# Sign in to the subscription where the new image version will be created
az login

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

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

# Create the image version from the source image version
az sig image-version create \
   --gallery-image-definition myImageDef \
   --gallery-image-version 1.0.0 \
   --gallery-name myGallery \
   --resource-group myResourceGroup \
   --image-version $sourceImageVersionID \
   --location myLocation

Use o PowerShell para criar uma versão de imagem em um locatário usando a versão da imagem de origem em outro locatário.

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

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

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

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