Aprovisionamento de instâncias numa rede de VPC

Esta página lista os comandos da CLI gcloud necessários para configurar os pré-requisitos, aprovisionar uma instância, descrever uma instância e eliminar uma instância numa rede VPC padrão. Para obter instruções sobre como realizar estas tarefas numa rede VPC partilhada, consulte o artigo Aprovisionamento de instâncias numa rede VPC partilhada. 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

Comece por ativar as APIs nesta secção. Estas APIs são necessárias porque o Memorystore for Valkey usa a automatização da conetividade do serviço Private Service Connect para automatizar a conetividade das instâncias. Para mais informações, consulte o artigo Redes.

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 memorystore.googleapis.com

Substitua o seguinte:

  • PROJECT_ID é o ID do seu projeto.

Crie uma política de ligação de serviço

Tem de criar uma política de ligação de serviço para o projeto, a rede e a região onde quer aprovisionar a instância do Memorystore for Valkey. Uma política de ligação de serviço permite-lhe autorizar a classe de serviço gcp-memorystore a criar uma ligação do Private Service Connect entre as redes VPC do produtor e do consumidor na região onde a política está definida e na sub-rede que a política especifica.

Para ver a autorização necessária para criar uma política de ligação de serviço, consulte as funções necessárias.

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.

Para criar a política de ligação de serviços, 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 \
  --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/default

Substitua o seguinte:

  • POLICY_NAME é o nome da política pretendido.
  • PROJECT_ID é o ID do projeto.
  • REGION é a mesma região onde quer aprovisionar a sua instância do Memorystore for Valkey.

Valide a criação da política de ligação de serviços

Valide se a política foi criada com êxito executando o comando list:

gcloud

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

Substitua o seguinte:

  • PROJECT_ID é o ID do projeto.
  • 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, execute o comando create:

gcloud

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

Substitua o seguinte:

  • INSTANCE é o ID da instância.

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

  • PROJECT_ID é o ID do projeto onde quer criar a instância.

  • NETWORK_ID é o ID da rede que quer usar para criar a sua instância.

Descreva a instância

Para ver os detalhes da instância, execute o comando describe:

gcloud

gcloud memorystore instances describe INSTANCE \
--project=PROJECT_ID \
--location=REGION

Substitua o seguinte:

  • INSTANCE é o ID da instância.
  • PROJECT_ID é o ID do projeto.
  • REGION é a região onde a sua instância está localizada.

Elimine a instância

Para eliminar uma instância, execute o comando delete:

gcloud

gcloud memorystore instances delete INSTANCE \
--project=PROJECT_ID \
--location=REGION

Substitua o seguinte:

  • INSTANCE é o ID da instância.
  • PROJECT_ID é o ID do projeto.
  • REGION é a região onde a sua instância está localizada.