Criar uma instância do Parallelstore

Uma instância do Parallelstore é um servidor de armazenamento de arquivos hospedado projetado para permitir IOPs extremamente altos e latência muito baixa, aproveitando o acesso direto e paralelo à mídia de armazenamento.

Ao criar uma instância do Parallelstore, é necessário definir as seguintes propriedades:

  • O nome da instância.
  • A capacidade de armazenamento. A capacidade pode variar de 12 TiB (tebibytes) a 100 TiB, em múltiplos de 4. Por exemplo, 16 TiB, 20 TiB, 24 TiB.
  • O local. Para um melhor desempenho, localize a instância na mesma zona que as VMs ou clusters de clientes.
  • Configurações de remoção de arquivos e diretórios. Consulte Considerações sobre desempenho para detalhes sobre cada uma dessas configurações. Consulte o guia Solução de problemas para ver problemas com o uso da capacidade da instância.
  • A rede VPC para essa instância. Ela precisa ser a mesma rede usada para as VMs do cliente ou clusters do Google Kubernetes Engine.

Permissões necessárias

Para criar uma nova instância do Parallelstore, você precisa ter permissões do IAM de administrador do Parallelstore (roles/parallelstore.admin) no projeto.

Consulte Controle de acesso com o IAM para mais detalhes.

Considerações sobre desempenho

Para maximizar o desempenho da instância do Parallelstore:

  • Crie a instância na mesma Google Cloud zona das VMs do Compute Engine ou dos clusters do Google Kubernetes Engine que você vai conectar.

  • Consulte Considerações sobre desempenho para saber mais sobre as opções de configuração, incluindo as opções de remoção de arquivos e diretórios.

Criar uma instância

É possível criar uma nova instância do Parallelstore usando as interfaces a seguir.

gcloud

Para criar uma nova instância do Parallelstore, use o comando gcloud beta parallelstore instances create:

gcloud beta parallelstore instances create INSTANCE_ID \
  --capacity-gib=CAPACITY_GIB \
  --location=LOCATION \
  --network=NETWORK_NAME \
  --project=PROJECT_ID \
  --directory-stripe-level=DIRECTORY_STRIPE_LEVEL \
  --file-stripe-level=FILE_STRIPE_LEVEL

Onde os seguintes valores precisam ser especificados:

  • INSTANCE_ID é o nome dessa instância do Parallelstore. Ela precisa:

    • Conter apenas letras minúsculas, números e hifens.
    • Comece com uma letra.
    • Ter de 1 a 63 caracteres.
    • Termine com um número ou uma letra.
    • Ser exclusivo no projeto e no local.

  • --capacity-gib é a capacidade de armazenamento da instância em gibibytes (GiB). Os valores permitidos são de 12000 a 100000, em múltiplos de 4000.

  • --location precisa ser uma zona Google Cloud válida com suporte do Parallelstore. Consulte a lista completa em Locais com suporte.

  • --network é o nome da rede VPC que você criou em Configurar uma rede VPC.

  • --project é o ID do Google Cloud projeto.

  • --directory-stripe-level define o nível de remoção para diretórios. Os valores permitidos são:

    • directory-stripe-level-balanced
    • directory-stripe-level-max
    • directory-stripe-level-min

    Consulte Considerações sobre desempenho para mais detalhes.

  • --file-stripe-level define as configurações de remoção de arquivos. Os valores permitidos são:

    • file-stripe-level-balanced
    • file-stripe-level-max
    • file-stripe-level-min

    Consulte Considerações sobre desempenho para mais detalhes.

Uma solicitação bem-sucedida retorna um ID de operação:

Create request issued for: [$INSTANCE_ID]
Waiting for operation [projects/$PROJECT_ID/locations/us-central1-a/operations/
operation-1234567890-609d21deae6f0-befaf0bc-867b1aa1] to complete...

O processo de criação da instância leva de 5 a 10 minutos.

REST

Para criar uma instância usando a API REST, envie uma solicitação para o seguinte endpoint:

POST https://parallelstore.googleapis.com/v1beta/projects/PROJECT_ID/locations/ZONE/instances?instanceId=INSTANCE_NAME
Authorization: Bearer AUTH_TOKEN
{
  "capacityGib": string,
  "network": string,
  "fileStripeLevel": enum (FileStripeLevel),
  "directoryStripeLevel": enum (DirectoryStripeLevel)
}

