Crie uma instância que use endereços IPv6

Por predefinição, as instâncias do Compute Engine são criadas com endereços IPv4. Opcionalmente, pode criar instâncias de computação que usam endereços IPv6. As instâncias de computação que têm configurações IPv4 e IPv6 são denominadas instâncias de duplo stack. O endereço IPv6 é adicional a todos os endereços IPv4 configurados na interface de rede.

Pode configurar endereços IPv6 numa instância do Compute Engine se a sub-rede à qual a instância está ligada tiver um intervalo IPv6 configurado.

Qualquer interface de rede na instância de computação pode ter endereços IPv6 configurados. Para mais informações sobre a configuração de várias interfaces de rede, consulte o artigo Várias interfaces de rede.

O tipo de pilha da interface de rede de uma instância determina o tipo de sub-redes às quais se pode ligar:

  • As interfaces de rede apenas IPv4 podem ligar-se a sub-redes de pilha dupla e apenas IPv4.
  • As interfaces de rede de pilha dupla podem estabelecer ligação a sub-redes de pilha dupla.
  • As interfaces de rede apenas IPv6 podem estabelecer ligação a sub-redes de pilha dupla e apenas IPv6.

Além disso, a configuração do tipo de acesso IPv6 de uma sub-rede determina se a sub-rede tem um intervalo IPv6 interno ou externo. As instâncias ligadas herdam o tipo de acesso IPv6 da sub-rede.

Pode criar instâncias com endereços IPv6 atribuídos automaticamente pela Google Cloud ou com endereços IPv6 especificados por si. Pode especificar um endereço IPv6 estático ou um endereço IPv6 efémero personalizado.

Para mais informações sobre endereços IPv6, consulte o artigo Vista geral do IPv6.

Limitações

  • As instâncias apenas IPv6 são suportadas apenas com imagens do SO Ubuntu e Debian.

Antes de começar

  • Tem de criar a rede e as sub-redes antes de criar a instância de computação.
  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções necessárias

Para receber as autorizações de que precisa para criar uma instância com endereços IPv6, peça ao seu administrador para lhe conceder a função IAM Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Crie uma instância de pilha dupla

Para criar uma instância com um endereço IPv4 interno e um endereço IPv6 externo, associe a instância de computação a uma sub-rede de pilha dupla.

Se estiver a usar a VPC partilhada e quiser criar uma instância de pilha dupla que esteja ligada a uma sub-rede partilhada, consulte o artigo Criar uma instância na documentação da VPC partilhada.

Consola

  1. Aceda à página Criar uma instância.

    Aceda a Criar uma instância

  2. Se lhe for solicitado, selecione o seu projeto e clique em Continuar. É apresentada a página Criar uma instância e é apresentado o painel Configuração do computador.

  3. No painel Configuração da máquina, faça o seguinte:

    1. No campo Nome, especifique um nome para a instância. Para mais informações, consulte o artigo Atribuir nomes a recursos.
    2. Opcional: no campo Zona, selecione uma zona para esta instância. Escolha uma zona numa região que contenha uma sub-rede com um intervalo IPv6 configurado.

    3. Selecione a família de máquinas para a sua instância. A Google Cloud consola apresenta, em seguida, as séries de máquinas disponíveis para a família de máquinas selecionada. Estão disponíveis as seguintes opções de família de máquinas:

      • Utilização geral
      • Otimizado para computação
      • Otimizada para memória
      • Otimizado para armazenamento
      • GPUs

    4. Na coluna Série, selecione a série de máquinas para a sua instância.

    5. Na secção Tipo de máquina, selecione o tipo de máquina para a sua instância.

  4. No menu de navegação, clique em Rede. No painel Rede apresentado, faça o seguinte:

    1. Na secção Interfaces de rede, clique na interface de rede para a expandir e editar.

    2. Para Rede e Sub-rede, selecione a rede e a sub-rede que têm um intervalo IPv6 configurado.

    3. Para o Tipo de pilha de IP, selecione IPv4 e IPv6 (pilha dupla).

    4. Para Endereço IPv4 interno principal, selecione uma das seguintes opções:

      • Para atribuir um novo endereço interno IPv4 efémero, escolha Efémero.
      • Para atribuir um endereço IP externo estático existente, escolha o nome de um endereço IPv4 reservado na lista.
      • Para criar e atribuir um novo endereço IPv4 interno estático, escolha Reservar endereço IPv4 interno estático.

    5. Opcional: para o endereço IPv4 externo, selecione uma das seguintes opções:

      • Para atribuir um endereço IPv4 externo efémero, escolha Efémero.
      • Para criar uma instância sem um endereço IPv4 externo, escolha Nenhum.
      • Para atribuir um endereço IP externo estático existente, escolha o nome de um endereço IPv4 reservado na lista.
      • Para criar e atribuir um novo endereço IPv4 externo estático, escolha Reservar endereço IPv4 externo estático.

    6. Opcional: para configurar um endereço IPv6 externo, em Endereço IPv6 externo, selecione uma das seguintes opções:

      • Para atribuir automaticamente um novo endereço IPv6 externo efémero, escolha Efémero (automático).
      • Para especificar manualmente um novo endereço IPv6 externo efémero, escolha Efémero (personalizado).
      • Para atribuir um endereço IP externo estático existente, escolha o nome de um endereço IPv6 reservado na lista.
      • Para criar e atribuir um novo endereço IPv6 externo estático, escolha Reservar endereço IPv6 externo estático.

    7. Para terminar a modificação da interface de rede, clique em Concluído.

    8. Opcional: para configurar uma interface de rede adicional, clique em Adicionar uma interface de rede e repita os passos anteriores para o painel Rede.

  5. Opcional: especifique outras opções de configuração. Para mais informações, consulte o artigo Opções de configuração durante a criação da instância.

  6. Para criar e iniciar a instância, clique em Criar.

