Conéctate a una caché de Redis a través de Cloud Memorystore

Precaución: Las integraciones de Cloud Run se descontinuarán de la consola de Google Cloud y Google Cloud CLI para los usuarios nuevos en octubre de 2024. Si ya eres usuario, seguirás teniendo acceso hasta enero de 2025. No es necesario que realices ninguna acción. Los servicios implementados que usan estas integraciones seguirán funcionando. Te recomendamos que realices la transición para usar las experiencias de producto individuales para cada integración que hayas implementado. Para conectarte a una instancia de Redis directamente desde tu servicio de Cloud Run, tu servicio necesita acceso a la red de VPC autorizada de la instancia de Redis. Para obtener más información, consulta Cómo preparar la salida de la red de VPC para la configuración.

Vista previa — Using the Cloud Run integrations

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para configurar una caché de datos distribuida en la memoria para el servicio de Cloud Run, puedes usar Memorystore para Redis. Con Memorystore para Redis, usas un almacén de datos de Redis en memoria para almacenar la caché de la aplicación con escalamiento, seguridad y alta disponibilidad. Puedes conectarte a una instancia de Redis directamente desde tu servicio de Cloud Run, pero esto requiere pasos adicionales de configuración de un conector de acceso a VPC sin servidores.

Mediante las integraciones de Cloud Run (vista previa) que se describen en esta página, puedes conectar con rapidez el servicio de Cloud Run a una caché nueva de Redis con Memorystore sin tener que configurar un conector de Acceso a VPC sin servidores. Si deseas conectar tu servicio de Cloud Run a una instancia de Redis existente, consulta Conéctate a una instancia de Redis desde un servicio de Cloud Run.

Antes de comenzar

• Asegúrate de que el servicio de Cloud Run con el que te integras ya esté implementado.
• Revisa la página de precios de Memorystore. Se te facturan los recursos individuales usados en la integración.

Roles obligatorios

Para usar las integraciones de Cloud Run, tú o tu administrador deben otorgar roles de IAM en dos principales diferentes.

Haz clic para ver los roles necesarios para tu Cuenta de Google

Para obtener los permisos que necesitas para usar las integraciones de Cloud Run, pídele a tu administrador que otorgue a tu Cuenta de Google los siguientes roles de IAM en tu proyecto:

• Desarrollador de Cloud Run (roles/run.developer)
• Visualizador de Compute (roles/compute.viewer)
• Desarrollador de Serverless Integrations (roles/runapps.developer)
• Operador de Serverless Integrations (roles/runapps.operator)
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser)

Haz clic para ver los roles necesarios para la cuenta de servicio

Para implementar el servicio de Cloud Run, puedes usar la cuenta de servicio predeterminada de Compute Engine creada automáticamente o especificar una cuenta de servicio administrada por el usuario. Esta cuenta de servicio debe tener los siguientes roles:

• Desarrollador de Cloud Run (roles/run.developer)
• Escritor de bucket de servicios (roles/logging.bucketWriter)
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser)
• Administrador de almacenamiento (roles/storage.admin)
• Administrador de Cloud Memorystore para Redis (roles/redis.admin)
• Visualizador de Compute (roles/compute.viewer)
• Administrador de Acceso a VPC sin servidores (roles/vpcaccess.admin)

Conecta un servicio a una nueva caché de Redis

Cualquier cambio en la configuración conlleva la creación de una revisión nueva. Las revisiones posteriores también adoptarán esta configuración de manera automática, a menos que realices actualizaciones explícitas para cambiarla.

Puedes conectar un servicio de Cloud Run a una caché de Redis a través de la consola o la línea de comandos. Si no especificas un tamaño de memoria, se usa una caché de 1 gigabyte.

Console

1. En la consola de Google Cloud, ve a la página Cloud Run.

   Ir a Cloud Run

2. Haz clic en el servicio de la lista de servicios que deseas usar en esta integración.

3. Haz clic en la pestaña Integraciones.

4. Haz clic en Agregar integración.

5. Haz clic en Redis: Google Cloud MemoryStore.

   

6. Acepta los valores predeterminados o cambia el nombre y el tamaño de la caché a los valores que deseas usar.

7. Si se te solicita que habilites una lista de APIs, haz clic en Habilitar y espera a que las API se habiliten.

8. En Recursos, observa los recursos nuevos que se crearán como resultado de esta integración.

9. Haz clic en Enviar y espera a que se creen la integración y los recursos. Esto puede tardar hasta 15 minutos.

gcloud

1. Actualiza a la versión más reciente de Google Cloud CLI:

   gcloud components update

2. Crea la integración:

   gcloud beta run integrations create \
   --type=redis \
   --service=SERVICE \
   --parameters=memory-size-gb=MEMORY-SIZE

   Reemplaza lo siguiente:

   • SERVICE por el nombre de servicio de Cloud Run
   • MEMORY-SIZE por el tamaño que deseas en gigabytes de caché. El valor predeterminado es 1 GB.

   De manera opcional, puedes incluir la marca --service-account=SERVICE_ACCOUNT_EMAIL.

   • Reemplaza SERVICE_ACCOUNT_EMAIL por la dirección de correo electrónico de la cuenta de servicio administrada por el usuario ([e-mail]) que se usa para implementar el servicio. Omite esta marca si deseas usar la cuenta de servicio de procesamiento predeterminada (SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com).

     Para seguir usando la cuenta de servicio especificada cuando implementas integraciones de Cloud Run, ejecuta lo siguiente:

     gcloud config set runapps/deployment-service-account

