Criar e iniciar uma instância de VM

Crie uma instância de máquina virtual (VM) usando uma imagem do disco de inicialização ou um snapshot de disco de inicialização. É possível criar uma VM com um ou mais discos ou adicionar discos mais tarde. O Google Distributed Cloud (GDC) com isolamento físico inicia automaticamente a instância de VM quando você a cria.

Também é possível adicionar scripts de inicialização a uma instância de VM, antes ou depois de criá-la.

Este documento é destinado a desenvolvedores em grupos de administradores de plataforma ou operadores de aplicativos que criam e gerenciam VMs em um ambiente do GDC. Para mais informações, consulte Públicos-alvo da documentação do GDC com isolamento físico.

Antes de começar

Observação :as importações de imagens, a listagem de imagens e a criação de instâncias de VM usando a CLI gdcloud ou a CLI kubectl são operações zonais. Ao importar ou listar imagens, ou ao criar VMs, é preciso segmentar a zona específica e o servidor de API de gerenciamento zonal em que você pretende executar a VM.

Para usar os comandos da interface de linha de comando (CLI) gdcloud, faça o download, instale e configure a CLI gdcloud. Todos os comandos do Distributed Cloud usam a CLI gdcloud ou kubectl e exigem um ambiente de sistema operacional (SO).

Acessar o caminho do arquivo kubeconfig

Para executar comandos no servidor de API Management, verifique se você tem os seguintes recursos:

1. Faça login e gere o arquivo kubeconfig para o servidor da API Management, se você não tiver um.

2. Use o caminho para o arquivo kubeconfig do servidor de API Management para substituir MANAGEMENT_API_SERVER nestas instruções.

Diretrizes de nomenclatura de VMs

Consulte as seguintes diretrizes de nomenclatura ao criar instâncias de VM:

• Os nomes de VM só podem conter caracteres alfanuméricos e traços.
• O uso de símbolos que não sejam caracteres alfanuméricos e traços, como um ponto, resulta em falhas de conexão com a VM.
• O nome da VM não pode ter mais de 53 caracteres.

Solicitar papéis do IAM

Para receber as permissões necessárias para criar e iniciar uma instância de VM, peça ao administrador do projeto do IAM para conceder a você os seguintes papéis no projeto:

• Administrador do projeto de máquina virtual (project-vm-admin): criar, modificar, listar e excluir VMs no namespace do projeto.

• Leitor do projeto (project-viewer): visualizar todos os recursos nos namespaces do projeto.

• Administrador do projeto de imagem de máquina virtual (project-vm-image-admin): criar, listar e excluir imagens de VM personalizadas e fornecidas pelo GDC no namespace do projeto.

Todos os papéis de VM precisam ser vinculados ao namespace do projeto em que a VM reside. Siga as etapas para verificar seu acesso.

Criar uma instância de VM a partir de uma imagem

Nesta seção, descrevemos como criar uma VM usando uma imagem do SO fornecida pelo GDC ou uma imagem do SO personalizada.

Ver uma lista de imagens disponíveis fornecidas pelo GDC

Antes de criar uma VM usando uma imagem fornecida pelo GDC, confira a lista de imagens disponíveis. Consulte as imagens de VM compatíveis para mais informações sobre as imagens fornecidas pelo GDC.

gdcloud

• Liste todas as imagens disponíveis e o tamanho mínimo de disco delas:

  gdcloud compute images list
  

  Esse comando inclui imagens personalizadas e fornecidas pelo GDC. Escolha uma das imagens no namespace vm-system.

API

1. Liste todas as imagens disponíveis fornecidas pelo GDC:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n vm-system \
     get virtualmachineimage.virtualmachine.gdc.goog
   

2. Consiga o minimumDiskSize de uma imagem específica fornecida pelo GDC:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n vm-system \
     get virtualmachineimage.virtualmachine.gdc.goog BOOT_DISK_IMAGE_NAME \
     -ojsonpath='{.spec.minimumDiskSize}{"\n"}'
   

   Substitua:

   • MANAGEMENT_API_SERVER: o arquivo kubeconfig do servidor de API de gerenciamento.
   • BOOT_DISK_IMAGE_NAME: o nome da imagem.

Criar uma instância de VM com base em uma imagem fornecida pelo GDC

