Criar imagens personalizadas do BYOL do Windows

Windows

---

Para criar uma VM do Windows no Google Cloud, você precisa usar uma imagem de VM que tenha o Windows ou o Windows Server pré-instalado. O Google Cloud fornece imagens públicas para versões comumente usadas do Windows Server, mas essas imagens são adequadas apenas para licenciamento sob demanda. Para trazer sua própria licença do Windows (BYOL, na sigla em inglês), é necessário importar uma imagem atual ou criar uma imagem personalizada.

Neste guia, descrevemos como criar uma imagem personalizada usando as mesmas ferramentas e processos que o Google Cloud usa para criar as imagens públicas.

Para concluir este guia, você precisa ter:

• Um arquivo ISO que contém a mídia de instalação do Windows ou do Windows Server.
• Opcionalmente, um ou mais pacotes de atualização do Windows (no formato .msu) para aplicar à imagem.

Observação: para testar o processo de criação da imagem, use a mídia Avaliação do Windows Server.

Antes de começar

• Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

Entenda o processo de compilação

Para instalar o Windows do zero, uma abordagem comum é inicializar um computador de um arquivo DVD ou ISO que contenha os arquivos de instalação do Windows. Ao contrário de alguns hipervisores locais, o Compute Engine não permite a inicialização de um arquivo ISO.

Para instalar o Windows do zero, siga uma abordagem diferente que siga estas etapas:

1. Criação de um novo disco
2. Extraindo a imagem do Windows (install.wim da mídia de instalação) para o disco.
3. Adicionar os drivers necessários, configurar o Windows Setup para que ele seja executado sem necessidade e tornar o disco inicializável.
4. Inicializar a partir do novo disco para executar a Instalação do Windows.
5. Como instalar software adicional, incluindo o agente do SO convidado.
6. Como criar uma imagem a partir do disco.

Em vez de realizar essas etapas manualmente, este guia descreve como é possível usar o Cloud Build, a ferramenta daisy e os fluxos de trabalho de referência que estão disponíveis. no GitHub para automatizar o processo.

daisy é uma ferramenta de linha de comando de código aberto que permite executar fluxos de trabalho. Os fluxos de trabalho são criados como arquivos JSON e contêm uma sequência de etapas. Cada uma delas descreve uma operação do Compute Engine, como a criação de um disco ou o encerramento de uma instância de VM. Portanto, os fluxos de trabalho barulhentos são adequados para automatizar as etapas necessárias para criar uma imagem do Windows do zero.

Os fluxos de trabalho da lei para criar imagens personalizadas do Windows criam duas instâncias de VM temporárias. A primeira instância de VM (prefixada bootstrap) executa as etapas necessárias para criar um disco inicializável. A segunda instância de VM, prefixada install, executa a Configuração do Windows e executa todas as etapas restantes.

Prepare o projeto para criar imagens

Para evitar que a ferramenta da ferramenta interfira na instância ou na infraestrutura de VM, crie um projeto dedicado para a criação de imagens:

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Compute Engine API, Cloud Build API, and Cloud Storage API APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Compute Engine API, Cloud Build API, and Cloud Storage API APIs.

   Enable the APIs

Observação: o processo de build presume que seu projeto contém uma rede padrão. Se você desativou a criação de redes padrão na sua organização, crie manualmente uma rede VPC de modo automático chamada default.

As próximas etapas serão diferentes se você usar o Windows ou o Linux no computador local:

Windows

1. No computador local, abra uma janela do Windows PowerShell.

2. Inicialize uma variável:

   $PROJECT_ID = "PROJECT_ID"
   

   em que PROJECT_ID é o ID do projeto do Google Cloud que você criou na seção anterior.

3. Inicialize outra variável para que ela contenha o número do projeto:

   $PROJECT_NUMBER = gcloud projects describe $PROJECT_ID --format=value`(projectNumber`)
   

Linux

1. No computador local, abra uma janela de terminal.

2. Inicialize uma variável:

   PROJECT_ID=PROJECT_ID
   

   em que PROJECT_ID é o ID do projeto do Google Cloud que você criou na seção anterior.

3. Inicialize outra variável para que ela contenha o número do projeto:

   PROJECT_NUMBER=`gcloud projects describe $PROJECT_ID --format=value\(projectNumber\)`
   

