Criar e gerenciar discos regionais

Console

1. No console Trusted Cloud , acesse a página Discos.

   Acessar "Discos"

2. Selecione o projeto necessário.

3. Clique em Criar disco.

4. Especifique um Nome para o disco.

5. Em Local, escolha Regional.

6. Selecione a Região e a Zona. É preciso selecionar a mesma região ao criar a instância.

7. Selecione a Zona de réplica na mesma região. Anote as zonas selecionadas porque você precisa anexar o disco à instância em uma delas.

8. Selecione o Tipo de origem do disco.

9. Em Configurações de disco, escolha um Tipo de disco e um Tamanho. Também é possível mudar as configurações padrão de IOPS provisionadas e Capacidade de processamento provisionada.

10. Opcional: para volumes do Hyperdisk Balanced High Availability, é possível ativar a anexação do disco a várias instâncias criando o disco no modo de vários gravadores. Em Modo de acesso, selecione Leitura e gravação de várias VMs.

11. Clique em Criar para concluir a criação do disco.

gcloud

Crie um disco regional usando o comando compute disks create.

gcloud compute disks create DISK_NAME \
   --size=DISK_SIZE \
   --type=DISK_TYPE \
   --region=REGION \
   --replica-zones=ZONE1,ZONE2
   --access-mode=DISK_ACCESS_MODE

Substitua:

• DISK_NAME: o nome do novo disco
• DISK_SIZE: o tamanho do novo disco em GB.
• DISK_TYPE: Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.
• REGION: a região do disco regional, por exemplo, europe-west1.
• ZONE1, ZONE2: as zonas dentro da região em que as duas réplicas de disco estão localizadas, por exemplo: europe-west1-b,europe-west1-c

• DISK_ACCESS_MODE: opcional: especifica como as instâncias podem acessar os dados em um disco de alta disponibilidade equilibrado do Hyperdisk. Os valores a seguir são aceitos:

  • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Esse é o padrão.
  • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.

  Só é possível definir o modo de acesso para discos do Hyperdisk Balanced High Availability.

Terraform

Para criar um Hyperdisk Balanced High Availability, use o recurso google_compute_region_disk.

resource "google_compute_region_disk" "regiondisk" {
  name                      = "region-disk-name"
  snapshot                  = google_compute_snapshot.snapdisk.id
  type                      = "pd-ssd"
  region                    = "us-central1"
  physical_block_size_bytes = 4096
  size                      = 11

  replica_zones = ["us-central1-a", "us-central1-f"]
}

REST

Para criar um Hyperdisk Balanced High Availability, crie uma solicitação POST para o método compute.regionDisks.insert.

Para criar um disco vazio, não especifique uma origem de snapshot.

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/disks
{
  "name": "DISK_NAME",
  "region": "projects/PROJECT_ID/regions/REGION",
  "replicaZones": [
    "projects/PROJECT_ID/zones/ZONE1",
    "projects/PROJECT_ID/zones/ZONE2"
  ],
  "sizeGb": "DISK_SIZE",
  "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE",
  "accessMode": "DISK_ACCESS_MODE"
}

Substitua:

• PROJECT_ID: ID do projeto
• REGION: a região do disco regional, por exemplo, europe-west1.
• DISK_NAME: o nome do novo disco
• ZONE1, ZONE2: as zonas em que as réplicas do novo disco precisam estar localizadas.
• DISK_SIZE: o tamanho do novo disco em GB.
• DISK_TYPE: Para o Hyperdisk, especifique o valor hyperdisk-balanced-high-availability.

• DISK_ACCESS_MODE: opcional: especifica como as instâncias podem acessar os dados no disco de alta disponibilidade do Hyperdisk Balanced. Os valores a seguir são compatíveis:

  • READ_WRITE_SINGLE, para acesso de leitura e gravação de uma instância. Esse é o padrão.
  • READ_WRITE_MANY, para acesso de leitura e gravação de várias instâncias.

  Só é possível definir o modo de acesso para discos do Hyperdisk Balanced High Availability.

Console

1. Para anexar um disco a uma instância, acesse a página Instâncias de VM.

   Acessar instâncias de VM

2. Na coluna Nome, clique no nome da instância.

3. Clique em Editar edit.

4. Clique em Anexar disco atual.

5. Escolha o disco regional criado anteriormente para adicionar à instância.

6. Se você vir um aviso indicando que o disco selecionado já está anexado a outra instância, marque a caixa Forçar anexação de disco para forçar a anexação do disco à instância em que você está editando.

   Confira os casos de uso para anexação forçada de discos regionais em Failover de disco regional.

7. Opcional: se você estiver anexando um disco do Hyperdisk Balanced High Availability a várias instâncias, em Modo de anexo de disco, selecione Leitura/gravação.

8. Clique em Salvar.

9. Na página Editar VM, clique em Salvar.

gcloud

Para anexar um disco regional a uma instância em execução ou parada, use o comando compute instances attach-disk com a flag --disk-scope definida como regional.

Se você anexar um disco do Hyperdisk Balanced High Availability no modo de vários gravadores a várias instâncias, o único modo de anexação compatível será rw, que é o modo de acesso padrão. Não é necessário incluir a flag --mode.