Por padrão, todos os projetos do GDC podem criar VMs com base em imagens de SO fornecidas pelo GDC.

Console

1. No menu de navegação, selecione Máquinas virtuais > Instâncias.
2. Clique em Criar instância.
3. No campo Nome, especifique um nome para a VM.
4. Selecione a zona em que a VM será criada.
5. Opcional: clique em Adicionar rótulos para atribuir rótulos à VM. Isso ajuda a organizar as instâncias de VM.
6. Selecione a configuração de máquina a ser usada na VM:
   1. Uso geral: verifique se o tipo de máquina está alinhado aos requisitos da carga de trabalho.
   2. Personalizado: defina o número de núcleos e os requisitos de memória da máquina.
7. Clique em Próxima.
8. Se quiser ativar o acesso externo, selecione Permitir acesso externo.
9. Clique em Próxima.
10. Na seção Disco de inicialização, o GDC adiciona automaticamente um disco de inicialização com as configurações padrão. É possível manter essa configuração como está ou clicar em Alterar para modificar as configurações padrão:
    1. Na seção Detalhes do disco, modifique o Nome do disco.
    2. Na seção Configurações do disco, modifique o valor de Tamanho.
    3. Na seção Imagem de origem, clique no menu Nome da imagem e selecione uma das imagens.
    4. Marque ou desmarque Ativar a Inicialização segura. Se você estiver usando uma imagem do Windows, a Inicialização Segura precisa estar ativada.
    5. Selecione Manter disco ou Excluir disco para configurar a regra de exclusão de disco.
    6. Clique em Salvar.
11. Clique em Criar para gerar a instância de VM.

gdcloud

Observação: criar uma VM com base em uma imagem usando a CLI gdcloud é uma operação zonal. Verifique se o destino da CLI gdcloud corresponde à zona específica em que você importou ou listou a imagem.

1. Selecione uma imagem fornecida pelo GDC para criar a instância de VM na zona de destino:

   gdcloud compute instances create VM_NAME \
     --machine-type=MACHINE_TYPE \
     --image=BOOT_DISK_IMAGE_NAME \
     --image-project=vm-system \
     --boot-disk-size=BOOT_DISK_SIZE \
     --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE
   

   Substitua:

   Variável	Definição
   VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
   MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Para selecionar um tipo de máquina disponível, execute o seguinte: gdcloud compute machine-types list
   BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
   BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20GB. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
   NO_BOOT_DISK_AUTO_DELETE	Especifique true para manter o disco de inicialização ao excluir a instância de VM ou false para excluir o disco de inicialização automaticamente.

API

Observação: criar uma VM usando a API é uma operação zonal. Verifique se MANAGEMENT_API_SERVER aponta para o arquivo kubeconfig do servidor de API de gerenciamento zonal da zona em que você quer criar a VM.

1. Selecione uma imagem fornecida pelo GDC para criar a instância de VM na zona de destino:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     apply -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: vm-system
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
     - virtualMachineDiskRef:
         name: VM_BOOT_DISK_NAME
       boot: true
       autoDelete: BOOT_DISK_AUTO_DELETE
   EOF
   

   Substitua:

   Variável	Definição
   MANAGEMENT_API_SERVER	O arquivo kubeconfig do servidor de API de gerenciamento.
   PROJECT	O projeto do GDC para criar a VM.
   VM_BOOT_DISK_NAME	O nome do novo disco de inicialização da VM.
   BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
   BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20Gi. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
   VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
   MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Para selecionar um tipo de máquina disponível, execute o seguinte: kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
   BOOT_DISK_AUTO_DELETE	Especifique true para excluir automaticamente o disco de inicialização ao excluir a instância de VM ou false para mantê-lo.

2. Verifique se a VM foi criada e aguarde até que ela mostre o estado Running. O estado Running não indica que o SO está totalmente pronto e acessível.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     get virtualmachine.virtualmachine.gdc.goog VM_NAME
   

   Substitua VM_NAME e PROJECT pelo nome e projeto da VM.

   Para adicionar um script de inicialização à criação da instância de VM, siga as etapas fornecidas na página Usar um script de inicialização com uma instância de VM. Encerre a VM antes de adicionar o script.

Criar uma instância de VM com base em uma imagem personalizada

