Crear instancias

En esta página se proporcionan instrucciones para crear instancias de Memorystore for Valkey.

Antes de empezar

Completa las instrucciones de la sección "Antes de empezar":

1. En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud.
   

   Nota: Si no tienes la intención de guardar los recursos que obtendrás a lo largo de este procedimiento, crea un proyecto en lugar de seleccionar uno disponible. Después de completar estos pasos, podrás eliminar el proyecto y, con él, todos los recursos asociados.

   
   Ir al selector de proyectos
2. Comprueba que la facturación esté habilitada en tu proyecto. Consulta cómo comprobar si la facturación está habilitada en un proyecto.

3. Instala e inicializa la CLI de Google Cloud.

   Nota: Si ya has instalado gcloud CLI, asegúrate de que tienes la versión más reciente ejecutando gcloud components update. Necesitas al menos la versión 489.0.0 de la interfaz de línea de comandos de gcloud para acceder a los comandos de la interfaz de línea de comandos de gcloud de Memorystore para Valkey.

4. Habilita la API Memorystore for Valkey
   Memorystore for Valkey
5. Habilita la API Network Connectivity.
   API Network Connectivity
6. Habilitar la API Service Consumer Management
   API Service Consumer Management

Otros requisitos previos

• Debes tener uno de estos roles de gestión de identidades y accesos en el Google Cloud proyecto que estés usando:
  • roles/memorystore.admin (el rol de gestión de identidades y accesos predefinido Administrador de Memorystore)
  • roles/owner (el rol básico de propietario de gestión de identidades y accesos)
  • roles/editor (el rol básico de gestión de identidades y accesos Editor)

Configurar redes

Consulta la página Redes para determinar si tienes que configurar una política de conexión de servicio.

Si no se ha creado una política de conexión de servicio para la red con la que vas a crear la instancia de Valkey, sigue las instrucciones de Redes para crearla.

Crear una instancia

Importante: Antes de seguir estos pasos, completa los que se indican en las secciones Antes de empezar y Configurar la red.

Consola

1. Ve a la página Memorystore para Valkey en la Google Cloud consola.

   Memorystore for Valkey

2. Haz clic en Crear instancia.

3. En la página Crear una instancia de Valkey, selecciona las configuraciones que quieras para la nueva instancia.

   • En Name your instance (Asigna un nombre a la instancia), introduce un ID de instancia. El ID de instancia solo puede contener letras minúsculas, números y guiones. También debe empezar por una letra y ser único en su región.
     • Por ejemplo: my-instance-1.
   • En Elegir región, selecciona una región para tu instancia.

   • En la sección Tipo de nodo, seleccione uno de los siguientes tipos de nodo:

     • Compartido principal (shared-core-nano)
     • Pequeño (standard-small)
     • Media (highmem-medium)
     • Extragrande (highmem-xlarge)

   • En Modo, elige entre Modo de clúster habilitado o Modo de clúster inhabilitado.

   • En Tamaño de instancia, define el número de particiones de tu instancia. El número de particiones determina la capacidad total de memoria para almacenar datos de instancias. Las instancias con el modo clúster inhabilitado solo admiten un fragmento. Para obtener más información, consulta Especificación de instancias y particiones.

   • Si quieres crear una instancia con réplicas, introduce el número de réplicas que quieras (por fragmento) en Réplicas. Los valores aceptables son Sin réplica, 1 réplica y 2 réplicas. El valor predeterminado es 1 Replica cuando se usa la consola Google Cloud .

   • En Configurar conexión, selecciona la red que quieras. Para obtener más información sobre las redes privadas de Memorystore para Valkey, consulta Redes.

   • Si quieres habilitar la autenticación de gestión de identidades y accesos, selecciona Habilitar autenticación de gestión de identidades y accesos.

   • Si quieres habilitar el cifrado en tránsito, selecciona Habilitar Seguridad en 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.

4. Haz clic en el botón Crear instancia.

gcloud

Para crear una instancia de Memorystore for 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

Haz los cambios siguientes:

• INSTANCE es el ID de la instancia de Memorystore for Valkey que vas a crear. El ID de instancia debe tener entre 1 y 63 caracteres, y solo puede contener letras en minúscula, números o guiones. Debe empezar por una letra minúscula y terminar por una letra minúscula o un número.

• REGION_ID es la región en la que quieres colocar la instancia.

Nota: Solo puedes crear instancias en las regiones admitidas de Memorystore para Valkey.

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

• REPLICA_COUNT es el número de réplicas que quieres (por partición). Los valores aceptados son 0, 1 y 2.

• NODE_TYPE es el tipo de nodo que has elegido. Los valores aceptados son:

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Precaución: Te recomendamos que utilices el tipo de nodo shared-core-nano solo para desarrollo o pruebas. Si ejecutas Memorystore for Valkey en un entorno de producción, te recomendamos que uses los tipos de nodo standard-small, highmem-medium o highmem-xlarge. Para obtener más información sobre estos tipos de nodos, consulta Elegir un tipo de nodo.

• ENGINE_VERSION es la versión del motor Valkey que has elegido. Los valores aceptados son VALKEY_7_2 y VALKEY_8_0.

• 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. Las instancias con el modo 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 Clúster. Si se omite este campo, la instancia se configurará de forma predeterminada con el modo de clúster habilitado. Para obtener más información, consulta el artículo Habilitar e inhabilitar el modo 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, el cifrado en tránsito está inhabilitado y la red autorizada es default.

Crear una instancia de una sola zona

En esta sección se proporcionan instrucciones para crear una instancia de zona única.

Importante: Antes de seguir estos pasos, completa los que se indican en las secciones Antes de empezar y Configurar la red.

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

Haz los cambios siguientes:

• INSTANCE es el ID de la instancia de Memorystore for Valkey que estás creando. El ID de instancia debe tener entre 1 y 63 caracteres, y solo puede incluir letras minúsculas, números o guiones. Debe empezar por una letra minúscula y terminar por una letra minúscula o un número.

• REGION_ID es la región en la que quieres colocar la instancia.

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

• REPLICA_COUNT es el número de réplicas que has elegido (por fragmento). Los valores aceptados son 0, 1 y 2.

• NODE_TYPE es el tipo de nodo que has elegido. Los valores aceptados son:

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Precaución: Te recomendamos que utilices el tipo de nodo shared-core-nano solo para desarrollo o pruebas. Si ejecutas Memorystore for Valkey en un entorno de producción, te recomendamos que uses los tipos de nodo standard-small, highmem-medium o highmem-xlarge. Para obtener más información sobre estos tipos de nodos, consulta Elegir un tipo de nodo.

• ENGINE_VERSION es la versión del motor Valkey que has elegido. Los valores aceptados son VALKEY_7_2 y VALKEY_8_0.

• 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. Si seleccionas el modo de clúster inhabilitado, solo puedes 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 el modo Clúster habilitado o inhabilitado. Si omite este campo, el modo predeterminado será Cluster Mode Enabled. Para obtener más información, consulta el artículo Habilitar e inhabilitar el modo 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 y multi-zone.

• ZONE es la zona en la que quieres aprovisionar tus nodos. Esta marca solo se aplica si se asigna el valor single-zone a --zone-distribution-config-mode=.