Faça upload de arquivos de instalação

Agora você coleta todos os arquivos de instalação necessários para a imagem personalizada e os envia para um bucket do Cloud Storage. Ao armazenar os arquivos em um bucket do Cloud Storage, você garante que os arquivos possam ser acessados por daisy e pelas instâncias de VM temporárias que o daisy usa para criar a imagem.

1. No computador local, faça o download dos pacotes de instalação necessários:

   • CLI gcloud
   • Instalador off-line do Microsoft .NET Framework 4.8 para Windows
   • PowerShell 7.0 (ou posterior) (.msi)

2. Crie um novo bucket do Cloud Storage para armazenar os arquivos de instalação:

   gcloud storage buckets create gs://$PROJECT_ID-media --project=$PROJECT_ID
   

3. Conceda o papel Leitor de objetos do Storage ao Cloud Build para que ele possa ler os arquivos de instalação:

   gcloud storage buckets add-iam-policy-binding gs://$PROJECT_ID-media --member=serviceAccount:$[e-mail] --role=roles/storage.objectViewer
   

4. Faça o upload do pacote de instalação do PowerShell:

   gcloud storage cp POWERSHELL_PACKAGE gs://$PROJECT_ID-media/PowerShell.msi
   

   em que POWERSHELL_PACKAGE é o caminho para o pacote de instalação do PowerShell.

5. Faça upload do pacote de instalação do .NET Framework:

   gcloud storage cp DOTNET_PACKAGE gs://$PROJECT_ID-media/dotnet-sdk.exe
   

   em que DOTNET_PACKAGE é o caminho para o pacote de instalação do NET Framework.

6. Faça upload do pacote de instalação da CLI gcloud:

   gcloud storage cp CLOUDSDK_PACKAGE gs://$PROJECT_ID-media/GoogleCloudSDKInstaller.exe
   

   em que CLOUDSDK_PACKAGE é o caminho para o pacote de instalação da CLI gcloud.

7. Faça o upload do arquivo ISO que contém a mídia de instalação do Windows:

   gcloud storage cp ISO gs://$PROJECT_ID-media/
   

   em que ISO é o nome do arquivo ISO.

