Crie um novo volume de disco permanente


Você pode criar um volume de disco permanente em branco ou criar um disco a partir de uma fonte de dados . Você pode usar o disco permanente como um disco de inicialização para uma instância de máquina virtual (VM) ou como um disco de dados anexado a uma VM.

Este documento explica como criar um volume de disco permanente zonal em branco e sem inicialização e anexá-lo à sua VM.

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

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command:

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.
    3. Terraform

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

      1. Install the Google Cloud CLI.
      2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      3. To initialize the gcloud CLI, run the following command:

        gcloud init
      4. 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, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.

      Confira mais informações em Set up authentication for a local development environment.

      REST

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

        After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Restrições

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

Adicionando um disco que não é de inicialização à sua VM

Crie e anexe um disco zonal sem inicialização usando o console do Google Cloud , a CLI do Google Cloud ou REST .

Se você criar um disco no console do Google Cloud, o tipo de disco padrão será pd-balanced . Se você criar um disco usando a CLI gcloud ou REST, o tipo de disco padrão será pd-standard .

Você deve especificar 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 sistema operacional convidado, facilitando a identificação.

Console

  1. Acesse a página de instâncias de VM .

    Acesse a página de instâncias de VM

  2. Clique no nome da VM onde você deseja 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 Tipo de origem .

  6. Opcional: sob o título Nome do dispositivo , selecione a opção Usar um nome de dispositivo personalizado . O nome inserido é 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 Salvar para aplicar suas 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 zonal do disco permanente.

    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 de volume do disco permanente. 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 interrompida. 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 você está adicionando o novo volume zonal do disco permanente
    • DISK_NAME : o nome do novo disco que você está anexando à VM.
    • DEVICE_NAME : opcional: um nome que o sistema operacional convidado usa para identificar o disco.
  4. Use o comando gcloud compute disks describe para ver uma descrição do seu disco.

Terraforma

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 .

DESCANSAR

  1. Crie 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 este disco como um disco sem inicialização vazio e não formatado, não especifique uma imagem de origem ou 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 : seu ID do projeto.
    • ZONE : a zona onde sua 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 permanente. Por exemplo, https://www.googleapis.com/compute/v1/projects/ PROJECT_ID /zones/ ZONE /diskTypes/pd-ssd .
  2. Crie uma solicitação POST para o método compute.instances.attachDisk e inclua o URL para o volume zonal do disco permanente que você 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 sua VM e o novo disco estão localizados
    • VM_NAME : o nome da VM onde você está adicionando o novo volume do disco permanente
    • DISK_NAME : o nome do novo disco
    • DEVICE_NAME : opcional: um nome que o sistema operacional convidado usa para identificar o disco.

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

O que vem a seguir