Uma imagem personalizada pertence exclusivamente ao seu projeto. Para criar uma VM com uma imagem personalizada, primeiro crie uma imagem personalizada no mesmo projeto.

Console

1. No menu de navegação, selecione Máquinas virtuais > Instâncias.
2. Clique em Criar instância.
3. No campo Nome, especifique um nome para a VM.
4. Selecione a zona em que a VM será criada.
5. Opcional: clique em Adicionar rótulos para atribuir rótulos à VM. Isso ajuda a organizar as instâncias de VM.
6. Selecione a configuração de máquina a ser usada na VM:
   1. Uso geral: verifique se o tipo de máquina está alinhado aos requisitos da carga de trabalho.
   2. Personalizado: defina o número de núcleos e os requisitos de memória da máquina.
7. Clique em Próxima.
8. Marque a caixa de seleção Permitir acesso externo para ativar o acesso externo à instância de VM.
9. Clique em Próxima.

10. Na seção Disco de inicialização, o GDC adiciona automaticamente um disco de inicialização com as configurações padrão. É possível manter essa configuração como está ou clicar em Alterar para modificar as configurações padrão:

    1. Na seção Detalhes do disco, modifique o Nome do disco.
    2. Na seção Configurações do disco, modifique o valor de Tamanho.
    3. Na seção Imagem de origem, clique no menu Nome da imagem e selecione uma das imagens com o subtexto Criada pelo cliente.

    4. Marque ou desmarque Ativar a Inicialização segura. Se você estiver usando uma imagem do Windows, a Inicialização Segura precisa estar ativada.

       Importante: para evitar erros de inicialização no modo Unified Extensible Firmware Interface (UEFI), verifique se a imagem personalizada é compatível com UEFI antes de ativar a Inicialização segura. Uma imagem compatível com UEFI requer uma tabela de partição GUID (GPT) e uma partição de sistema EFI (ESP) formatada em FAT32 com um carregador de inicialização estruturado corretamente.

    5. Selecione Manter disco ou Excluir disco para configurar a regra de exclusão de disco.

    6. Clique em Salvar.

11. Clique em Criar para gerar a instância de VM.

gdcloud

1. Liste todas as imagens personalizadas:

   gdcloud compute images list --no-standard-images=true
   

2. Crie a instância da VM.

   gdcloud compute instances create VM_NAME \
     --machine-type=MACHINE_TYPE \
     --image=BOOT_DISK_IMAGE_NAME \
     --boot-disk-size=BOOT_DISK_SIZE \
     --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE
   

   Substitua:

   Variável	Definição
   VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
   MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Para selecionar um tipo de máquina disponível, execute o seguinte: gdcloud compute machine-types list
   BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
   BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20GB. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
   NO_BOOT_DISK_AUTO_DELETE	Especifique true para manter o disco de inicialização ao excluir a instância de VM ou false para excluir o disco de inicialização automaticamente.

API

1. Liste todas as imagens personalizadas:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     get virtualmachineimage.virtualmachine.gdc.goog
   

   Consiga o minimumDiskSize de uma imagem específica para criar uma instância de VM:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     get virtualmachineimage.virtualmachine.gdc.goog BOOT_DISK_IMAGE_NAME \
     -ojsonpath='{.spec.minimumDiskSize}{"\n"}'
   

   Substitua:

   Variável	Definição
   MANAGEMENT_API_SERVER	O arquivo kubeconfig do servidor de API de gerenciamento.
   PROJECT	O projeto da imagem.
   BOOT_DISK_IMAGE_NAME	O nome da imagem personalizada.

2. Crie a instância da VM.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     apply -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
     - virtualMachineDiskRef:
         name: VM_BOOT_DISK_NAME
       boot: true
       autoDelete: BOOT_DISK_AUTO_DELETE
   EOF
   

   Substitua:

   Variável	Definição
   MANAGEMENT_API_SERVER	O arquivo kubeconfig do servidor de API de gerenciamento.
   PROJECT	O projeto do GDC para criar a VM.
   VM_BOOT_DISK_NAME	O nome do novo disco de inicialização da VM.
   BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
   BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20Gi. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
   VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
   MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Para selecionar um tipo de máquina disponível, execute o seguinte: kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
   BOOT_DISK_AUTO_DELETE	Especifique true para excluir automaticamente o disco de inicialização ao excluir a instância de VM ou false para mantê-lo.

