En esta página, se proporcionan instrucciones para crear instancias de Memorystore para Valkey.
Antes de comenzar
Completa las instrucciones de antes de comenzar:
- En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud.
Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.
Ir al selector de proyectos - Asegúrate de tener habilitada la facturación para tu proyecto. Obtén información para verificar si la facturación está habilitada en un proyecto.
Instala y, luego, inicializa Google Cloud CLI.
Nota: Si ya instalaste gcloud CLI, asegúrate de tener la versión más reciente ejecutando
gcloud components update
. Debes tener al menos la versión489.0.0
de gcloud CLI para acceder a los comandos de gcloud CLI de Memorystore para Valkey.-
Habilita la API de Memorystore for Valkey.
Memorystore for Valkey -
Habilita la API de Network Connectivity.
API de Network Connectivity -
Habilita la API de Service Consumer Management.
API de Service Consumer Management
Otros requisitos
- Debes tener uno de estos roles de IAM en el proyecto Google Cloud que usas:
roles/memorystore.admin
(el rol de IAM predefinido de administrador de Memorystore)roles/owner
(el rol de IAM básico de propietario)roles/editor
(el rol básico de IAM de Editor)
Configura las herramientas de redes
Lee la página Networking para determinar si necesitas configurar una política de conexión de servicio.
Si no se creó una política de conexión de servicio para la red con la que crearás la instancia de Valkey, sigue las instrucciones de Networking para crearla.
Crea una instancia
Console
Ve a la página Memorystore para Valkey en la consola de Google Cloud .
Haz clic en Crear instancia.
En la página Crear una instancia de Valkey, selecciona la configuración que desees para tu nueva instancia.
- En Name your instance, ingresa un ID de instancia. El ID de instancia solo debe contener letras minúsculas, números y guiones. Además, debe comenzar con una letra y ser único en su región.
- Por ejemplo:
my-instance-1
.
- Por ejemplo:
- En Elegir región, selecciona una región para tu instancia.
- En Node Type, selecciona tu tipo de nodo.
- En Modo, selecciona Modo de clúster habilitado o Modo de clúster inhabilitado.
- En Tamaño de la instancia, define la cantidad de fragmentos para tu instancia. El recuento de fragmentos determina la capacidad total de memoria para almacenar datos de instancias. Las instancias con el modo de clúster inhabilitado solo admiten un fragmento. Para obtener más información, consulta Especificación de instancias y fragmentos.
- Si deseas crear una instancia con réplicas, ingresa la cantidad de réplicas que desees (por fragmento) en Réplicas. Los valores aceptables son No Replica, 1 Replica y 2 Replicas. El valor predeterminado es 1 réplica cuando se usa la consola de Google Cloud .
- En Configurar conexión, selecciona la red que desees. Para obtener más detalles sobre las redes privadas de Memorystore para Valkey, consulta Herramientas de redes.
- Si deseas habilitar la autenticación de IAM, selecciona Habilitar AUTH de IAM.
- Si deseas habilitar la encriptación en tránsito, selecciona Habilitar la seguridad de la capa de transporte (TLS).
- En Elegir versión, selecciona tu versión de Valkey. La versión 7.2 de Valkey es la predeterminada.
- En Name your instance, ingresa un ID de instancia. El ID de instancia solo debe contener letras minúsculas, números y guiones. Además, debe comenzar con una letra y ser único en su región.
Haz clic en el botón Crear instancia.
gcloud
Para crear una instancia de Memorystore para Valkey, ejecuta el comando create
:
gcloud memorystore instances create INSTANCE \ --location=REGION_ID \ --endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \ --replica-count=REPLICA_COUNT \ --node-type=NODE_TYPE \ --engine-version=ENGINE_VERSION \ --shard-count=SHARD_COUNT \ --mode=MODE
Reemplaza lo siguiente:
INSTANCE es el ID de la instancia de Memorystore para Valkey que creas. El ID de tu instancia debe tener entre 1 y 63 caracteres, y solo puede contener letras en minúscula, números o guiones. Debe comenzar con una letra minúscula y terminar con una letra minúscula o un número.
REGION_ID es la región en la que deseas colocar la instancia.
PROJECT_ID es el ID del proyecto en el que deseas crear la instancia.
NETWORK_ID es el ID de la red que deseas usar para crear tu instancia.
REPLICA_COUNT es la cantidad de réplicas que deseas (por fragmento). Los valores aceptados son
0
,1
y2
.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 las configuraciones de instancias, consulta Especificación de instancias y nodos.
ENGINE_VERSION es la versión del motor de Valkey que elegiste. Los valores aceptados son
VALKEY_7_2
yVALKEY_8_0
.SHARD_COUNT determina la cantidad de fragmentos de tu instancia. El recuento de fragmentos determina la capacidad total de memoria para almacenar datos de instancias. Las instancias con el modo de clúster inhabilitado solo admiten un fragmento. Para obtener más información, consulta Especificación de instancias y nodos.
MODE determina si la instancia tiene habilitado o inhabilitado el modo de clúster. Si se omite este campo, la instancia se establece de forma predeterminada en el modo de clúster habilitado. Para obtener más información, consulta Cómo habilitar y inhabilitar el modo de clúster.
Por ejemplo:
Ejemplo de Cluster Mode Enabled
gcloud memorystore instances create my-instance \ --location=us-central1 \ --endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \ --replica-count=2 \ --node-type=highmem-medium \ --shard-count=8 \ --mode=cluster
Ejemplo de Cluster Mode Disabled
gcloud memorystore instances create my-instance \ --location=us-central1 \ --endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \ --shard-count=1 \ --replica-count=2 \ --node-type=highmem-medium \ --mode=cluster-disabled
De forma predeterminada, la encriptación en tránsito está inhabilitada y la red autorizada es default
.
Crea una instancia de zona única
En esta sección, se proporcionan instrucciones para crear una instancia de una sola zona.
gcloud
Para crear una instancia de una sola zona, ejecuta el comando create
:
gcloud memorystore instances create INSTANCE \ --location=REGION_ID \ --endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \ --replica-count=REPLICA_COUNT \ --node-type=NODE_TYPE \ --engine-version=ENGINE_VERSION \ --shard-count=SHARD_COUNT \ --zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \ --zone-distribution-config=ZONE \ --mode=MODE
Reemplaza lo siguiente:
INSTANCE es el ID de la instancia de Memorystore para Valkey que creas. El ID de instancia debe tener entre 1 y 63 caracteres, y solo debe incluir letras en minúscula, números o guiones. Debe comenzar con una letra minúscula y terminar con una letra minúscula o un número.
REGION_ID es la región en la que deseas colocar la instancia.
PROJECT_ID es el ID del proyecto en el que deseas crear la instancia.
NETWORK_ID es el ID de la red que deseas usar para crear tu instancia.
REPLICA_COUNT es la cantidad de réplicas que elegiste (por fragmento). Los valores aceptados son
0
,1
y2
.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 las configuraciones de instancias, consulta Especificación de instancias y nodos.
ENGINE_VERSION es la versión del motor de Valkey que elegiste. Los valores aceptados son
VALKEY_7_2
yVALKEY_8_0
.SHARD_COUNT determina la cantidad de fragmentos de tu instancia. El recuento de fragmentos determina la capacidad total de memoria para almacenar datos de instancias. Si seleccionas el modo Cluster Mode Disabled, solo podrás especificar un fragmento para tu instancia. Para obtener más información, consulta Especificación de instancias y nodos.
MODE determina si la instancia debe tener habilitado o inhabilitado el modo de clúster. Si omites este campo, el modo predeterminado será Cluster Mode Enabled. Para obtener más información, consulta Cómo habilitar y cómo inhabilitar el modo de clúster.
ZONE_DISTRIBUTION_CONFIG_MODE es el modo que te permite elegir entre aprovisionar una instancia de una sola zona o una instancia de varias zonas. El valor predeterminado es multizona. Los valores aceptados son
single-zone
ymulti-zone
.ZONE es la zona en la que deseas aprovisionar tus nodos. Esta marca solo se aplica si
--zone-distribution-config-mode=
se configura comosingle-zone
.