Provisionamento de instâncias em uma rede VPC

Esta página lista os comandos da CLI gcloud necessários para configurar pré-requisitos, provisionar uma instância, descrever uma instância e excluir uma instância em uma rede VPC padrão. Para instruções sobre como realizar essas tarefas em uma rede VPC compartilhada, consulte Provisionamento de instâncias em uma rede VPC compartilhada. Para realizar essas tarefas, siga as instruções em cada seção desta página.

Para orientações mais detalhadas sobre essas tarefas, consulte as seguintes páginas:

Ativar APIs

Comece ativando as APIs nesta seção. Essas APIs são necessárias porque o Memorystore para Valkey usa a automação de conectividade do serviço do Private Service Connect para automatizar a conectividade de instâncias. Para mais informações, consulte Rede.

Para ativar as APIs, execute os seguintes comandos:

gcloud

gcloud services enable --project=PROJECT_ID networkconnectivity.googleapis.com
gcloud services enable --project=PROJECT_ID compute.googleapis.com
gcloud services enable --project=PROJECT_ID serviceconsumermanagement.googleapis.com
gcloud services enable --project=PROJECT_ID memorystore.googleapis.com

Substitua:

  • PROJECT_ID é o ID do projeto;

Criar uma política de conexão de serviço

É necessário criar uma política de conexão de serviço para o projeto, a rede e a região em que você quer provisionar a instância do Memorystore para Valkey. Com uma política de conexão de serviço, você autoriza a classe de serviço gcp-memorystore a criar uma conexão do Private Service Connect entre redes VPC de produtor e consumidor na região em que a política é definida e na sub-rede especificada.

Para conferir a permissão necessária para criar uma política de conexão de serviço, consulte papéis obrigatórios.

Neste guia de início rápido, usamos a rede default e a sub-rede default. Os endereços IP da sua instância são alocados nessa sub-rede padrão na região.

Para criar a política de conexão de serviço, execute o seguinte comando:

gcloud

gcloud network-connectivity service-connection-policies create POLICY_NAME \
  --network=default \
  --project=PROJECT_ID \
  --region=REGION \
  --service-class=gcp-memorystore \
  --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/default

Substitua:

  • POLICY_NAME é o nome da política que você quer.
  • PROJECT_ID é o ID do projeto.
  • REGION é a mesma região em que você quer provisionar sua instância do Memorystore para Valkey.

Validar a criação da política de conexão de serviço

Valide se a política foi criada executando o comando list:

gcloud

gcloud network-connectivity service-connection-policies list --region=REGION --project=PROJECT_ID

Substitua:

  • PROJECT_ID é o ID do projeto.
  • REGION é a região em que a política de conexão de serviço é definida.

Criar uma instância

Para criar uma instância, execute o comando create:

gcloud

gcloud beta memorystore instances create INSTANCE \
--project=PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--psc-auto-connections=network=projects/PROJECT_ID/global/networks/NETWORK_ID,projectId=PROJECT_ID \

Substitua:

  • INSTANCE é o ID da instância.

  • REGION é a região em que você quer provisionar a instância.

  • NODE_TYPE é o tipo de nó escolhido. Os valores aceitos são:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    Para mais detalhes sobre tipos de nó e configurações de instância, consulte Especificação de instância e de nó.

  • SHARD_COUNT determina o número de fragmentos na sua instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instância. Para mais detalhes sobre a especificação da instância, consulte Especificação de instância e de nó.

  • REPLICA_COUNT é o número desejado de réplicas de leitura (por fragmento). Os valores aceitos são 0, 1 e 2.

  • PROJECT_ID é o ID do projeto em que você quer criar a instância.

  • NETWORK_ID é o ID da rede que você quer usar para criar a instância.

Descreva a instância

Para conferir os detalhes da instância, execute o comando describe:

gcloud

gcloud beta memorystore instances describe INSTANCE \
--project=PROJECT_ID \
--location=REGION

Substitua:

  • INSTANCE é o ID da instância.
  • PROJECT_ID é o ID do projeto.
  • REGION é a região em que a instância está localizada.

Excluir a instância

Para excluir uma instância, execute o comando delete:

gcloud

gcloud beta memorystore instances delete INSTANCE \
--project=PROJECT_ID \
--location=REGION

Substitua:

  • INSTANCE é o ID da instância.
  • PROJECT_ID é o ID do projeto.
  • REGION é a região em que a instância está localizada.