3. Verifique se a VM foi criada e aguarde até que ela mostre que está no estado Running. Estar no estado Running não significa que o SO está totalmente pronto e acessível.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     get virtualmachine.virtualmachine.gdc.goog VM_NAME
   

   Substitua VM_NAME e PROJECT pelo nome e projeto da VM.

Criar uma instância de VM com discos extras que não são de inicialização

É possível criar discos que não são de inicialização ao criar uma VM. Cada disco extra pode ou não especificar uma origem de imagem. O último caso é para criar um disco em branco.

Console

1. No menu de navegação, selecione Máquinas virtuais > Instâncias.
2. Clique em Criar instância.
3. No campo Nome, especifique um nome para a VM.
4. Selecione a zona em que a VM será criada.
5. Opcional: clique em Adicionar rótulos para atribuir rótulos à VM. Isso ajuda a organizar as instâncias de VM.
6. Selecione a configuração de máquina a ser usada na VM:
   1. Uso geral: verifique se o tipo de máquina está alinhado aos requisitos da carga de trabalho.
   2. Personalizado: defina o número de núcleos e os requisitos de memória da máquina.
7. Clique em Próxima.
8. Marque a caixa de seleção Permitir acesso externo para ativar o acesso externo à instância de VM.
9. Clique em Próxima.
10. Na seção Disco de inicialização, o GDC adiciona automaticamente um disco de inicialização com as configurações padrão. É possível manter essa configuração como está ou clicar em Alterar para modificar as configurações padrão:
    1. Na seção Detalhes do disco, modifique o Nome do disco.
    2. Na seção Configurações do disco, modifique o valor de Tamanho.
    3. Na seção Imagem de origem, clique no menu Nome da imagem e selecione uma das imagens.
    4. Marque ou desmarque Ativar a Inicialização segura. Se você estiver usando uma imagem do Windows, a Inicialização Segura precisa estar ativada.
    5. Selecione Manter disco ou Excluir disco para configurar a regra de exclusão de disco.
    6. Clique em Salvar.
11. Para adicionar mais discos à instância de VM, selecione Adicionar novo disco:
    1. Atribua um nome ao disco da VM.
    2. Configure o tamanho do disco e as configurações de anexo.
    3. Clique em Salvar.
12. Clique em Criar para gerar a instância de VM.

gdcloud

1. Crie um disco de inicialização com base em uma imagem:

   gdcloud compute disks create VM_BOOT_DISK_NAME \
     --size=BOOT_DISK_SIZE \
     --image=BOOT_DISK_IMAGE_NAME \
     --image-project=BOOT_DISK_IMAGE_NAMESPACE
   

2. Crie um disco extra que não seja de inicialização com base em uma imagem:

   gdcloud compute disks create NON_BOOT_DISK_FROM_IMAGE \
     --size=NON_BOOT_DISK_SIZE \
     --image=NON_BOOT_DISK_IMAGE_NAME \
     --image-project=NON_BOOT_DISK_IMAGE_NAMESPACE
   

3. Crie o disco em branco que não é de inicialização:

   gdcloud compute disks create NON_BOOT_BLANK_DISK \
     --size=NON_BOOT_BLANK_DISK_SIZE
   

