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

1. Vai ao portal Azure, depois pesquisa e seleciona Azure Compute Gallery.

2. Selecione a galeria que deseja usar na lista.

3. Na página da sua galeria, selecione Adicionar na parte superior da página e, em seguida, selecione definição de imagem de VM na lista suspensa.

4. na página Adicionar nova definição de imagem à Azure Compute Gallery, no separador Básico, selecione uma Região.

5. Em Image definition name, digite um nome como myImageDefinition.

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

7. Para a geração de VMs, selecione a opção baseado na sua origem. Na maioria das vezes, será Gen 1. Para obter mais informações, consulte Suporte para VMs de 2ª geração.

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

9. Para Publisher, escreva um nome único como myPublisher.

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

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

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

13. Depois que a definição da imagem passar na validação, selecione Criar.

14. Quando a implantação estiver concluída, selecione Ir para recurso.

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

16. 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 não estiver a ver a sua origem listada em caixas de seleção posteriores, tente mudar a região da imagem. Você sempre pode replicar a imagem para outras regiões mais tarde.

17. Em Número da 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 fonte na lista suspensa. Consulte a tabela abaixo para obter detalhes específicos para cada tipo de fonte.

    Origem	Outros domínios
    Discos ou cópias instantâneas	- Para o disco do sistema operacional, selecione o disco ou instantâneo na lista suspensa. - Para adicionar um disco de dados, digite o identificador do LUN e selecione o disco de dados no menu suspenso.
    Versão da imagem	- Selecione a Galeria de 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.

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

20. Em Data de fim de vida, selecione uma data no calendário que indique quando esta versão deve deixar de ser utilizada.

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

22. Defina a contagem de réplica padrão, você pode substituí-la para cada região adicionada.

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

24. Quando terminar, selecione Rever e criar. O Azure irá validar a configuração.

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

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

Para criar uma imagem usando a CLI do Azure, primeiro precisa de criar uma definição de imagem. 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 tiveres generalizada a VM (usando waagent -deprovision para Linux, ou Sysprep para Windows), então deves 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 operativo 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 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.

Para obter exemplos detalhados de como especificar diferentes fontes para a sua imagem, consulte os exemplos de criação de versão de imagem do az sig.

No exemplo abaixo, estamos a criar 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 --virtual-machine 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 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Para criar uma imagem usando o PowerShell, primeiro precisa de criar uma definição de 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 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 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 chama-se myImageDefinition, e é para uma VM especializada a correr 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 de imagem usando New-AzGalleryImageVersion.

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

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, por isso criámos uma tarefa para termos a capacidade de acompanhar o progresso. Para ver o progresso 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 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 como origem (por exemplo, passe o ID do instantâneo do disco do sistema operativo).

# @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 a CLI do Azure para criar uma versão de imagem num tenant usando a versão da imagem de origem noutro tenant.

# 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 num tenant usando a versão da imagem de origem noutro tenant.

# 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