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 Redis Cluster 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 redis.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 Redis Cluster. Uma política de conexão de serviço permite autorizar a classe de serviço gcp-memorystore-redis 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 nas sub-redes especificadas 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 tutorial usa a rede default e a sub-rede default.
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-redis \ --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 Redis Cluster.
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 redis clusters create INSTANCE_ID \ --project=PROJECT_ID \ --region=REGION \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --replica-count=REPLICA_COUNT \ --network=projects/PROJECT_ID/global/networks/default
Substitua:
- INSTANCE_ID é o ID da instância.
- PROJECT_ID é o ID do projeto.
REGION é a região em que você quer provisionar a instância.
NODE_TYPE é o tipo de nó que você quer usar no cluster.
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 cluster. Para mais detalhes sobre a especificação do cluster, consulte Especificação de cluster e nó.
REPLICA_COUNT é o número de réplicas de leitura (por fragmento). Os valores aceitos são
0-5.
Descrever a instância
Para conferir os detalhes da instância, execute o comando describe:
gcloud
gcloud redis clusters describe INSTANCE_ID \ --project=PROJECT_ID \ --region=REGION
Substitua:
- INSTANCE_ID é 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 redis clusters delete INSTANCE_ID \ --project=PROJECT_ID \ --region=REGION
Substitua:
- INSTANCE_ID é o ID da instância.
- PROJECT_ID é o ID do projeto.
- REGION é a região em que a instância está localizada.