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 seguintes APIs necessárias para configurar uma política de conexão de serviço, configurar a VPC compartilhada e criar uma instância do Memorystore para Valkey.

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 memorystore.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, uma política de conexão de serviço precisa ser criada para o projeto host da VPC compartilhada em que a política é definida, a rede, a região e as sub-redes em que você quer provisionar a instância do Memorystore para Valkey. Normalmente, isso é feito pelo administrador de rede, ou você pode ter a permissão necessária para executar o comando se tiver a função necessária.

Neste guia de início rápido, usamos a rede default e a sub-rede default. Os endereços IP da sua instância são alocados nessa sub-rede padrão na região.

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 \
  --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 sua instância do Memorystore para Valkey.

  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 à VPC compartilhada, execute o seguinte comando:

gcloud

gcloud memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/HOST_PROJECT_ID/global/networks/default", "projectId": "SERVICE_PROJECT_ID"}}]}]'

Substitua:

  • INSTANCE é 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:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • 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 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 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 memorystore instances describe INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

Substitua:

  • INSTANCE é 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 memorystore instances delete INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

Substitua:

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