Onde os seguintes valores precisam ser especificados:

  • PROJECT_ID é o ID do Google Cloud projeto.

  • ZONE precisa ser uma zona Google Cloud válida com suporte do Parallelstore. Consulte a lista completa em Locais com suporte.

  • INSTANCE_NAME é o nome dessa instância do Parallelstore. Ela precisa:

    • Conter apenas letras minúsculas, números e hifens.
    • Comece com uma letra.
    • Ter de 1 a 63 caracteres.
    • Termine com um número ou uma letra.
    • Ser exclusivo no projeto e no local.

  • capacityGib é a capacidade de armazenamento da instância em gibibytes (GiB). Os valores permitidos são de 12000 a 100000, em múltiplos de 4000.

  • network é o nome da rede VPC que você criou em Configurar uma rede VPC.

  • fileStripeLevel define a configuração de remoção de arquivos para todos os arquivos nessa instância. Os valores permitidos são:

    • FILE_STRIPE_LEVEL_MIN
    • FILE_STRIPE_LEVEL_BALANCED
    • FILE_STRIPE_LEVEL_MAX

    Consulte Considerações sobre desempenho para mais detalhes.

  • directoryStripeLevel define o nível de remoção para diretórios. Os valores permitidos são:

    • DIRECTORY_STRIPE_LEVEL_MIN
    • DIRECTORY_STRIPE_LEVEL_BALANCED
    • DIRECTORY_STRIPE_LEVEL_MAX

    Consulte Considerações sobre desempenho para mais detalhes.

A API oferece suporte a outros campos opcionais para instâncias. Consulte a documentação de referência do recurso Instance para conferir uma lista completa e descrições.

Console do Google Cloud

  1. Acesse a página Parallelstore no console do Google Cloud.

    Acessar o Parallelstore

  2. Clique em Criar. A página Criar uma instância é exibida.

  3. Insira um nome de instância exclusivo e, se quiser, uma descrição.

  4. Selecione uma região e uma zona para criar a instância. Coloque sua instância na mesma região e zona que as VMs do Compute Engine ou os clusters do Google Kubernetes Engine que vão se conectar a ela.

  5. Selecione a capacidade de armazenamento da sua instância.

  6. Selecione a rede que você criou em Criar uma rede VPC.

  7. Escolha se você quer usar um intervalo de IP alocado automaticamente ou especificar um intervalo de IP personalizado.

A seção Resumo da página é atualizada para mostrar estimativas de custo e performance com base nas suas seleções.

Clique em Criar para continuar. O processo de criação da instância leva de 5 a 10 minutos.

Consultar o status da criação da instância

Para consultar o status de uma operação de criação, use o ID da operação da resposta.

gcloud beta parallelstore operations describe OPERATION_ID \
  --location=LOCATION \
  --project=PROJECT_ID

Quando a operação for concluída, o resultado será semelhante à resposta abaixo. Observe a lista de pontos de acesso no recurso de instância. Você vai precisar desses pontos para a configuração do cliente.

done: true
metadata:
  '@type': type.googleapis.com/google.cloud.parallelstore.v1beta.OperationMetadata
  apiVersion: v1beta
  createTime: '2030-01-01T20:25:10.952802976Z'
  endTime: '2030-01-01T20:31:33.238880873Z'
  requestedCancellation: false
  target: projects/$PROJECT_ID/locations/us-central1-a/instances/$INSTANCE_ID
  verb: create
name: projects/$PROJECT_ID/locations/us-central1-a/operations/operation-1699647909979-609d21deae6f0-befaf0bc-867b1aa1
response:
  '@type': type.googleapis.com/google.cloud.parallelstore.v1beta.Instance
  accessPoints:
  - 172.21.95.2
  - 172.21.95.4
  - 172.21.95.5
  capacityGib: '16000'
  createTime: '2030-01-01T20:25:10.949287427Z'
  name: projects/$PROJECT_ID/locations/us-central1-a/instances/$INSTANCE_ID
  network: $NETWORK_NAME
  reservedIpRange: $IP_RANGE_NAME
  state: ACTIVE
  updateTime: '2030-01-01T20:25:10.949287427Z'

A seguir