Criar um novo volume de disco permanente

É possível criar um disco permanente em branco ou criar um disco a partir de uma fonte de dados. Use um Persistent Disk como um disco de inicialização de uma instância de computação ou como um disco de dados anexado a uma instância.

O documento explica como criar um volume de disco persistente zonal em branco e que não é de inicialização e anexá-lo à VM.

Para outros tipos de criação e adição de discos, consulte:

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma 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:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console Google Cloud para acessar serviços Google Cloud e APIs, não é necessário configurar a autenticação.

    gcloud

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

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  • Defina uma região e uma zona padrão.

    • Terraform

    Para usar os exemplos do Terraform nesta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.

    1. Instale a CLI do Google Cloud.

    2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    3. Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário: 

      gcloud auth application-default login

      Não é necessário fazer isso se você estiver usando o Cloud Shell.

      Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

    Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

    REST

    Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para CLI gcloud.

      Instale a CLI do Google Cloud.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Restrições

  • Durante a criação da VM, é possível anexar até 127 volumes de disco permanente zonal secundários que não sejam de inicialização.
  • Observação: a capacidade total de anexos é de 257 TB por VM. Para informações sobre como garantir o desempenho máximo com grandes volumes, consulte Tamanho do volume lógico.

Limites de tamanho e nomes de referência do Persistent Disk

Ao criar um volume do Persistent Disk com a Google Cloud CLI, REST ou as bibliotecas de cliente do Cloud para Compute Engine, indique o tipo de disco permanente a ser criado fornecendo o valor na coluna Nome de referência da tabela a seguir.

O tamanho especificado para um volume Persistent Disk precisa estar dentro dos intervalos listados na tabela a seguir.

Tipo de disco Nome da referência Tamanho mínimo Tamanho máximo Tamanho padrão
Disco permanente equilibrado pd-balanced Por zona: 10 GiB
Regional: 10 GiB		 64 TiB 100 GiB
Persistent Disk (SSD) de desempenho pd-ssd Por zona: 10 GiB
Regional: 10 GiB		 64 TiB 100 GiB
Disco permanente padrão pd-standard Por zona: 10 GiB
Regional: 200 GiB		 64 TiB 500 GiB
Disco permanente extremo pd-extreme 500 GiB 64 TiB 1 TiB

Adicionar um Persistent Disk que não é de inicialização à instância

Crie e anexe um Persistent Disk zonal que não seja de inicialização usando o Google Cloud console, a Google Cloud CLI ou REST.

Especifique um nome de dispositivo personalizado ao anexar o disco a uma VM. O nome especificado é usado para gerar um link simbólico para o disco no SO convidado, facilitando a identificação.

Console

  1. Acesse a página Instâncias da VM.

    Acessar a página "Instâncias de VM"

  2. Clique no nome da VM a que você quer adicionar um disco.

  3. Na página de detalhes, clique em Editar.

  4. Na seção Armazenamento, em Discos adicionais, clique em Adicionar novo disco.

  5. Especifique um nome para o disco e configure as propriedades dele.

  6. Em Tipo de origem do disco, escolha a fonte de dados do disco:

    • Para criar um disco em branco, selecione Disco em branco.
    • Para criar o disco com base em uma imagem:
      1. Selecione Imagem.
      2. Em Imagem de origem, escolha a imagem de origem do disco.
    • Para criar o disco com base em um snapshot atual:
      1. Selecione Snapshot, Instant snapshot ou snapshot de arquivamento, dependendo se o snapshot de origem é um snapshot padrão, um instant snapshot ou um snapshot de arquivamento, respectivamente.
      2. Em Snapshot de origem, selecione o snapshot ou instant snapshot de origem na lista. Somente os snapshots no local selecionado são listados.

  7. Opcional: para ver as opções avançadas de configuração, expanda a seção Mostrar configurações avançadas.

    • Selecione o modo de anexo do disco no campo Modo.
    • Escolha manter ou excluir o disco quando a instância for excluída selecionando a opção no campo Regra de exclusão.
    • Para facilitar a identificação do disco no SO convidado, especifique um nome de dispositivo personalizado. No título Nome do dispositivo, selecione a opção Usar nome de dispositivo personalizado. No campo Nome do dispositivo, insira uma string para usar como um link simbólico para o disco.

  8. Clique em Concluído para concluir a configuração do disco.

  9. Clique em Salvar para aplicar as alterações à instância e adicionar o novo disco.