4. Crie uma instância com os discos das etapas anteriores:

   gdcloud compute instances create VM_NAME \
     --machine-type=MACHINE_TYPE \
     --disk=name=VM_BOOT_DISK_NAME,boot=true \
     --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE \
     --disk=name=NON_BOOT_DISK_FROM_IMAGE \
     --disk=name=NON_BOOT_BLANK_DISK
   

   Substitua:

   Variável	Definição
   VM_BOOT_DISK_NAME	O nome do novo disco de inicialização da VM.
   BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20GB. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
   BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
   BOOT_DISK_IMAGE_NAMESPACE	O namespace da imagem a ser usada para o novo disco de inicialização da VM. Use vm-system para uma imagem fornecida pelo GDC ou deixe o campo em branco para uma imagem personalizada.
   NON_BOOT_DISK_FROM_IMAGE	O nome do disco extra que não é de inicialização criado com base em uma imagem.
   NON_BOOT_DISK_SIZE	O tamanho do disco adicional que não é de inicialização, por exemplo, 20GB.
   NON_BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o disco que não é de inicialização.
   NON_BOOT_DISK_IMAGE_NAMESPACE	O namespace da imagem que será usada para o disco que não é de inicialização. Use vm-system para uma imagem fornecida pelo GDC ou deixe o campo em branco para uma imagem personalizada.
   NON_BOOT_BLANK_DISK	O nome do disco extra em branco que não é de inicialização.
   NON_BOOT_BLANK_DISK_SIZE	O tamanho do disco em branco adicional que não é de inicialização, por exemplo, 20GB.
   VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
   MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Para selecionar um tipo de máquina disponível, execute o seguinte: gdcloud compute machine-types list
   NO_BOOT_DISK_AUTO_DELETE	Especifique true para manter o disco de inicialização ao excluir a instância de VM ou false para excluir o disco de inicialização automaticamente.

API

1. Crie uma VM com um disco que não é de inicialização:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     apply -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: NON_BOOT_DISK_FROM_IMAGE
   spec:
     source:
       image:
         name: NON_BOOT_DISK_IMAGE_NAME
         namespace: NON_BOOT_DISK_IMAGE_NAMESPACE
     size: NON_BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: NON_BOOT_BLANK_DISK
   spec:
     size: NON_BOOT_BLANK_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: BOOT_DISK_IMAGE_NAMESPACE
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
     - virtualMachineDiskRef:
         name: VM_BOOT_DISK_NAME
       boot: true
       autoDelete: BOOT_DISK_AUTO_DELETE
     - virtualMachineDiskRef:
         name: NON_BOOT_DISK_FROM_IMAGE
     - virtualMachineDiskRef:
         name: NON_BOOT_BLANK_DISK
   EOF
   

   Substitua:

   Variável	Definição
   MANAGEMENT_API_SERVER	O arquivo kubeconfig do servidor de API de gerenciamento.
   PROJECT	O projeto do GDC a ser criado na VM.
   NON_BOOT_DISK_FROM_IMAGE	O nome do disco extra que não é de inicialização criado com base em uma imagem.
   NON_BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o disco que não é de inicialização.
   NON_BOOT_DISK_IMAGE_NAMESPACE	O namespace da imagem que será usada para o disco que não é de inicialização. Use vm-system para uma imagem fornecida pelo GDC ou em branco para uma imagem personalizada.
   NON_BOOT_DISK_SIZE	O tamanho do disco extra que não é de inicialização criado com base em uma imagem, por exemplo, 20Gi.
   NON_BOOT_BLANK_DISK	O nome do disco extra em branco que não é de inicialização.
   NON_BOOT_BLANK_DISK_SIZE	O tamanho do disco em branco adicional que não é de inicialização, por exemplo, 20Gi.
   VM_BOOT_DISK_NAME	O nome do novo disco de inicialização da VM.
   BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
   BOOT_DISK_IMAGE_NAMESPACE	O namespace da imagem a ser usada para o novo disco de inicialização da VM. Use o namespace vm-system para uma imagem fornecida pelo GDC ou em branco para uma imagem personalizada.
   BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20Gi. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
   VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
   MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Para selecionar um tipo de máquina disponível, execute o seguinte: kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
   BOOT_DISK_AUTO_DELETE	Especifique true para excluir automaticamente o disco de inicialização ao excluir a instância de VM ou false para mantê-lo.

   Formate e ative os discos antes de usá-los.

Criar uma VM com base em um snapshot ou backup

É possível criar uma nova VM a partir de um snapshot das seguintes maneiras:

• Restaurar um disco de inicialização de VM: se você fez backup do disco de inicialização de uma VM com um snapshot, use-o para criar uma nova VM. Para mais informações, consulte Restaurar um snapshot.
  • Restaurar um disco que não é de inicialização:se você fez backup de um disco que não é de inicialização com um snapshot, também poderá restaurá-lo para um novo disco que não seja de inicialização ao criar uma VM, usando as mesmas instruções.

Para criar mais de uma VM com o mesmo disco de inicialização, faça o seguinte:

