Adicionar armazenamento de hiperdisco a uma VM

É possível usar um volume de hiperdisco extremo ou hiperdisco de capacidade de processamento com sua VM concluindo as seguintes tarefas:

  • Crie um volume do hiperdisco em branco, que não seja de inicialização e zonal e o anexe à VM como parte da criação dela ou como tarefas separadas.
  • Formate e ative o volume para fornecer acesso a um sistema de dados ou arquivos.

O processo é o mesmo para volumes de hiperdisco equilibrado, exceto que você também pode criar discos de inicialização do tipo hiperdisco equilibrado.

Para informações gerais sobre o Hyperdisk, consulte Sobre o Hyperdisk.

Antes de começar

  • Analise as limitações do Hyperdisk antes de adicionar um volume à sua VM.
  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da 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 da seguinte maneira.

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Papéis e permissões necessárias

Para conseguir as permissões necessárias para adicionar um volume do Hyperdisk à VM, peça ao administrador para conceder a você os papéis do IAM a seguir no projeto:

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esses papéis predefinidos contêm as permissões necessárias para adicionar um volume do Hyperdisk à VM. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para adicionar um volume do Hyperdisk à VM:

  • Para criar e anexar um volume do Hyperdisk:
    • compute.disks.create no projeto
    • compute.instances.attachDisk na VM
    • compute.disks.use no volume que você quer anexar à VM
  • Para formatar e ativar o volume anexado: compute.instances.setMetadata na VM

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Adicionar um volume do Hyperdisk à VM

É possível criar e anexar um volume do hiperdisco usando o console do Google Cloud, a Google Cloud CLI ou o REST.

Console

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

    Acessar instâncias de VM

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

  3. Na página Detalhes da instância de VM, clique em Editar.

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

  5. Especifique um nome para o disco e, se quiser, uma descrição. Selecione Disco em branco como o Tipo de origem do disco.

  6. Em Tipo de disco, escolha uma das seguintes opções para o tipo de disco:

    1. Hiperdisco equilibrado. Também é possível alterar as configurações de Tamanho, IOPS provisionadas e Capacidade de processamento provisionada do disco padrão.
    2. Hiperdisco extremo Também é possível alterar as configurações padrão de Tamanho e IOPS provisionadas do disco.
    3. Capacidade do hiperdisco: também é possível alterar as configurações padrão de Tamanho e Capacidade provisionado do disco.

  7. Clique em Salvar.

  8. Na janela Editar da VM, clique em Salvar para aplicar as alterações à VM e adicionar o novo disco.

