Aprovisionamiento de instancias en una red de VPC compartida

En esta página, se enumeran los comandos de gcloud CLI necesarios para configurar los requisitos previos, aprovisionar una instancia en un proyecto de servicio, describirla y borrarla. Para realizar estas tareas, debes seguir las instrucciones de cada sección de esta página.

Para obtener orientación más detallada sobre estas tareas, consulta las siguientes páginas:

Habilita las APIs

Habilita las siguientes APIs necesarias para configurar una política de conexión de servicio, configurar VPC compartida y crear una instancia de Memorystore para Valkey.

gcloud

  1. Habilita las siguientes APIs en el proyecto de servicio:

    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

    Reemplaza SERVICE_PROJECT_ID por el ID de tu proyecto de servicio.

  2. Habilita las siguientes APIs en el proyecto host:

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

    Reemplaza HOST_PROJECT_ID por el ID de tu proyecto host.

Crea una política de conexión de servicio

A continuación, se debe crear una política de conexión de servicio para el proyecto host de la VPC compartida en la que se define la política, la red, la región y las subredes en las que deseas aprovisionar la instancia de Memorystore for Valkey. Por lo general, el administrador de red realiza esta acción, o bien puedes tener el permiso necesario para ejecutar el comando si tienes el rol obligatorio.

En esta guía de inicio rápido, se usa la red default y la subred default. Las direcciones IP de tu instancia se asignan en esta subred predeterminada de la región.

gcloud

  1. Para crear la política de conexión de servicios, ejecuta el 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

    Reemplaza lo siguiente:

    • POLICY_NAME es el nombre de la política que deseas.
    • HOST_PROJECT_ID es el ID del proyecto host.
    • REGION es la misma región en la que deseas aprovisionar tu instancia de Memorystore para Valkey.

  2. Para validar si la política se creó correctamente, ejecuta el comando list:

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

    Reemplaza lo siguiente:

    • HOST_PROJECT_ID es el ID del proyecto host.
    • REGION es la región en la que se define la política de conexión de servicio.

Crea una instancia

Para crear una instancia en el proyecto de servicio adjunto a la VPC compartida, ejecuta el siguiente comando:

gcloud

gcloud beta memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--psc-auto-connections=network=projects/HOST_PROJECT_ID/global/networks/default,projectId=SERVICE_PROJECT_ID

Reemplaza lo siguiente:

  • INSTANCE es el ID de la instancia.
  • SERVICE_PROJECT_ID es el ID del proyecto de servicio.

  • REGION es la región en la que deseas aprovisionar tu instancia.

  • NODE_TYPE es el tipo de nodo que elegiste. Los valores aceptados son los siguientes:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    Para obtener más detalles sobre los tipos de nodos y la configuración de instancias, consulta Especificación de instancias y nodos.

  • SHARD_COUNT determina la cantidad de fragmentos en tu instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de instancias. Para obtener más detalles sobre la especificación de instancias, consulta Especificación de instancias y nodos.

  • REPLICA_COUNT es la cantidad deseada de réplicas de lectura (por fragmento). Los valores aceptados son 0, 1 y 2.

  • HOST_PROJECT_ID es el ID del proyecto host.

Describe la instancia

Para ver los detalles de la instancia, ejecuta el siguiente comando:

gcloud

gcloud beta memorystore instances describe INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

Reemplaza lo siguiente:

  • INSTANCE es el ID de la instancia.
  • SERVICE_PROJECT_ID es el ID del proyecto de servicio.
  • REGION es la región en la que se encuentra la instancia.

Borra la instancia

Para borrar una instancia, ejecuta el siguiente comando:

gcloud

gcloud beta memorystore instances delete INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

Reemplaza lo siguiente:

  • INSTANCE es el ID de la instancia.
  • SERVICE_PROJECT_ID es el ID del proyecto de servicio.
  • REGION es la región en la que se encuentra la instancia.