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 for Redis Cluster 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 redis.googleapis.com

Substitua:

  • PROJECT_ID é o ID do projeto;

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

Crie 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 cluster do Memorystore para Redis. Com uma política de conexão de serviço, você autoriza 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 é definida e nas sub-redes especificadas 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.

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 desejado para a política.
  • PROJECT_ID é o ID do projeto.
  • REGION é a mesma região em que você quer provisionar a instância do cluster do Memorystore para Redis.

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 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ó escolhido. Os valores aceitos 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 mais detalhes sobre a especificação do cluster, consulte Especificação de cluster e nó.

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

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.