En esta página se enumeran los comandos de la CLI de gcloud necesarios para configurar los requisitos previos, aprovisionar una instancia, describir una instancia y eliminar una instancia en una red VPC estándar. Para obtener instrucciones sobre cómo realizar estas tareas en una red de VPC compartida, consulta Aprovisionamiento de instancias en una red de VPC compartida. Para llevar a cabo estas tareas, debes seguir las instrucciones de cada sección de esta página.
Para obtener instrucciones más detalladas sobre estas tareas, consulta las siguientes páginas:
Habilitar APIs
Empieza habilitando las APIs de esta sección. Estas APIs son necesarias porque Memorystore for Valkey usa la automatización de la conectividad de servicios de Private Service Connect para automatizar la conectividad de las instancias. Para obtener más información, consulta Redes.
Para habilitar las APIs, ejecuta los siguientes 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
Haz los cambios siguientes:
- PROJECT_ID es el ID del proyecto.
Crear una política de conexión de servicio
Debe crear una política de conexión de servicio
para el proyecto, la red y la región en los que quiera aprovisionar la
instancia de Memorystore para Valkey. Una política de conexión de servicio te permite autorizar a la clase de servicio gcp-memorystore
para que cree una conexión de Private Service Connect entre las redes de VPC de productor y consumidor en la región donde se define la política y en la subred que especifica la política.
Para ver el permiso necesario para crear una política de conexión de servicio, consulta los roles obligatorios.
En esta guía de inicio rápido se usan la red default
y la subred default
. Las direcciones IP de tu instancia se asignan en esta subred predeterminada de la región.
Para crear la política de conexión de servicio, ejecuta el siguiente 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
Haz los cambios siguientes:
- POLICY_NAME es el nombre que quieres dar a la política.
- PROJECT_ID es el ID del proyecto.
- REGION es la misma región en la que quieres aprovisionar tu instancia de Memorystore para Valkey.
Validar la creación de la política de conexión de servicio
Para comprobar si la política se ha creado correctamente, ejecuta el comando list
:
gcloud
gcloud network-connectivity service-connection-policies list --region=REGION --project=PROJECT_ID
Haz los cambios siguientes:
- PROJECT_ID es el ID del proyecto.
- REGION es la región en la que se define la política de conexión de servicio.
Crear una instancia
Para crear una instancia, ejecuta el 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"}}]}]'
Haz los cambios siguientes:
- INSTANCE es el ID de instancia.
REGION es la región en la que quieres aprovisionar tu instancia.
NODE_TYPE es el tipo de nodo que has elegido. Los valores aceptados son:
shared-core-nano
standard-small
highmem-medium
highmem-xlarge
SHARD_COUNT determina el número de particiones de tu instancia. El número de particiones determina la capacidad total de memoria para almacenar datos de instancias. Para obtener más información sobre la especificación de instancias, consulta Especificación de instancias y nodos.
REPLICA_COUNT es el número de réplicas de lectura que quieres (por fragmento). Los valores aceptados son
0
,1
y2
.PROJECT_ID es el ID del proyecto en el que quieres crear la instancia.
NETWORK_ID es el ID de la red que quieres usar para crear tu instancia.
Describe la instancia
Para ver los detalles de la instancia, ejecuta el comando describe
:
gcloud
gcloud memorystore instances describe INSTANCE \ --project=PROJECT_ID \ --location=REGION
Haz los cambios siguientes:
- INSTANCE es el ID de instancia.
- PROJECT_ID es el ID del proyecto.
- REGION es la región en la que se encuentra tu instancia.
Eliminar la instancia
Para eliminar una instancia, ejecuta el comando delete
:
gcloud
gcloud memorystore instances delete INSTANCE \ --project=PROJECT_ID \ --location=REGION
Haz los cambios siguientes:
- INSTANCE es el ID de instancia.
- PROJECT_ID es el ID del proyecto.
- REGION es la región en la que se encuentra tu instancia.