En esta página, se enumeran los comandos de gcloud CLI necesarios para configurar los requisitos previos, aprovisionar una instancia, describirla y borrarla en una red de VPC estándar. Si deseas obtener instrucciones para realizar estas tareas en una red de VPC compartida, consulta Aprovisionamiento de instancias en una red de VPC compartida. 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
Primero, habilita las APIs de esta sección. Estas APIs son necesarias porque Memorystore para Valkey usa la automatización de conectividad del servicio Private Service Connect para automatizar la conectividad de las instancias. Para obtener más información, consulta Herramientas de redes.
Para habilitar las API, 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
Reemplaza lo siguiente:
- PROJECT_ID es el ID del proyecto.
Crea una política de conexión de servicio
Debes crear una política de conexión de servicio para el proyecto, la red y la región en la que deseas aprovisionar la instancia de Memorystore para Valkey. Una política de conexión de servicio te permite autorizar
la clase de servicio gcp-memorystore
para crear una conexión de Private Service Connect
entre 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 necesarios.
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.
Para crear la política de conexión del 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
Reemplaza lo siguiente:
- POLICY_NAME es el nombre de la política que deseas.
- PROJECT_ID es el ID del proyecto.
- REGION es la misma región en la que deseas aprovisionar tu instancia de Memorystore para Valkey.
Valida la creación de la política de conexión de servicio
Ejecuta el comando list
para validar si la política se creó correctamente:
gcloud
gcloud network-connectivity service-connection-policies list --region=REGION --project=PROJECT_ID
Reemplaza lo siguiente:
- 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.
Crea una instancia
Para crear una instancia, ejecuta el comando create
:
gcloud
gcloud beta memorystore instances create INSTANCE \ --project=PROJECT_ID \ --location=REGION \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --replica-count=REPLICA_COUNT \ --psc-auto-connections=network=projects/PROJECT_ID/global/networks/NETWORK_ID,projectId=PROJECT_ID \
Reemplaza lo siguiente:
- INSTANCE es el ID de la instancia.
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
y2
.PROJECT_ID es el ID del proyecto en el que deseas crear tu instancia.
NETWORK_ID es el ID de la red que deseas usar para crear tu instancia.
Describe la instancia
Para ver los detalles de la instancia, ejecuta el comando describe
:
gcloud
gcloud beta memorystore instances describe INSTANCE \ --project=PROJECT_ID \ --location=REGION
Reemplaza lo siguiente:
- INSTANCE es el ID de la instancia.
- PROJECT_ID es el ID del proyecto.
- REGION es la región en la que se encuentra la instancia.
Borra la instancia
Para borrar una instancia, ejecuta el comando delete
:
gcloud
gcloud beta memorystore instances delete INSTANCE \ --project=PROJECT_ID \ --location=REGION
Reemplaza lo siguiente:
- INSTANCE es el ID de la instancia.
- PROJECT_ID es el ID del proyecto.
- REGION es la región en la que se encuentra la instancia.