Esta página lista 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 for 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. Uma política de conexão de serviço permite autorizar 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 está definida e na sub-rede especificada por ela.
Para conferir a permissão necessária para criar uma política de conexão de serviço, consulte Papéis necessários.
Este guia de início rápido usa a rede default e a sub-rede default. Os endereços IP da 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 desejada.
- PROJECT_ID é o ID do projeto.
- REGION é a mesma região em que você quer provisionar a 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 está 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ó que você quer usar para a instância.
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 de réplicas de leitura (por fragmento). Os valores aceitos são
0-5.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 sua 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.