gcloud

  1. No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

  2. Use o comando gcloud compute disks create para criar um volume de disco permanente zonal.

    gcloud compute disks create DISK_NAME \
  --size DISK_SIZE --zone=ZONE \
  --type DISK_TYPE

    Substitua:

    • DISK_NAME: o nome do novo disco.
    • DISK_SIZE: o tamanho, em gigabytes, do novo disco. Os tamanhos aceitáveis variam, em incrementos de 1 GB, de 10 GB a 65.536 GB.
    • ZONE: a zona em que o Compute Engine cria o disco, por exemplo, us-central1-f.
    • DISK_TYPE: o tipo do novo disco. Por exemplo, para um disco permanente SSD, especifique pd-ssd.

  3. Depois de criar o disco, anexe-o a qualquer instância em execução ou parada. Use o comando gcloud compute instances attach-disk:

    gcloud compute instances attach-disk VM_NAME \
  --disk DISK_NAME --device-name=DEVICE_NAME \
  --zone=ZONE

    Substitua:

    • VM_NAME: o nome da VM em que você está adicionando o novo volume zonal do Persistent Disk.
    • DISK_NAME: o nome do novo disco que você está anexando à VM.
    • DEVICE_NAME (opcional): um nome que o SO convidado usa para identificar o disco.
    • ZONE: a zona em que o Compute Engine cria a instância e o disco, por exemplo, us-central1-f.

  4. Use o comando gcloud compute disks describe para ver uma descrição do disco.

Terraform

Para criar um disco, use o recurso google_compute_disk.

# Using pd-standard because it's the default for Compute Engine

resource "google_compute_disk" "default" {
  name = "disk-data"
  type = "pd-standard"
  zone = "us-west1-a"
  size = "5"
}

Para anexar o disco a uma VM, use o recurso google_compute_instance.

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]
  }


}

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

REST

  1. Elabore uma solicitação POST para criar um disco permanente zonal usando o método disks.insert. Inclua as propriedades name, sizeGb e type. Para criar esse disco como um disco que não será inicializado e não estará formatado, não especifique uma imagem ou snapshot de origem.

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

{
 "name": "DISK_NAME",
 "sizeGb": "DISK_SIZE",
 "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
}

    Substitua:

    • PROJECT_ID: o ID do projeto
    • ZONE: a zona em que a VM e o novo disco estão localizados.
    • DISK_NAME: o nome do novo disco.
    • DISK_SIZE: o tamanho, em gigabytes, do novo disco. Os tamanhos aceitáveis variam, em incrementos de 1 GB, de 10 GB a 65.536 GB.
    • DISK_TYPE: o tipo do novo disco. Por exemplo, para um disco permanente SSD, especifique pd-ssd.

  2. Crie uma solicitação POST para o método compute.instances.attachDisk e inclua o URL para o disco permanente zonal que você acabou de gerar:

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

{
 "source": "/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME",
 "deviceName": DEVICE_NAME
}

    Substitua:

    • PROJECT_ID: ID do projeto
    • ZONE: a zona em que a VM e o novo disco estão localizados.
    • VM_NAME: o nome da VM em que você está adicionando o novo volume do Persistent Disk
    • DISK_NAME: o nome do novo disco.
    • DEVICE_NAME (opcional): um nome que o SO convidado usa para identificar o disco.

Depois de criar o novo disco e anexá-lo a uma VM, você precisa formatar e ativar o disco para que o sistema operacional possa usar o espaço de armazenamento disponível.

A seguir