8. Opcionalmente, faça upload de pacotes de atualização adicionais:

   gcloud storage cp UPDATE_DIR/*.msu gs://$PROJECT_ID-media/updates/
   

   em que UPDATE_DIR é o diretório que contém os pacotes de atualização.

Agora você está pronto para criar a imagem personalizada.

Criar a imagem

A execução do fluxo de trabalho daisy para criar uma imagem personalizada leva até quatro horas. Em vez de executar daisy localmente, crie uma configuração do Cloud Build para permitir que o Cloud Build execute o fluxo de trabalho em segundo plano.

1. No computador local, clone o repositório do Git que contém os fluxos de trabalho daisy para criar imagens do Windows:

   git clone https://github.com/GoogleCloudPlatform/compute-image-tools.git
   

2. Alterne para o diretório windows:

   cd compute-image-tools/daisy_workflows/image_build/windows/
   

3. No diretório windows, você encontra uma seleção de arquivos com o sufixo .wf.json. Esses arquivos contêm definições de fluxo de trabalho Daisy para versões do Windows mais usadas:

   Versão do Windows	Arquivo de fluxo de trabalho
   Windows Server Core 2022 (64 bits)	windows-server-2022-dc-core-uefi-byol.wf.json
   Windows Server 2019 (64 bits)	windows-server-2019-dc-uefi-byol.wf.json
   Windows Server Core 2019 (64 bits)	windows-server-2019-dc-core-uefi-byol.wf.json
   Windows Server 2016 (64 bits)	windows-server-2016-dc-uefi-byol.wf.json
   Windows Server Core 2016 (64 bits)	windows-server-2016-dc-core-uefi-byol.wf.json
   Windows 11 21H2 (64 bits)	windows-11-21h2-ent-x64-uefi.wf.json
   Windows 11 22H2 (64 bits)	windows-11-22h2-ent-x64-uefi.wf.json
   Windows 11 23H2 (64 bits)	windows-11-23h2-ent-x64-uefi.wf.json
   Windows 10 21H2 (64 bits)	windows-10-21h2-ent-x64-uefi.wf.json
   Windows 10 22H2 (64 bits)	windows-10-22h2-ent-x64-uefi.wf.json

   Abra o arquivo de fluxo de trabalho que mais se aproxima da versão do Windows que você quer instalar. Se necessário, altere as configurações do Windows (edition) e da chave de licença (product_key) nos arquivos de fluxo de trabalho para que correspondam à mídia de instalação.

   Caso não tenha certeza sobre o nome correto, abra um prompt elevado do PowerShell e execute os seguintes comandos para listar todas as edições compatíveis com sua mídia de instalação:

   $IsoFile = "ISO"
   
   $Mount = Mount-DiskImage -ImagePath (Resolve-Path $IsoFile)
   
   $DriveLetter = ($Mount | Get-Volume).DriveLetter
   Get-WindowsImage -ImagePath "$($DriveLetter):\sources\install.wim" | select ImageName
   
   Dismount-DiskImage -InputObject $Mount | Out-Null
   

   Substitua ISO pelo caminho local para a imagem ISO.

4. No diretório windows, crie um novo arquivo chamado cloudbuild.yaml e cole o seguinte código:

   timeout: 14400s  # 4 hour timeout for entire build
   steps:
   - name: 'gcr.io/compute-image-tools/daisy'
     timeout: 14400s  # 4 hour timeout for build step
     waitFor: ['-']
     args:
       - -project=$PROJECT_ID
       - -zone=us-central1-a
       - -var:updates=gs://$PROJECT_ID-media/updates/
       - -var:pwsh=gs://$PROJECT_ID-media/PowerShell.msi
       - -var:dotnet48=gs://$PROJECT_ID-media/dotnet-sdk.exe
       - -var:cloudsdk=gs://$PROJECT_ID-media/GoogleCloudSDKInstaller.exe
       - -var:media=gs://$PROJECT_ID-media/ISO
       - WORKFLOW
   

   Substitua:

   • ISO: nome do arquivo ISO no Cloud Storage.
   • WORKFLOW: nome do arquivo de fluxo de trabalho que corresponde à versão do Windows que você está usando.
   Observação: alguns fluxos de trabalho são compatíveis com parâmetros opcionais para personalizar o processo de compilação. Encontre a lista completa de parâmetros na seção Vars do arquivo de fluxo de trabalho.

5. Envie a compilação para o Cloud Build.

   gcloud builds submit --project $PROJECT_ID --async
   

   A compilação leva cerca de quatro horas para ser concluída. É possível acompanhar o status da build no console do Google Cloud em Cloud Build > Histórico.

   Histórico do Cloud Build

Usar a imagem personalizada

Após a conclusão da criação, é possível encontrar a imagem BYOL personalizada no console do Google Cloud em Compute Engine > Imagens.

Para ajudar a diferenciar entre várias versões da mesma imagem, o processo de criação incorpora um carimbo de data/hora no nome da imagem, por exemplo, windows-server-2019-dc-v1613488342. Além disso, o processo associa a imagem a uma família de imagens personalizada, por exemplo, windows-server-2019.

Para criar uma instância de VM que usa a imagem BYOL personalizada, você precisa provisionar a instância de VM em um nó de locatário individual.

Observação: o processo de criação da imagem não configura um servidor KMS. Se você usa uma cópia licenciada por volume do Windows Server, é necessário configurar um servidor KMS antes de ativar o Windows Server.

Solução de problemas

Se você suspeitar que o processo de compilação falhou ou não progrediu, use as seguintes abordagens para diagnosticar a situação:

• Verifique se você fez upload dos pacotes de instalação e do arquivo ISO corretos.
• Verifique se você selecionou um fluxo de trabalho que corresponde à versão do Windows do arquivo ISO.
• Verifique o registro de criação no Cloud Build e verifique se há mensagens de erro.
• Se a compilação parecer travada, analise a saída da porta serial da instância de VM criada pela compilação e verifique se há mensagens de erro.

A seguir

• Saiba mais sobre a ferramenta Mandale.
• Saiba mais sobre fluxos de trabalho simples para criar imagens.
• Saiba como trazer licenças atuais para o Compute Engine.
• Leia sobre as práticas recomendadas para trabalhar com famílias de imagens.