Criar imagem de VM Local do Azure usando imagens do Azure Marketplace

Aplica-se a: implantações hiperconvergadas do Azure Local 2311.2 e posterior

Este artigo explica como criar imagens de VM (máquina virtual) do Windows para o Azure Local usando imagens de origem do Azure Marketplace, por meio do portal do Azure ou da CLI do Azure.

Para criar imagens de VM do Linux no Azure Marketplace, escolha:

• Prepare a imagem do RHEL Azure Marketplace para a implantação de VM local do Azure.

• Prepare a imagem do Azure Marketplace do Ubuntu para VMs locais do Azure.

Pré-requisitos

Antes de começar, certifique-se de concluir os pré-requisitos a seguir.

CLI do Azure

• Examine e conclua os pré-requisitos.

• Atribua a função Azure Connected Machine Resource Manager ao aplicativo do provedor de recursos Microsoft.AzureStackHCI para o grupo de recursos no qual você deseja baixar a imagem. Para obter mais informações, confira Atribuir funções do Azure.

• Registre sua assinatura com o Microsoft.EdgeMarketplace provedor de recursos. Para obter mais informações, consulte Registro de provedor de recursos.

• Se você estiver usando um cliente para se conectar à instância local do Azure, consulte Conectar-se ao sistema remotamente.

Portal do Azure

• Examine e conclua os pré-requisitos.

• Atribua a função Azure Connected Machine Resource Manager ao app do provedor de recursos Microsoft.AzureStackHCI para o grupo de recursos em que você deseja baixar a imagem. Para obter mais informações, confira Atribuir funções do Azure.

• Registre sua assinatura com o Microsoft.EdgeMarketplace provedor de recursos. Para obter mais informações, consulte Registro de provedor de recursos.

Adicionar imagem de VM do Azure Marketplace

Crie uma imagem de VM a partir de uma imagem do Azure Marketplace. Use essa imagem para implantar VMs em sua instância local do Azure.

CLI do Azure

Siga estas etapas para criar uma imagem de VM usando a CLI do Azure.

Entrar e definir assinatura

1. Conecte-se a um computador em seu Azure Local.

2. Entrar. Tipo:

   az login --use-device-code
   

3. Defina sua assinatura.

   az account set --subscription <Subscription ID>
   

Defina alguns parâmetros

1. Defina parâmetros para sua assinatura, grupo de recursos, local e tipo de sistema operacional para a imagem. Substitua os parâmetros no < > pelos valores apropriados.

   $subscription = "<Subscription ID>"
   $resource_group = "<Resource group>"
   $mktplaceImage = "<Marketplace image name>"
   $customLocationName = "<Custom location name>"
   $customLocationID = (az customlocation show --resource-group $resource_group --name "<custom_location_name_for_Azure_Local>" --query id -o tsv)
   $location = "<Location for your Azure Local>"
   $osType = "<OS of source image>"
   $version = "<OS version of Marketplace image>"
   

   Os parâmetros estão descritos na tabela a seguir:

   Parâmetro	Descrição
   subscription	Assinatura associada ao Azure Local.
   resource-group	Grupo de recursos do Azure Local que você associa à imagem do Marketplace.
   name	Nome da imagem do Marketplace para o Azure Local.
   customLocation	ID do recurso do local personalizado para o Azure Local.
   location	Localização do seu Azure Local. Por exemplo, eastus.
   os-type	Sistema operacional associado à imagem de origem. Por exemplo, Windows ou Linux.
   version	(Opcional) Especifique a versão do sistema operacional para a imagem do Marketplace. Se deixado vazio, ele usa como padrão a versão mais recente.

   Aqui está um exemplo de saída:

   PS C:\Users\azcli> $subscription = "<Subscription ID>"
   PS C:\Users\azcli> $resource_group = "mylocal-rg"
   PS C:\Users\azcli> $mktplaceImage= "mylocal-marketplaceimage"
   PS C:\Users\azcli> $customLocationName = "mylocal-cl"
   PS C:\Users\azcli> $customerLocationID /subscriptions$subscription/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName
   PS C:\Users\azcli> $location = "eastus"
   PS C:\Users\azcli> $ostype = "Windows"
   PS C:\Users\azcli> $version = "26100.4652.250808"
   

Observação

Se você encontrar problemas de compatibilidade, verifique a versão da imagem da VM. A CLI do Azure sempre usa como padrão a versão mais recente.

Criar imagem de VM com base na imagem do Marketplace

