Crie um novo volume de disco persistente

Pode criar um volume de disco persistente em branco ou criar um disco a partir de uma origem de dados. Pode usar o disco persistente como um disco de arranque para uma instância de máquina virtual (VM) ou como um disco de dados que anexa a uma VM.

Este documento explica como criar um volume de disco persistente zonal em branco e não inicializável e anexá-lo à sua VM.

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

Antes de começar

  • 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.

    Terraform

    Para usar os exemplos do Terraform nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as credenciais predefinidas da aplicação com as suas credenciais de utilizador.

      Instale a CLI Google Cloud.

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

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para mais informações, consulte Set up authentication for a local development environment.

    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.

      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.

Restrições

  • Durante a criação da VM, pode anexar até 127 volumes de discos persistentes zonais secundários não de arranque.
  • Pode ter uma capacidade total anexada de 257 TB por VM. Para obter informações sobre como garantir o máximo desempenho com grandes volumes, consulte Tamanho do volume lógico.

Adicionar um disco não de arranque à sua VM

Crie e anexe um disco zonal não de arranque através do Google Cloud console, da CLI do Google Cloud ou REST.

Variáveis do tipo de disco persistente

A tabela seguinte lista os valores de referência de cada tipo de disco persistente. Quando cria um volume do Persistent Disk com a Google Cloud CLI, a API REST ou as bibliotecas de cliente da Google Cloud para o Compute Engine, indique o tipo de Persistent Disk que quer criar fornecendo o valor correspondente da tabela.

Se criar um disco na Google Cloud consola, o tipo de disco predefinido é pd-balanced. Se criar um disco através da CLI gcloud ou da API REST, o tipo de disco predefinido é pd-standard.

Tipo de disco Nome de referência
Disco persistente equilibrado pd-balanced
Disco persistente de desempenho (SSD) pd-ssd
Disco persistente padrão pd-standard
Disco persistente extremo pd-extreme

Deve especificar um nome de dispositivo personalizado quando anexar o disco a uma VM. O nome especificado é usado para gerar um symlink para o disco no SO convidado, o que facilita a identificação.

Consola

  1. Aceda à página Instâncias de VM.

    Aceda à página de instâncias de VM

  2. Clique no nome da VM à qual quer adicionar um disco.

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

  4. Em Discos adicionais, clique em Adicionar novo disco.

  5. Especifique um nome para o disco, configure as propriedades do disco e selecione Em branco como o Tipo de origem.

  6. Opcional: no título Nome do dispositivo, selecione a opção Usar um nome do dispositivo personalizado. O nome que introduzir é usado para gerar um link simbólico para o disco, o que facilita a identificação do disco.

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

  8. Clique em Guardar para aplicar as alterações à VM e adicionar o novo disco.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Use o comando gcloud compute disks create para criar o volume do disco persistente zonal.

    gcloud compute disks create DISK_NAME \
  --size DISK_SIZE \
  --type DISK_TYPE

    Substitua o seguinte:

    • 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,inclusive.
    • DISK_TYPE: URL completo ou parcial para o tipo do volume do disco persistente. Por exemplo, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.

  3. Depois de criar o disco, anexe-o a qualquer VM 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

    Substitua o seguinte:

    • VM_NAME: o nome da VM onde está a adicionar o novo volume de disco persistente zonal
    • DISK_NAME: o nome do novo disco que está a anexar à VM.
    • DEVICE_NAME: Opcional: um nome que o SO convidado usa para identificar o disco.

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

    5. 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 os comandos básicos do Terraform.

    REST

    1. Construa um pedido POST para criar um disco persistente zonal através do método disks.insert. Inclua as propriedades name, sizeGb e type. Para criar este disco como um disco não inicializável vazio e não formatado, não especifique uma imagem de origem nem um instantâneo de origem.

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

{
 "name": "DISK_NAME",
 "sizeGb": "DISK_SIZE",
 "type": "DISK_TYPE"
}

      Substitua o seguinte:

      • PROJECT_ID: o ID do seu projeto.
      • ZONE: a zona onde 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,inclusive.
      • DISK_TYPE: URL completo ou parcial para o tipo de disco persistente. Por exemplo, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.

    2. Construa um pedido POST para o método compute.instances.attachDisk e inclua o URL para o volume do disco persistente zonal que acabou de criar:

      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 o seguinte:

      • PROJECT_ID: o ID do seu projeto
      • ZONE: a zona onde a sua VM e o novo disco se encontram
      • VM_NAME: o nome da VM onde está a adicionar o novo volume do disco persistente
      • 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, tem de formatar e montar o disco para que o sistema operativo possa usar o espaço de armazenamento disponível.

O que se segue?