gcloud

Crie uma instância através do comando gcloud compute instances create. Para especificar endereços IPv6 personalizados, inclua os indicadores internal-ipv6-address e external-ipv6-address. Se não for especificado, os endereços IPv6 efémeros são automaticamente atribuídos à instância por Google Cloud.

gcloud compute instances create INSTANCE_NAME \
    --subnet=SUBNET_NAME \
    --zone=ZONE \
    --stack-type=IPV4_IPV6

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância
  • SUBNET_NAME: a sub-rede à qual a instância vai ser ligada; a sub-rede tem de ter um intervalo de sub-rede IPv6
  • ZONE: a zona na qual implementar a instância

REST

  1. Selecione uma imagem. Tome nota do nome da imagem ou da família de imagens e do nome do projeto que contém a imagem.

  2. Use o método instances.insert para criar uma instância a partir de uma família de imagens ou de uma versão específica de uma imagem do SO. Para especificar endereços IPv6 personalizados, inclua os campos networkInterfaces[].ipv6Address e networkInterfaces[].ipv6AccessConfigs[].externalIpv6. Se não for especificado, os endereços IPv6 efémeros são automaticamente atribuídos à instância por Google Cloud.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: ID do projeto no qual criar a instância.
    • ZONE: zona onde criar a instância.
    • MACHINE_TYPE_ZONE: se usar um tipo de máquina personalizado, especifique a zona que contém o tipo de máquina personalizado a usar para a nova instância; caso contrário, especifique a zona na qual criar a instância.
    • MACHINE_TYPE: tipo de máquina, predefinido ou personalizado, para a nova instância, por exemplo, n4-standard-2
    • INSTANCE_NAME: um nome para a nova instância
    • REGION: a região que contém a sub-rede
    • SUBNET: uma sub-rede de pilha dupla
    • IMAGE_PROJECT: opcional: o projeto de imagem que contém a imagem

    • IMAGE: Opcional: especifique uma das seguintes opções:

      • Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20241009
      • Uma família de imagens, que tem de ter o formato family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma instância com a versão mais recente da imagem do SO na família de imagens do Debian 12. Para mais informações sobre a utilização de famílias de imagens, consulte as práticas recomendadas para famílias de imagens.

    Método HTTP e URL: 

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

    Corpo JSON do pedido: 

    {
    "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "networkInterfaces": [
      {
        "subnetwork": "regions/REGION/subnetworks/SUBNET",
        "stackType": "IPV4_IPV6"
      }
    ],
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot": true
      }
    ],
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "kind": "compute#operation",
  "id": "9216044482154695709",
  "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
  "zone": "https://www.googleapis.com/compute/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`",
  "operationType": "insert",
  "targetLink": "https://www.googleapis.com/compute/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
  "targetId": "2679381553616227357",
  "status": "RUNNING",
  "user": "USER_ID",
  "progress": 0,
  "insertTime": "2025-02-10T09:10:10.551-08:00",
  "startTime": "2025-02-10T09:10:10.551-08:00",
  "selfLink": "https://www.googleapis.com/compute/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
 "kind": "compute#operation"
}

Crie uma instância apenas IPv6

Para criar uma instância apenas IPv6, siga os passos nesta secção.

Para uma instância do Compute Engine com uma única interface de rede, a instância pode ter um endereço IPv6 interno ou externo, consoante o tipo de acesso da rede à qual a respetiva interface está ligada. Tem de criar uma rede de nuvem virtual privada (VPC) no modo personalizado com uma sub-rede que tenha um intervalo de endereços IPv6.