3. Espera hasta 15 minutos, durante los cuales se crea y se conecta una caché de Redis por completo configurada. Además, se crea una revisión nueva de Cloud Run, incluida la configuración de red y las variables de entorno necesarias para la caché de Redis. Cuando se completa el proceso, se muestra el siguiente mensaje:

   [redis] integration [redis-xxx] has been updated successfully.
   
   To connect to the Redis instance, utilize the environment variables
   REDISHOST and REDISPORT. These have been added to the Cloud Run service
   for you.

   Puedes verificar el estado con gcloud beta run integrations describe

Actualiza las integraciones de caché de Redis

La actualización de una integración actualiza todos los recursos de Google Cloud asociados a esa integración. Para actualizar una integración de caché de Redis desde tu servicio de Cloud Run, sigue estos pasos:

Console

1. En la consola de Google Cloud, ve a la página Cloud Run.

   Ir a Cloud Run

2. Haz clic en el servicio que deseas actualizar.

3. Haz clic en la pestaña Integraciones.

4. Ubica la integración de la caché de Redis y haz clic en Editar.

5. Cuando termines de actualizar los campos, haz clic en Actualizar.

gcloud

1. Usa el siguiente comando para obtener una lista de las integraciones disponibles:

   gcloud beta run integrations list

2. Ejecuta el comando para actualizar la integración:

   gcloud beta run integrations update INTEGRATION_NAME

   Reemplaza lo siguiente:

   • Reemplaza INTEGRATION_NAME por el nombre de tu integración de caché de Redis.

   De manera opcional, puedes usar las siguientes opciones de marcas:

   Opción	Descripción
   --parameters	El tamaño de la memoria en gigabytes para la caché.
   --service-account	La dirección de correo electrónico de la cuenta de servicio administrada por el usuario que se debe especificar cuando se actualiza el servicio. Esta cuenta de servicio anula la cuenta de servicio anterior que se usó en la implementación.

Visualiza integraciones de caché de Redis

Para ver el estado actual de las integraciones de caché de Redis para el servicio de Cloud Run, sigue estos pasos:

Console

1. En la consola de Google Cloud, ve a la página Cloud Run.

   Ir a Cloud Run

2. Haz clic en el servicio de la lista de servicios que deseas usar en esta integración.

3. Haz clic en la pestaña Integraciones.

4. Ubica la integración de Firebase Hosting que te interese y haz clic en Ver detalles.

gcloud

1. Usa el siguiente comando para obtener una lista de las integraciones disponibles:

   gcloud beta run integrations list

2. Con un nombre de la lista que se muestra, muestra sus detalles:

   gcloud beta run integrations describe INTEGRATION_NAME

   Reemplaza INTEGRATION_NAME por el nombre de tu integración de caché de Redis.

Borra integraciones de caché de Redis

Si borras una integración, también se borrarán todos los recursos de Google Cloud asociados a esa integración, pero no se borrará tu servicio de Cloud Run.

Para borrar una integración de caché de Redis desde tu servicio de Cloud Run, sigue estos pasos:

Console

1. En la consola de Google Cloud, ve a la página Cloud Run.

   Ir a Cloud Run

2. Haz clic en el servicio del que deseas borrar una integración.

3. Haz clic en la pestaña Integraciones.

4. Ubica la integración de Firebase Hosting que te interese y haz clic en el ícono de puntos suspensivos a la derecha de la integración. Luego, haz clic en Borrar.

gcloud

1. Usa el siguiente comando para obtener una lista de las integraciones disponibles:

   gcloud beta run integrations list

2. Con un nombre de la lista que se muestra, borra la integración:

   gcloud beta run integrations delete INTEGRATION_NAME

   Reemplaza lo siguiente:

   • Reemplaza INTEGRATION_NAME por el nombre de tu integración de caché de Redis.

   De manera opcional, puedes usar las siguientes opciones de marcas:

   Opción	Descripción
   --service-account	La dirección de correo electrónico de la cuenta de servicio administrada por el usuario para realizar la operación de eliminación.

Accede a la caché de Redis en tu código

Ten en cuenta que, como resultado de completar la integración descrita en esta página, las variables de entorno REDISHOST y REDISPORT se agregan automáticamente y están disponibles para que las use tu código de servicio de Cloud Run.

Código de muestra para servicios que usan Redis

Consulta la documentación de Memorystore para ver las muestras de código completas de Cloud Run y Redis en varios lenguajes que usan Redis.

Limitaciones

• Las integraciones de Cloud Run solo se admiten en ciertas regiones. Si necesitas usar una región que no es compatible con las integraciones de Cloud Run, consulta Conéctate a una instancia de Redis desde un servicio de Cloud Run.
• Solo se admiten los conectores de VPC en la red de VPC predeterminada. No se admiten las redes heredadas.