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, você precisa 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 ter o melhor desempenho, localize a instância na mesma zona das VMs ou clusters clientes.
  • Configurações de divisão de arquivos e diretórios. Consulte Considerações sobre desempenho para mais detalhes sobre cada uma dessas configurações. Consulte o guia de solução de problemas se tiver problemas com o uso da capacidade da instância.
  • A rede VPC para esta instância. Ela precisa ser a mesma rede usada para suas VMs clientes ou clusters do Google Kubernetes Engine.

Permissões necessárias

Para criar uma instância do Parallelstore, é necessário ter permissões de administrador do Parallelstore (roles/parallelstore.admin) do IAM no projeto.

Consulte Controle de acesso com o IAM para mais detalhes.

Considerações sobre desempenho

Para maximizar a performance da sua instância do Parallelstore:

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

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

Criar uma instância

É possível criar uma instância do Parallelstore nas seguintes interfaces.

gcloud

Para criar uma 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

Em que os seguintes valores precisam ser especificados:

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

    • Ter somente letras minúsculas, números e hifens.
    • Comece com uma letra.
    • Ter entre 1 e 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 12.000 a 100.000, em múltiplos de 4.000.

  • --location precisa ser uma Google Cloud zona válida compatível com o Parallelstore. Consulte Locais disponíveis para conferir uma lista completa.

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

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

  • --directory-stripe-level define o nível de divisão em faixas 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 divisã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)
}

Em que os seguintes valores precisam ser especificados:

  • PROJECT_ID é o ID do projeto Google Cloud .

  • ZONE precisa ser uma Google Cloud zona válida compatível com o Parallelstore. Consulte Locais disponíveis para conferir uma lista completa.

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

    • Ter somente letras minúsculas, números e hifens.
    • Comece com uma letra.
    • Ter entre 1 e 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 12.000 a 100.000, em múltiplos de 4.000.

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

  • fileStripeLevel define a configuração de divisã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 divisão em faixas 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 é compatível com outros campos opcionais para instâncias. Consulte a documentação de referência do recurso Instance para ver 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 da instância exclusivo e, se quiser, uma descrição.

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

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

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

  7. Escolha se 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 a seguir. Observe a lista de pontos de acesso no recurso da instância. Você vai precisar desses pontos de acesso 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