Antes de poder criar uma instância de VM com várias NICs que use endereços IPv6 internos e externos, tem de criar o seguinte:

  • A rede e a sub-rede internas: uma rede VPC no modo personalizado com ULA IPv6 ativado, uma sub-rede com um intervalo de endereços IPv6 e o tipo de acesso definido como internal.
  • A rede e a sub-rede externas: uma segunda rede VPC no modo personalizado, uma segunda sub-rede com um intervalo de endereços IPv6 e o tipo de acesso definido como external.

Quando cria a instância, configura duas interfaces de rede, uma que se liga à sub-rede com o intervalo de endereços IPv6 interno e outra que se liga à sub-rede com o intervalo de endereços externo.

Se estiver a usar a VPC partilhada e quiser criar uma instância apenas IPv6 que esteja ligada a uma sub-rede partilhada, consulte o artigo Criar uma instância na documentação da VPC partilhada.

Consola

  1. Aceda à página Criar uma instância.

    Aceda a Criar uma instância

  2. Se lhe for solicitado, selecione o seu projeto e clique em Continuar. É apresentada a página Criar uma instância e é apresentado o painel Configuração do computador.

  3. No painel Configuração da máquina, faça o seguinte:

    1. No campo Nome, especifique um nome para a instância. Para mais informações, consulte Atribuir nomes a recursos.
    2. Opcional: no campo Zona, selecione uma zona para esta instância. Escolha uma zona numa região que contenha uma sub-rede com um intervalo IPv6 configurado.

    3. Selecione a família de máquinas para a sua instância. Em seguida, a Google Cloud consola apresenta as séries de máquinas que estão disponíveis para a família de máquinas selecionada. Estão disponíveis as seguintes opções de família de máquinas:

      • Utilização geral
      • Otimizado para computação
      • Otimizada para memória
      • Otimizado para armazenamento
      • GPUs

    4. Na coluna Série, selecione a série de máquinas para a sua instância.

    5. Na secção Tipo de máquina, selecione o tipo de máquina para a sua instância.

  4. No menu de navegação, clique em Rede. No painel Rede apresentado, faça o seguinte:

    1. Na secção Interfaces de rede, clique na interface de rede para a expandir e editar.

    2. Para Rede e Sub-rede, selecione a rede e a sub-rede que têm um intervalo IPv6 configurado.

      O tipo de acesso IPv6 da sub-rede determina se a instância recebe um endereço IPv6 interno ou um endereço IPv6 externo. Para atribuir um endereço IPv6 interno, tem de selecionar uma rede que foi criada com a opção Configurar um intervalo IPv6 interno ULA para esta rede VPC. Caso contrário, só pode configurar endereços IPv6 externos.

    3. Para o tipo de pilha de IP, selecione IPv6 (pilha única).

    4. Se selecionou uma sub-rede com um tipo de acesso de Internal, então, para o endereço IPv6 interno principal, selecione uma das seguintes opções:

      • Para atribuir automaticamente um novo endereço IPv6 interno efémero, escolha Efémero (automático).
      • Para especificar manualmente um novo endereço IPv6 interno efémero, escolha Efémero (personalizado).
      • Para atribuir um endereço IP interno estático existente, escolha o nome de um endereço IPv6 reservado na lista.
      • Para criar e atribuir um novo endereço IPv6 interno estático, escolha Reservar endereço IPv6 interno estático.

    5. Se selecionou uma sub-rede com um tipo de acesso de External, então, para o endereço IPv6 externo, selecione uma das seguintes opções:

      • Para atribuir automaticamente um novo endereço IPv6 externo efémero, escolha Efémero (automático).
      • Para especificar manualmente um novo endereço IPv6 externo efémero, escolha Efémero (personalizado).
      • Para atribuir um endereço IP externo estático existente, escolha o nome de um endereço IPv6 reservado na lista.
      • Para criar e atribuir um novo endereço IPv6 externo estático, escolha Reservar endereço IPv6 externo estático.

    6. Para terminar a modificação da interface de rede, clique em Concluído.

    7. Opcional: para adicionar um endereço IPv6 adicional, faça o seguinte:

      1. Selecione Adicionar uma interface de rede.
      2. Repita os passos anteriores nesta tarefa para o painel Rede.

  5. Opcional: especifique outras opções de configuração. Para mais informações, consulte o artigo Opções de configuração durante a criação da instância.

  6. Para criar e iniciar a instância, clique em Criar.

gcloud