1. Defina parâmetros adicionais que especificam a imagem de VM pretendida que você deseja criar. Você precisa incluir a oferta, o publicador, o SKU e a versão para a imagem do marketplace. Substitua os parâmetros em < > pelos valores apropriados:

   $publisher = "<Publisher name>"
   $offer = "<OS offer>"
   $sku = "<Image SKU>"
   

   Use a tabela a seguir para encontrar as imagens do marketplace disponíveis e seus valores de atributo:

   Nome	Publicador	Oferta	SKU
   Windows 11 Enterprise com múltiplas sessões + Microsoft 365	MicrosoftWindowsDesktop	escritório-365	win11-23h2-avd-m365 win11-24h2-avd-m365
   Windows 10 Enterprise de várias sessões + Microsoft 365	MicrosoftWindowsDesktop	escritório-365	win10-21h2-avd-m365
   Windows 11 Pro	MicrosoftWindowsDesktop	Windows-11	win11-23h2-pro
   Windows 11 Enterprise	MicrosoftWindowsDesktop	Windows-11	win11-22h2-ent win11-23h2-ent win11-24h2-ent
   Windows 11 Enterprise de várias sessões	MicrosoftWindowsDesktop	Windows-11	win11-22h2-avd win11-23h2-avd win11-24h2-avd
   Windows 10 Pro	MicrosoftWindowsDesktop	Windows 10	win10-22h2-pro-g2
   Windows 10 Enterprise	MicrosoftWindowsDesktop	Windows 10	win10-22h2-ent-g2
   Windows 10 Enterprise com várias sessões	MicrosoftWindowsDesktop	Windows 10	win10-22h2-avd
   Windows Server 2025 Datacenter: Azure Edition	microsoftwindowsserver	windowsserver	2025-datacenter-azure-edition-smalldisk 2025-datacenter-azure-edition-core 2025-datacenter-azure-edition
   Windows Server 2022 Datacenter: Azure Edition	microsoftwindowsserver	windowsserver	2022-datacenter-azure-edition-hotpatch 2022-datacenter-azure-edition-core 2022-datacenter-azure-edition
   Windows Server 2019	microsoftwindowsserver	windowsserver	2019-datacenter-gensecond 2019-datacenter-core-g2
   SQL Server 2022 Enterprise no Windows Server 2022	microsoftsqlserver	sql2022-ws2022	enterprise-gen2 standard-gen2

   Se você quiser criar uma imagem do Datacenter do Windows Server 2019, use os seguintes parâmetros:

   $publisher = "microsoftwindowsserver" 
   $offer = "windowsserver" 
   $sku = "2019-datacenter-gensecond"
   

2. Crie a imagem da VM começando com uma imagem do marketplace especificada:

   az stack-hci-vm image create --resource-group $resource_group --custom-location $customLocationID --name $mktplaceImage --os-type $ostype --offer $offer --publisher $publisher --sku $sku --version $version
   

Aqui está um exemplo de saída:

PS C:\Users\azcli> az stack-hci-vm image create --custom-location $cl --name $mktplaceImage --os-type $ostype --resource-group $rg --publisher $publisher --offer $offer --sku $sku  --version $version

{
  "extendedLocation": { 
    "name": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl", 
    "type": "CustomLocation" 
  }, 
  "id": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage", 
  "location": "eastus", 
  "name": "myhci-marketplaceimage", 
  "properties": { 
    "cloudInitDataSource": null, 
    "containerId": null, 
    "hyperVGeneration": null, 
    "identifier": { 
      "offer": "windowsserver", 
      "publisher": "microsoftwindowsserver", 
      "sku": "2019-datacenter-gensecond" 
    }, 
    "osType": "Windows", 
    "provisioningState": "Succeeded", 
    "status": { 
      "downloadStatus": { 
        "downloadSizeInMb": 10832 
      }, 
      "errorCode": "", 
      "errorMessage": "", 
      "progressPercentage": 100, 
      "provisioningStatus": { 
        "operationId": "13efc468-7473-429f-911b-858c1e6fc1d5*B11A62EE76B08EF194F8293CDD40F7BC71BFB93255D5A99DD11B4167690752D9", 
        "status": "Succeeded" 
      } 
    },
    "version": {
      "name": "17763.7922.251021",
      "properties": {
        "storageProfile": {
          "osDiskImage": {
            "sizeInMB": 130050
          }
        }
      }
    }
  },
  "resourceGroup": "mylocal-rg", 
  "systemData": { 
    "createdAt": "2024-09-23T18:53:13.734389+00:00", 
    "createdBy": "guspinto@contoso.com", 
    "createdByType": "User", 
    "lastModifiedAt": "2024-09-23T19:06:07.532276+00:00", 
    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05", 
    "lastModifiedByType": "Application" 
  },
  "tags": null, 
  "type": "microsoft.azurestackhci/marketplacegalleryimages" 
}