gcloud

  1. Use o comando gcloud compute disks create para criar o volume do hiperdisco.

    gcloud compute disks create DISK_NAME \
   --zone=ZONE \
   --size=DISK_SIZE \
   --type=DISK_TYPE \
   --provisioned-iops=IOPS_LIMIT
   --provisioned-throughput=THROUGHPUT_LIMIT

    Substitua:

    • DISK_NAME: o nome do novo disco.
    • ZONE: o nome da zona em que o novo disco está sendo criado.
    • DISK_SIZE: opcional: o tamanho do novo disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibyte ou TB para tebibyte. Se nenhuma unidade de tamanho for especificada, 100 GB será usado como o valor padrão. Os valores aceitos para o tamanho do disco são:
      • Hiperdisco equilibrado: de 4 GiB a 64 TiB, inclusive, em incrementos de 1 GiB.
      • Hiperdisco extremo: de 64 GiB a 64 TiB, inclusive, em incrementos de 1 GiB.
      • Capacidade de processamento do hiperdisco: de 2 TiB a 32 TiB, inclusive, em incrementos de 1 GiB.
    • DISK_TYPE: o tipo do disco. Use um dos seguintes valores: hyperdisk-balanced, hyperdisk-extreme ou hyperdisk-throughput.

    • IOPS_LIMIT: opcional: para discos de hiperdisco equilibrado ou extremo, esse é o número de operações de E/S por segundo (IOPS) que o disco pode processar. As IOPS precisam ser especificadas dentro dos seguintes limites:

      • Hiperdisco equilibrado:
        • Valor mínimo: o menor valor de 500 IOPS por GiB de capacidade de disco ou 3.000
        • Valor máximo: o menor valor de 500 IOPS por GiB de capacidade ou 160.000 IOPS
      • Hiperdisco extremo
        • Valor mínimo: duas IOPS por GiB de capacidade de disco.
        • Valor máximo: o menor valor de 1.200 vezes a capacidade medida em GiB ou 350.000.

      Se você não especificar um valor para IOPS ou tamanho de disco, um valor padrão será usado:

      • Hiperdisco equilibrado: a IOPS padrão é 3.600. Se você especificar um tamanho para o disco, o valor padrão vai depender do tamanho:
        • 6 GiB ou menos: 500 IOPS por GiB de tamanho do disco
        • Maior que 6 GiB: o menor valor de 3.000 + 6 IOPS por GiB de tamanho do disco ou 160.000
      • Hiperdisco extremo: o valor padrão é 100 vezes a capacidade do disco medida em GiB ou o máximo de IOPS para o tipo de máquina.

      Por exemplo, é possível provisionar IOPS para o hiperdisco extremo em uma VM C3 da seguinte maneira:

      • Para um disco de 64 GiB, é possível provisionar IOPS no intervalo de 128 a 64.000. As IOPS padrão são 6.400.
      • Para um disco de 64.000 GiB, é possível provisionar IOPS no intervalo de 128.000 a 350.000. As IOPS padrão são 350.000.

    • THROUGHPUT_LIMIT (opcional): para volumes de hiperdisco equilibrado ou de capacidade de processamento do hiperdisco, é um número inteiro que representa a capacidade, medida em MiB por segundo, que o disco pode processar. A capacidade de processamento precisa ser especificada dentro dos seguintes limites:

      • Hiperdisco equilibrado:
        • Valor mínimo: o maior número de IOPS dividido por 256 ou 140 MiBps
        • Valor máximo: o maior valor de IOPS divididas por 256 ou 2.400 MiBps
      • Capacidade de processamento do hiperdisco:
        • Valor mínimo: 10 MB/s por TiB de capacidade.
        • Valor máximo: o menor de 600 MB/s por volume ou 90 MB/s por TiB de capacidade.

      Se você não especificar um valor para IOPS, capacidade ou tamanho do disco, um valor padrão será usado.

      • Hiperdisco equilibrado: a capacidade padrão é de 140 MiBps. Se você especificar um tamanho para o disco, o valor padrão vai depender do tamanho:
        • 6 GiB ou menos: 140 MiBps
        • Maior que 6 GiB: o menor valor de ((6 * disk size in GiB) / 4) + 140 ou 2.400 MiBps
      • Capacidade de processamento do hiperdisco: a capacidade padrão é de 90 MiBps por TiB de capacidade do disco, mas não maior que a capacidade máxima aceita por disco.

  2. Opcional: use o comando gcloud compute disks describe DISK_NAME para conferir uma descrição do disco.

  3. Depois de criar o disco, anexe-o a uma VM.

