Provisionamento de instâncias em uma rede VPC compartilhada

Esta página lista os comandos da CLI gcloud necessários para configurar pré-requisitos, provisionar uma instância em um projeto de serviço, descrever e excluir uma instância. 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

Ative as APIs necessárias para configurar uma política de conexão de serviço, configurar a VPC compartilhada e criar uma instância do cluster do Memorystore para Redis.

gcloud

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

  2. Ative as seguintes APIs no projeto host:

    gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com

    Substitua HOST_PROJECT_ID pelo ID do projeto host.

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

Em seguida, crie uma política de conexão de serviço para o projeto host da rede VPC compartilhada, a região e as sub-redes em que você quer provisionar a instância do cluster do Memorystore para Redis. Normalmente, isso é feito pelo administrador da rede. No entanto, também é possível fazer isso se você tiver as funções necessárias para executar o comando.

Neste guia de início rápido, usamos a rede default e a sub-rede default.

gcloud

  1. Para criar a política de conexã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:

    • POLICY_NAME é o nome desejado para a política.
    • HOST_PROJECT_ID é o ID do projeto host.
    • REGION é a mesma região em que você quer provisionar a instância do cluster do Memorystore para Redis.

  2. Para validar se a política foi criada com sucesso, execute o comando list:

    gcloud network-connectivity service-connection-policies list \
  --region=REGION \
  --project=HOST_PROJECT_ID

    Substitua:

    • HOST_PROJECT_ID é o ID do projeto host.
    • 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 no projeto de serviço anexado à rede VPC compartilhada, 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:

  • INSTANCE_ID é o ID da instância.
  • SERVICE_PROJECT_ID é o ID do projeto de serviço.

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

  • HOST_PROJECT_ID é o ID do projeto host.

Descrever a instância

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

gcloud

gcloud redis clusters describe INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

Substitua:

  • INSTANCE_ID é o ID da instância.
  • SERVICE_PROJECT_ID é o ID do projeto de serviço.
  • REGION é a região em que a instância está localizada.

Excluir a instância

Para excluir uma instância, execute o seguinte comando:

gcloud

gcloud redis clusters delete INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

Substitua:

  • INSTANCE_ID é o ID da instância.
  • SERVICE_PROJECT_ID é o ID do projeto de serviço.
  • REGION é a região em que a instância está localizada.