Esta página apresenta os comandos da CLI gcloud necessários para configurar os pré-requisitos, aprovisionar uma instância num projeto de serviço, descrever uma instância e eliminar uma instância. Para realizar estas tarefas, deve seguir as instruções em cada secção desta página.
Para orientações mais detalhadas sobre estas tarefas, consulte as seguintes páginas:
Ativar APIs
Ative as seguintes APIs necessárias para configurar uma política de ligação de serviço, configurar a VPC partilhada e criar uma instância do Memorystore for Redis Cluster.
gcloud
Ative as seguintes APIs no projeto de serviço:
gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com gcloud services enable --project=SERVICE_PROJECT_ID redis.googleapis.com
Substitua SERVICE_PROJECT_ID pelo ID do projeto de serviço.
Ative as seguintes APIs no projeto anfitrião:
gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com
Substitua HOST_PROJECT_ID pelo ID do seu projeto anfitrião.
Crie uma política de ligação de serviço
Em seguida, crie uma política de ligação de serviço para o projeto anfitrião da rede VPC partilhada, a região e as sub-redes onde quer aprovisionar a instância do Memorystore for Redis Cluster. Normalmente, esta ação é realizada pelo administrador de rede. No entanto, também pode fazê-lo se lhe forem atribuídas as funções necessárias para executar o comando.
Este guia de início rápido usa a rede default
e a sub-rede default
.
gcloud
Para criar a política de ligação de serviço, execute o comando
create
:gcloud network-connectivity service-connection-policies create POLICY_NAME \ --network=default \ --project=HOST_PROJECT_ID \ --region=REGION \ --service-class=gcp-memorystore-redis \ --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default
Substitua o seguinte:
- POLICY_NAME é o nome da política pretendido.
- HOST_PROJECT_ID é o ID do projeto anfitrião.
- REGION é a mesma região onde quer aprovisionar a sua instância do Memorystore for Redis Cluster.
Para validar se a política foi criada com êxito, execute o comando
list
:gcloud network-connectivity service-connection-policies list \ --region=REGION \ --project=HOST_PROJECT_ID
Substitua o seguinte:
- HOST_PROJECT_ID é o ID do projeto anfitrião.
- REGION é a região onde a política de ligação de serviço está definida.
Crie uma instância
Para criar uma instância no projeto de serviço associado à rede de VPC partilhada, execute o seguinte comando:
gcloud
gcloud redis clusters create INSTANCE_ID \ --project=SERVICE_PROJECT_ID \ --region=REGION \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --replica-count=REPLICA_COUNT \ --network=projects/HOST_PROJECT_ID/global/networks/default
Substitua o seguinte:
- INSTANCE_ID é o ID da instância.
- SERVICE_PROJECT_ID é o ID do projeto de serviço.
REGION é a região onde quer aprovisionar a sua instância.
NODE_TYPE é o tipo de nó escolhido. Os valores aceites são:
redis-shared-core-nano
redis-standard-small
redis-highmem-medium
redis-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 do cluster. Para ver mais detalhes sobre a especificação de clusters, consulte o artigo Especificação de clusters e nós.
REPLICA_COUNT é o número desejado de réplicas de leitura (por fragmento). Os valores aceites são
0
,1
e2
.HOST_PROJECT_ID é o ID do projeto anfitrião.
Descreva a instância
Para ver os detalhes da instância, execute o seguinte comando:
gcloud
gcloud redis clusters describe INSTANCE_ID \ --project=SERVICE_PROJECT_ID \ --region=REGION
Substitua o seguinte:
- INSTANCE_ID é o ID da instância.
- SERVICE_PROJECT_ID é o ID do projeto de serviço.
- REGION é a região onde a sua instância está localizada.
Elimine a instância
Para eliminar uma instância, execute o seguinte comando:
gcloud
gcloud redis clusters delete INSTANCE_ID \ --project=SERVICE_PROJECT_ID \ --region=REGION
Substitua o seguinte:
- INSTANCE_ID é o ID da instância.
- SERVICE_PROJECT_ID é o ID do projeto de serviço.
- REGION é a região onde a sua instância está localizada.