gcloud compute instances attach-disk INSTANCE_NAME \
    --disk=DISK_NAME \
    --disk-scope=regional \
    --device-name=DEVICE_NAME

Substitua:

• INSTANCE_NAME: o nome da instância a que você está adicionando o disco regional.
• DISK_NAME: o nome do novo disco que você está anexando à instância.
• DEVICE_NAME (opcional): um nome que o SO convidado usa para criar um link simbólico, que ajuda a identificar o disco no nível do SO.

Terraform

Para anexar um Hyperdisk Balanced High Availability a uma instância, use o recurso google_compute_attached_disk.

resource "google_compute_instance" "test_node" {
  name         = "test-node"
  machine_type = "f1-micro"
  zone         = "us-west1-a"

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  attached_disk {
    source      = google_compute_disk.default.id
    device_name = google_compute_disk.default.name
  }

  network_interface {
    network = "default"
    access_config {
      # Ephemeral IP
    }
  }

  # Ignore changes for persistent disk attachments
  lifecycle {
    ignore_changes = [attached_disk]
  }


}

REST

Para anexar um disco regional a uma instância em execução ou interrompida, crie uma solicitação POST para o método compute.instances.attachDisk e inclua o URL do disco regional que você criou.

Se você anexar um disco do Hyperdisk Balanced High Availability no modo de vários gravadores a várias instâncias, o único modo de anexação compatível será READ-WRITE, que é o modo de acesso padrão. Não é necessário incluir a propriedade mode.

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
{
  "source": "/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME",
  "deviceName": DEVICE_NAME
}

Substitua:

• PROJECT_ID: o ID do projeto;
• ZONE: o local da instância;
• INSTANCE_NAME: o nome da instância a que você está adicionando o novo disco regional.
• REGION: a região em que o disco está localizado
• DISK_NAME: o nome do disco regional (como mostrado no console do Trusted Cloud ).
• DEVICE_NAME (opcional): um nome que o SO convidado usa para criar um link simbólico, que ajuda a identificar o disco no nível do SO.

Console

1. No console Trusted Cloud , acesse a página Criar uma instância.

   Acesse "Criar uma instância"

   Se solicitado, selecione o projeto e clique em Continuar.

   A página Criar uma instância aparece e mostra o painel Configuração da máquina.

2. 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 Convenção de nomenclatura de recursos.

   2. Opcional: no campo Zona, selecione uma zona para esta instância.

      A seleção padrão é Qualquer. Se você não mudar essa seleção padrão, o Google vai escolher automaticamente uma zona com base no tipo de máquina e na disponibilidade.

   3. Selecione uma família de máquinas para sua instância em uma das seguintes opções:

      • Uso geral
      • Otimizado para computação
      • Otimização de memória
      • Otimizado para armazenamento
      • GPUs

      O console do Trusted Cloud mostra as séries de máquinas disponíveis para a família selecionada.

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

      Se você selecionou GPUs como a família de máquinas na etapa anterior, selecione o Tipo de GPU desejado. A série de máquinas é selecionada automaticamente para o tipo de GPU escolhido.

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

3. No menu de navegação, clique em SO e armazenamento. No painel Sistema operacional e armazenamento, siga estas etapas:

   Para saber mais sobre os parâmetros que podem ser configurados ao adicionar novos discos, consulte Sobre o disco permanente e Sobre o Google Cloud Hyperdisk.

   1. Para começar a configurar o disco de inicialização, clique em Mudar. O painel Disco de inicialização aparece e mostra a guia Imagens públicas.

   2. Configure a fonte de dados para o disco de inicialização de uma das seguintes maneiras:

      • Para escolher um snapshot padrão como a fonte de dados do disco de inicialização, clique em Snapshots e, na guia Snapshots que aparece, especifique o seguinte:

        1. Na lista Snapshot, selecione o snapshot.
        2. Na lista Tipo de disco de inicialização, selecione o tipo de disco de inicialização.
        3. No campo Tamanho (GB), especifique o tamanho do disco de inicialização.

      • Para escolher um snapshot de arquivo como a fonte de dados do disco de inicialização, clique em Snapshots de arquivo e, na guia Snapshots de arquivo que aparece, especifique o seguinte:

        1. Na lista Snapshot do arquivo, selecione o snapshot.
        2. Na lista Tipo de disco de inicialização, selecione o tipo de disco de inicialização.
        3. No campo Tamanho (GB), especifique o tamanho do disco de inicialização.

      • Para escolher um disco atual como disco de inicialização, clique em Discos atuais. Em seguida, na guia Discos atuais que aparece, selecione um Persistent Disk regional ou um volume do Hyperdisk Balanced High Availability na lista Disco.

   3. Opcional: para opções avançadas de configuração, expanda a seção expand_more Mostrar configurações avançadas.

   4. Para confirmar as opções do disco de inicialização e voltar ao painel Sistema operacional e armazenamento, clique em Selecionar.

   5. Opcional: para saber como anexar discos que não sejam de inicialização à sua instância, consulte Criar uma instância com discos extras que não são de inicialização.