1. Crie uma imagem personalizada.
2. Crie VMs com base nessa imagem sem usar um snapshot.

Criar uma instância de VM com um endereço IP e uma sub-rede especificados

Por padrão, é possível criar uma VM do GDC sem a especificação de rede. Esse tipo de VM se conecta à VPC padrão e atribui dinamicamente um endereço IP da sub-rede padrão. Para criar uma VM com as configurações padrão, consulte Criar uma VM com uma imagem fornecida pelo GDC.

Se você não quiser usar a configuração de endereço IP padrão para sua VM do GDC, crie uma VM com um endereço IP dinâmico ou estático:

• Endereço IP dinâmico de uma sub-rede personalizada: você cria uma sub-rede com um CIDR específico e uma VM com um endereço IP atribuído dinamicamente a partir desse CIDR.

• Endereço IP estático de uma sub-rede personalizada: crie uma sub-rede com um CIDR específico e uma VM com um endereço IP estático desse CIDR.

Para mais informações sobre a criação de sub-redes, consulte Sub-rede e endereços IP no GDC.

Nesta seção, mostramos como criar uma VM com um endereço IP atribuído dinamicamente ou com um endereço IP estático.

Criar uma VM com um endereço IP atribuído dinamicamente de uma sub-rede personalizada

Crie uma VM com um endereço IP atribuído dinamicamente de um CIDR específico:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     apply -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: vm-system
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
     - virtualMachineDiskRef:
         name: VM_BOOT_DISK_NAME
       boot: true
       autoDelete: BOOT_DISK_AUTO_DELETE
     network:
       interfaces:
       - network: NETWORK_NAME
         subnet: SUBNET_NAME
   EOF

Substitua as seguintes variáveis:

Variável	Definição
MANAGEMENT_API_SERVER	O arquivo kubeconfig do servidor de API de gerenciamento.
PROJECT	O projeto do GDC para criar a VM.
VM_BOOT_DISK_NAME	O nome do novo disco de inicialização da VM.
BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20Gi. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Selecione um tipo de máquina disponível: kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
BOOT_DISK_AUTO_DELETE	Especifique true para excluir automaticamente o disco de inicialização quando você excluir a instância de VM ou false para mantê-lo.
NETWORK_NAME	O nome da rede VPC, como default.
SUBNET_NAME	O nome da sub-rede personalizada.

Criar uma VM com um endereço IP estático de uma sub-rede

Crie uma VM com um endereço IP estático de uma sub-rede personalizada:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     apply  -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: vm-system
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
     - virtualMachineDiskRef:
         name: VM_BOOT_DISK_NAME
       boot: true
       autoDelete: BOOT_DISK_AUTO_DELETE
     network:
       interfaces:
       - network: NETWORK_NAME
         subnet: SUBNET_NAME
         ipAddresses:
         - address: IP_ADDRESS
   EOF

Substitua as seguintes variáveis:

Variável	Definição
MANAGEMENT_API_SERVER	O arquivo kubeconfig do servidor de API de gerenciamento.
PROJECT	O projeto do GDC para criar a VM.
VM_BOOT_DISK_NAME	O nome do novo disco de inicialização da VM.
BOOT_DISK_IMAGE_NAME	O nome da imagem que será usada para o novo disco de inicialização da VM.
BOOT_DISK_SIZE	O tamanho do disco de inicialização, como 20Gi. Esse valor precisa ser sempre maior ou igual ao minimumDiskSize da imagem do disco de inicialização.
VM_NAME	O nome da nova VM. O nome pode conter até 53 caracteres alfanuméricos e traços.
MACHINE_TYPE	O tipo de máquina predefinido para a nova VM. Para selecionar um tipo de máquina disponível, execute o seguinte: kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
BOOT_DISK_AUTO_DELETE	Especifique true para excluir automaticamente o disco de inicialização quando você excluir a instância de VM ou false para mantê-lo.
NETWORK_NAME	O nome da rede VPC, como default.
SUBNET_NAME	O nome da sub-rede personalizada.
IP_ADDRESS	O endereço IP. Ele precisa estar dentro do intervalo da sub-rede escolhida. Só é possível especificar um endereço IP no campo ipAddresses.

A seguir

• Imagens de VM compatíveis
• Criar imagens personalizadas
• Importar discos virtuais