Aprovisionamento de instâncias numa rede VPC partilhada

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 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 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, tem de criar uma política de ligação de serviço para o projeto anfitrião da VPC partilhada onde a política está definida, a rede, a região e as sub-redes onde quer aprovisionar a instância do Memorystore for Valkey. Normalmente, esta ação é realizada pelo administrador de rede ou pode ter a autorização necessária para executar o comando se tiver a função necessária.

Este guia de início rápido usa a rede default e a sub-rede default. Os endereços IP da sua instância são atribuídos nesta sub-rede predefinida na região.

gcloud

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

  2. 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 à VPC partilhada, 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 o seguinte:

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

    • 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 ver mais detalhes sobre a especificação de instâncias, consulte o artigo Especificação de instâncias e nós.

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

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

Substitua o seguinte:

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

Substitua o seguinte:

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