Para obter mais informações sobre esse comando da CLI, consulte az stack-hci-vm image.

Portal do Azure

Siga estas etapas para criar uma imagem de VM usando o portal do Azure. No portal do Azure para seu recurso local do Azure, execute as seguintes etapas:

1. Vá para Recursos>Imagens de VM.

2. Selecione + Adicionar Imagem de VM e, na lista suspensa, selecione Adicionar imagem de VM do Azure Marketplace.

   

3. Na página Criar uma imagem , na guia Noções básicas, insira as seguintes informações:

   1. Assinatura: selecione uma assinatura para associar à sua imagem de VM.

   2. Grupo de recursos: crie um grupo de recursos novo ou selecione um grupo de recursos existente associado à imagem da VM.

   3. Local personalizado: selecione um local personalizado para implantar sua imagem de VM. O local personalizado deve corresponder ao local personalizado do Azure Local.

   4. Imagem a ser baixada: selecione uma imagem de VM na lista de imagens no Azure Marketplace. A lista suspensa mostra todas as imagens do Azure Marketplace compatíveis com o Azure Local.

   5. Salve a imagem como: insira um nome para sua imagem de VM.

   6. Caminho de armazenamento: selecione o caminho de armazenamento para sua imagem de VM. Selecione Escolher automaticamente para que um caminho de armazenamento com alta disponibilidade seja selecionado automaticamente. Selecione Escolher manualmente para especificar um caminho de armazenamento para armazenar imagens de VM e arquivos de configuração na instância local do Azure. Nesse caso, verifique se o caminho de armazenamento especificado tem espaço de armazenamento suficiente.

4. Selecione Examinar + Criar para criar sua imagem de VM.

   

5. Os parâmetros de entrada são validados. Se as validações forem bem-sucedidas, você poderá examinar os detalhes da imagem da VM e selecionar Criar.

   

6. É iniciado um trabalho de implantação de modelo do Azure Resource Manager para a imagem da VM. A implantação da imagem leva alguns minutos para ser concluída. O tempo necessário para baixar a imagem depende do tamanho da imagem do Marketplace e da largura de banda de rede disponível para o download.

   

   Você pode acompanhar a implantação da imagem na grade de imagens da VM. Você pode ver a lista das imagens de VM que já foram baixadas e as que estão sendo baixadas no sistema.

   Para exibir mais detalhes de qualquer imagem, selecione o nome da imagem da VM na lista de imagens da VM.

7. Quando o download da imagem for concluído, a imagem da VM será exibida na lista de imagens e o Status será exibido como Disponível.

   

   Se o download da imagem da VM falhar, os detalhes do erro serão mostrados no portal.

   

Atualizar imagem da VM

Importante

As atualizações mais recentes podem levar algum tempo para refletir sobre suas imagens de VM à medida que mais validações são executadas.

Quando uma nova imagem atualizada está disponível no Azure Marketplace, as imagens de VM no Azure Local ficam desatualizadas e você deve atualizá-las. A operação de atualização não é uma atualização in-loco da imagem. Em vez disso, você pode visualizar quais imagens de máquinas virtuais têm uma nova versão disponível e selecionar imagens para atualizar. Depois de atualizar, a operação de criação de imagem de VM usa a nova imagem atualizada.

Para atualizar uma imagem de VM, use as etapas a seguir no portal do Azure.

1. Para verificar se uma atualização está disponível, selecione uma imagem de VM no modo de exibição de lista.

   

   No painel Visão geral, você verá um banner que mostra a nova imagem de VM disponível para download, se houver uma disponível. Para atualizar para a nova imagem, selecione o ícone de seta.

   

2. Examine os detalhes da imagem e selecione Examinar e criar. Por padrão, a nova imagem usa o mesmo grupo de recursos e detalhes de instância que a imagem anterior.

   O nome da nova imagem é incrementado com base no nome da imagem anterior. Por exemplo, uma imagem existente chamada winServer2022-01 tem uma imagem atualizada chamada winServer2022-02.

   

3. Para concluir a operação, selecione Criar.

   

   Depois que a nova imagem de VM for criada, crie uma VM usando a nova imagem e verifique se a VM funciona corretamente. Após a verificação, você pode excluir a imagem da VM antiga.

Próximas etapas

• Criar redes lógicas
• Gerenciar imagens de VM no Azure Local por meio da CLI do Azure e do portal do Azure