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. Vá para o portal do Azure e, em seguida, procure e selecione Galeria de Computação do Azure.

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 da VM na lista suspensa.

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

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

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. Em Publisher, digite um nome exclusivo 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 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.

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 principal.menor.formato de 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 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.

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 para quando você acha que essa 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é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 + criar. O Azure 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.

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

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

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'

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, pelo que criámos um emprego para podermos 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 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}"
            }
        }
    }
}

# 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
   --location myLocation

# 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