REST

  1. Crie uma solicitação POST para gerar um hiperdisco zonal usando o método disks.insert. Inclua as propriedades name, sizeGb, type, provisionedIops e provisionedThroughput. Para criar esse disco como um que não será inicializado e não estará formatado, recomendamos não especificar 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",
   "provisionedIops": "IOPS_LIMIT",
   "provisionedThroughput": "THROUGHPUT_LIMIT"
}

    Substitua:

    • PROJECT_ID: 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: opcional: o tamanho do novo disco. O valor precisa ser um número inteiro seguido por uma unidade de tamanho de GB para gibibytes ou TB para tebibytes. Tamanhos aceitáveis para cada intervalo de tipo de disco, em incrementos de 1 GiB:
      • Hiperdisco equilibrado: de 4 GiB a 64 TiB.
      • Hiperdisco extremo: de 64 GiB a 64 TiB.
      • Hiperdisco de capacidade de processamento: de 2 TiB a 32 TiB.
    • DISK_TYPE: o tipo do disco. Para criar um volume de hiperdisco, use um dos seguintes valores: hyperdisk-balanced, hyperdisk-extreme ou hyperdisk-throughput.

    • IOPS_LIMIT: opcional: para Hiperdisco equilibrado e Hiperdisco extremo, esse é o número de operações de E/S por segundo que o disco pode processar. As IOPS precisam ser especificadas dentro dos seguintes limites:

      • Valor mínimo:
        • Hiperdisco equilibrado: o mínimo de 500 IOPS por GiB de capacidade de disco ou 3.000
        • Hiperdisco extremo: duas IOPS por GiB de capacidade de disco
      • Valor máximo:
        • Hiperdisco equilibrado: o mínimo de 500 IOPS por GiB de capacidade de disco ou 160.000 IOPS
        • Hiperdisco extremo: o mínimo de 1.000 IOPS por GiB de capacidade de disco ou o máximo de IOPS para o tipo de máquina.

      Se você não especificar um valor para IOPS, será usado um valor padrão, que é:

      • Hiperdisco equilibrado: 3.600 IOPS se o tamanho do disco não for especificado. Se você especificar um tamanho para o disco, o valor padrão vai depender do tamanho:
        • 6 GiB ou menos: 500 IOPS por GiB de tamanho do disco
        • Maior que 6 GiB: o menor valor de 3.000 + 6 IOPS por GiB de tamanho do disco ou 160.000
      • Hiperdisco extremo: o mínimo de 100 IOPS por GiB de capacidade de disco ou o máximo de IOPS para o tipo de máquina.

      Por exemplo, é possível provisionar IOPS para um disco de hiperdisco extremo em uma VM C3 da seguinte maneira:

      • Para um disco de 64 GiB, é possível provisionar IOPS no intervalo de 128 a 64.000. As IOPS padrão são 6.400.
      • Para um disco de 64 TiB, é possível provisionar IOPS no intervalo de 128.000 a 350.000. As IOPS padrão são 350.000.

    • THROUGHPUT_LIMIT (opcional): para volumes de hiperdisco equilibrado ou de capacidade de processamento do hiperdisco, é um número inteiro que representa a capacidade, medida em MiB por segundo, que o disco pode processar. A capacidade de processamento precisa ser especificada dentro dos seguintes limites:

      • Hiperdisco equilibrado:
        • Valor mínimo: o maior número de IOPS dividido por 256 ou 140 MiBps
        • Valor máximo: IOPS divididas por 256, mas não mais que 2.400 MiBps
      • Capacidade de processamento do hiperdisco:
        • Valor mínimo: 10 MB/s por TiB de capacidade.
        • Valor máximo: o menor de 600 MB/s por volume ou 90 MB/s por TiB de capacidade.

      Se você não especificar um valor para IOPS, capacidade ou tamanho do disco, um valor padrão será usado.

      • Hiperdisco equilibrado: a capacidade padrão é de 140 MiBps. Se você especificar um tamanho para o disco, o valor padrão vai depender do tamanho:
        • 6 GiB ou menos: 140 MiBps
        • Maior que 6 GiB: o menor valor de ((6 * disk size in GiB) / 4) + 140 ou 2.400 MiBps
      • Capacidade de processamento do hiperdisco: a capacidade padrão é de 90 MiBps por TiB de capacidade do disco, mas não maior que a capacidade máxima aceita por disco.

  2. Opcional: use o método compute.disks.get para conferir uma descrição do disco.

  3. Depois de criar o disco, anexe-o a qualquer VM em execução ou interrompida.

Formatar e ativar o disco

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

A seguir