Esta página foi traduzida pela API Cloud Translation.

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 ter o melhor desempenho, localize a instância na mesma zona que as 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, você precisa ter permissões do IAM de administrador do Parallelstore (roles/parallelstore.admin) no seu 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 compatíveis para ver 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 compatíveis para ver 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.

Google Cloud console

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

Acessar o Parallelstore
Clique em Criar. A página Criar uma instância é exibida.
Insira um Nome da instância exclusivo e, se quiser, uma descrição.
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.
Selecione a capacidade de armazenamento da instância.
Selecione a rede que você criou em Criar uma rede VPC.
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 deles 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'

Criar uma instância do Parallelstore Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.