4. Se você não escolheu um disco de inicialização, configure-o como um disco regional fazendo o seguinte:

   1. No menu de navegação, clique em Proteção de dados. No painel Proteção de dados exibido, faça o seguinte:

      1. Para configurar todos os novos discos da instância para usar a replicação síncrona de disco (Persistent Disk regional ou Hyperdisk Balanced High Availability), marque a caixa de seleção Discos regionais.

      2. Nenhuma ação é necessária por padrão. Desmarque a caixa de seleção Excluir discos de inicialização.

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

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

gcloud

Use o comando gcloud compute instances create para criar uma instância e a flag --create-disk para especificar o disco regional.

gcloud compute instances create PRIMARY_INSTANCE_NAME  \
 --zone=ZONE  \
 --create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:source-snapshot=SNAPSHOT_NAME:replica-zones=ZONE,REMOTE_ZONE

Ao especificar os parâmetros de disco, os caracteres ^:^ definem que o caractere de separação entre os parâmetros é dois-pontos (:). Isso permite usar uma vírgula (,) ao especificar o parâmetro "replica-zones".

Substitua:

• PRIMARY_INSTANCE_NAME: um nome para a instância
• ZONE: o nome da zona em que você quer criar a instância.
• REGIONAL_DISK_NAME: um nome para o disco regional
• DISK_TYPE: o tipo de disco a ser criado, por exemplo, hyperdisk-balanced-high-availability.
• SNAPSHOT_NAME: o nome do snapshot que você criou para o disco de inicialização
• REMOTE_ZONE: a zona alternativa para o disco regional

REST

Crie uma solicitação POST para o método instances.insert e especifique as propriedades boot: 'true' e replicaZones. Por exemplo:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
 "name": "INSTANCE_NAME",
 "disks": [{
    "boot": true,
    "initializeParams": {
       "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME",
       "replicaZones": [
           "projects/PROJECT_ID/zones/ZONE",
           "projects/PROJECT_ID/zones/REMOTE_ZONE"
       ],
       "diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
    }
  }],
 "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

Substitua:

• PROJECT_ID: ID do projeto;
• ZONE: o nome da zona em que você quer criar a instância
• INSTANCE_NAME: um nome para a instância
• BOOT_SNAPSHOT_NAME: o nome do snapshot do disco de inicialização
• REMOTE_ZONE: a zona remota do disco regional
• DISK_TYPE: o tipo de disco a ser criado, por exemplo, hyperdisk-balanced-high-availability

gcloud

1. Interrompa a instância.

   gcloud compute instances stop INSTANCE_NAME  --zone=ZONE
   

2. Remova o disco de inicialização atual da instância.

   gcloud compute instances detach-disk INSTANCE_NAME \
    --zone=ZONE --disk=CURRENT_BOOT_DEVICE_NAME
   

3. Anexe o disco de inicialização regional à instância.

   gcloud compute instances attach-disk INSTANCE_NAME  \
    --zone=ZONE  \
    --disk=REGIONAL_DISK_NAME  \
    --disk-scope=regional --force-attach \
    --boot
   

4. Reinicie a instância.

   gcloud compute instances start INSTANCE_NAME
   

Substitua as variáveis nos comandos anteriores pelas seguintes:

• INSTANCE_NAME: o nome da instância a que você quer anexar o disco de inicialização regional.
• ZONE: a zona em que a instância está localizada
• CURRENT_BOOT_DEVICE_NAME: o nome do disco de inicialização que está sendo usado pela instância. Geralmente, é igual ao nome da instância.
• REGIONAL_DISK_NAME: o nome do disco regional que você quer anexar à instância como um disco de inicialização.

Opcional: se não for possível remover o disco de inicialização regional da instância principal devido a uma interrupção ou falha, inclua a flag --force-attach.

REST

1. Interrompa a instância.

   POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
   

2. Remova o disco de inicialização atual da instância.

   POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=CURRENT_BOOT_DEVICE_NAME
   

3. Anexe o disco de inicialização regional à instância.

   Crie uma solicitação POST para o método compute.instances.attachDisk e inclua o URL do disco de inicialização regional:

   POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
   {
   "source": "compute/v1/projects/PROJECT_ID/regions/REGION/disks/REGIONAL_DISK_NAME",
   "boot": true
   }

4. Reinicie a instância.

   POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
   

Substitua as variáveis nos comandos anteriores pelas seguintes:

• PROJECT_ID: ID do projeto;
• INSTANCE_NAME: o nome da instância a que você quer anexar o disco regional.
• ZONE: a zona em que a instância está localizada
• CURRENT_BOOT_DEVICE_NAME: o nome do disco de inicialização que está sendo usado pela instância. Geralmente, é igual ao nome da instância.
• REGION: a região em que o disco regional está localizado.
• REGIONAL_DISK_NAME: o nome do disco regional que você quer anexar à instância como um disco de inicialização.

Opcional: se não for possível remover o disco de inicialização regional da instância a que ele foi originalmente anexado devido a uma interrupção ou falha, inclua "forceAttach": true no corpo da solicitação.