Provisionamento de instâncias em uma rede VPC

Nesta página, listamos os comandos da CLI gcloud necessários para configurar pré-requisitos, provisionar, descrever 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 Private Service Connect para automatizar a conectividade das 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

Você precisa criar uma política de conexão de serviço para o projeto, a rede e a região em que 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 por ela.

Para saber 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 desejado para a política.
  • 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

Para validar se a política foi criada com sucesso, execute 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 memorystore instances create INSTANCE \
--project=PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"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

  • 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âncias. Para mais detalhes sobre a especificação da instância, consulte Especificação da instância e do 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.

Descrever a instância

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

gcloud

gcloud 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 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.