Crie uma instância através do comando gcloud compute instances create. Para atribuir endereços IPv6 internos e externos, tem de criar a instância com, pelo menos, duas interfaces de rede. Para especificar endereços IPv6 personalizados, inclua os indicadores internal-ipv6-address e external-ipv6-address. Se não for especificado, os endereços IPv6 efémeros são atribuídos automaticamente à instância por Google Cloud.

gcloud compute instances create INSTANCE_NAME \
    --zone ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes,image='projects/IMAGE_PROJECT/global/images/IMAGE',size=SIZE \
    --network-interface=subnet=SUBNET_INTERNAL_NAME,stack-type=IPV6_ONLY \
    --network-interface=subnet=SUBNET_EXTERNAL_NAME,stack-type=IPV6_ONLY,ipv6-network-tier=PREMIUM

Substitua o seguinte:

  • INSTANCE_NAME: um nome para a instância
  • ZONE: a zona onde a instância é criada, como europe-west1-b. A região da instância é inferida a partir da zona.
  • MACHINE_TYPE: Opcional: tipo de máquina, predefinido ou personalizado, para a nova instância. Por exemplo, n4-standard-2.
  • IMAGE_PROJECT: Opcional: o projeto de imagem que contém a imagem
  • IMAGE: Opcional: especifique uma das seguintes opções:
    • Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v202410095.
    • Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma instância com a versão mais recente da imagem do SO na família de imagens Debian 12. Para mais informações sobre a utilização de famílias de imagens, consulte as práticas recomendadas para famílias de imagens.
  • SIZE: opcional: o tamanho do novo disco. O valor tem de ser um número inteiro. A unidade de medida predefinida é GiB.
  • SUBNET_INTERNAL_NAME: nome da sub-rede que está configurada para os endereços IP internos a usar com a instância.
  • SUBNET_EXTERNAL_NAME: nome da sub-rede que está configurada para os endereços IP externos a usar com a instância.

REST

  1. Selecione uma imagem. Tome nota do nome da imagem ou da família de imagens e do nome do projeto que contém a imagem.

  2. Use o método instances.insert para criar uma instância a partir de uma família de imagens ou de uma versão específica de uma imagem do SO. Para especificar endereços IPv6 personalizados, inclua os campos networkInterfaces[].ipv6Address e networkInterfaces[].ipv6AccessConfigs[].externalIpv6. Se não for especificado, os endereços IPv6 efémeros são automaticamente atribuídos à instância por Google Cloud.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: ID do projeto no qual criar a instância.
    • ZONE: zona onde criar a instância.
    • MACHINE_TYPE_ZONE: se usar um tipo de máquina personalizado, especifique a zona que contém o tipo de máquina personalizado a usar para a nova instância; caso contrário,especifique a zona na qual criar a instância.
    • MACHINE_TYPE: tipo de máquina, predefinido ou personalizado, para a nova instância, por exemplo, n4-standard-2.
    • INSTANCE_NAME: um nome para a nova instância
    • REGION: a região que contém a sub-rede
    • SUBNET_INTERNAL: uma sub-rede apenas IPv6. A rede para esta sub-rede tem de ter um tipo de acesso de INTERNAL e ter o IPv6 ULA ativado.
    • SUBNET_EXTERNAL: uma sub-rede apenas IPv6. A rede desta sub-rede tem de ter um tipo de acesso INTERNAL.
    • IMAGE_PROJECT: opcional: o projeto de imagem que contém a imagem

    • IMAGE: Opcional: especifique uma das seguintes opções:

      • Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20241009
      • Uma família de imagens, que tem de ter o formato family/IMAGE_FAMILY. Isto cria a instância a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar family/debian-12, o Compute Engine cria uma instância com a versão mais recente da imagem do SO na família de imagens do Debian 12. Para mais informações sobre a utilização de famílias de imagens, consulte as práticas recomendadas para famílias de imagens.

    Método HTTP e URL: 

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

    Corpo JSON do pedido: 

    {
    "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "networkInterfaces": [
      {
        "subnetwork": "regions/REGION/subnetworks/SUBNET_INTERNAL",
        "stackType": "IPV6_ONLY"
      },
      {
        "subnetwork": "regions/REGION/subnetworks/SUBNET_EXTERNAL",
        "stackType": "IPV6_ONLY"
      }
    ],
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"

        },
        "boot": true
      }
    ]
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "kind": "compute#operation",
  "id": "9216044482154695709",
  "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
  "zone": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`",
  "operationType": "insert",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
  "targetId": "2679381553616227357",
  "status": "RUNNING",
  "user": "USER_ID",
  "progress": 0,
  "insertTime": "2025-02-10T09:10:10.551-08:00",
  "startTime": "2025-02-10T09:10:10.551-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
 "kind": "compute#operation"
}

O que se segue?