Consulta los conectores compatibles para Application Integration.

Activador de Cloud Pub/Sub

El activador de Cloud Pub/Sub te permite ejecutar tu integración en función de los eventos de tu middleware de Pub/Sub.

Con este activador, puedes ejecutar una integración cada vez que un publicador escribe un mensaje en el tema que elegiste. El tema puede existir en el mismo proyecto de Google Cloud que la integración o en uno diferente. Cuando se ejecuta este activador, también se escribe el mensaje publicado en la variable de salida CloudPubSubMessage. Según tus requisitos, puedes usar esta variable en los activadores o las tareas posteriores.

Antes de comenzar

Asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud antes de configurar el activador de Cloud Pub/Sub.

• Asigna el Administrador de IAM de proyecto (roles/resourcemanager.projectIamAdmin) al usuario que crea este activador.
• Habilita la API de Pub/Sub para el proyecto de Google Cloud que tiene tu integración.
• Confirma que tienes un tema de Pub/Sub. Para crear un tema nuevo de Pub/Sub:
  1. Ve a la página de temas de Pub/Sub en la consola de Cloud.

     Ir a la página de temas de Pub/Sub

  2. Haga clic en Crear un tema.
  3. En el campo ID de tema, proporciona un nombre de tema único.
  4. Haz clic en Guardar.
  Nota: No es necesario que crees una suscripción para que el activador funcione. Application Integration crea automáticamente una suscripción para un tema, y puedes ver todas tus suscripciones en la página de suscripciones de Pub/Sub.

  A partir de la versión del 1 de diciembre de 2023 de Application Integration, se te facturará por tus suscripciones según las tarifas de facturación de Pub/Sub. Las suscripciones para tu activador de Cloud Pub/Sub existente seguirán funcionando como antes y no se facturan. Sin embargo, si actualizas el tema de un activador de Cloud Pub/Sub existente, la facturación de Pub/Sub se aplicará al activador actualizado de Cloud Pub/Sub.

Para obtener más información sobre cómo administrar el acceso mediante roles de IAM, consulta Control de acceso.

Para obtener información sobre cómo otorgar funciones a las principales, consulta Otorga, cambia y revoca acceso.

Agrega un activador de Cloud Pub/Sub

Para agregar un activador de Cloud Pub/Sub a una integración nueva o existente, sigue los pasos que se indican a continuación:

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

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integrations List (Lista de integraciones) y aparecerá una lista de todas las integraciones disponibles en el proyecto de Google Cloud.

3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

   Si creas una integración nueva, haz lo siguiente:

   1. Ingresa un nombre y una descripción en el panel Create Integration.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones, solo se enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
   3. Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración en la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integraciones para la región seleccionada.
   4. Haz clic en Crear.

   Esto abrirá la integración en la página del editor de integración.

4. En la barra de navegación del editor de integración, haz clic en Activadores para ver la lista de activadores disponibles.
5. Haz clic y coloca el elemento activador de Cloud Pub/Sub en el diseñador.

Configura un activador de Cloud Pub/Sub

Haz clic en el elemento activador de Cloud Pub/Sub en el editor de integración para ver el panel de configuración del activador y, luego, realiza las siguientes tareas:

1. Especifica el tema que el activador debe escuchar en el campo Tema de Pub/Sub en el siguiente formato:

   projects/PROJECT_ID/topics/TOPIC_ID

   Para ver todos los temas disponibles en el proyecto de Google Cloud, consulta la columna Nombre del tema en Temas.

   Reemplaza lo siguiente:
   • PROJECT_ID: Es el proyecto de Google Cloud en el que se crea tu tema.
   • TOPIC_ID: Es el ID del tema de Pub/Sub. El tema puede estar en el mismo proyecto de Google Cloud que el de tu integración o puede estar presente en un proyecto de Google Cloud diferente.
2. Selecciona la cuenta de servicio que quieres usar para el activador. Cuando seleccionas una cuenta de servicio, se te solicita que otorgues los roles necesarios. Para obtener más información, consulta Roles de IAM obligatorios.

   Si no hay cuentas de servicio, crea una. Para ello, haz clic en Crear nueva en el menú desplegable Cuenta de servicio.

   Nota: A partir de la versión del 1 de diciembre de 2023 de Application Integration, cuando configures el activador de Cloud Pub/Sub, debes especificar una cuenta de servicio para el activador. Los activadores de Pub/Sub existentes, que no tienen ninguna cuenta de servicio asociada a ellos, seguirán funcionando como antes. Sin embargo, si deseas modificar cualquiera de los activadores de Pub/Sub existentes, debes configurar una cuenta de servicio para seguir usando esos activadores.

Roles de IAM necesarios para las cuentas de servicio

Si haces clic en Otorgar cuando seleccionas una cuenta de servicio, se proporcionan automáticamente los siguientes roles a las distintas cuentas de servicio.

Cuenta de servicio	Se otorgó el rol de IAM
Cuenta de servicio predeterminada de Application Integration: [e-mail]	Editor de Pub/Sub (roles/pubsub.editor) Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) Si el proyecto de Google Cloud del tema de Pub/Sub es diferente del proyecto de Google Cloud de la integración, la cuenta de servicio predeterminada necesita el rol de editor de Pub/Sub en el proyecto de Google Cloud del tema.
Cuenta de servicio que seleccionas para este activador	Invocador de Application Integration (roles/integrations.integrationInvoker)

Resultado del activador

Para cada evento, el activador de Cloud Pub/Sub genera una variable de salida CloudPubSubMessage que puedes usar en tus tareas descendentes. La variable está en formato JSON y tiene la estructura PubsubMessage.

Consideraciones

• El tamaño máximo de un mensaje de Pub/Sub es de 10 MB. Para comprender todas las limitaciones de Pub/Sub, consulta las cuotas y límites de Pub/Sub.
• Es posible que Pub/Sub escriba el mismo mensaje más de una vez en un tema. Para comprender este comportamiento de Pub/Sub, consulta Al menos una entrega. Por lo tanto, debes diseñar tu integración para que sea idempotente, de modo que no permita que un mensaje se escriba más de una vez en un tema.
  Nota: El campo message_id en el encabezado del mensaje identifica de forma única un mensaje de Pub/Sub.
• Si anulas la publicación de una integración, la suscripción a Pub/Sub no se borra para evitar la pérdida de mensajes. Sin embargo, si borras la versión publicada o todas las versiones de una integración, también se borrará la suscripción a Pub/Sub.

Crea una suscripción con un filtro para tu integración

Si quieres configurar un filtro para que la suscripción a Pub/Sub procese eventos específicos de tu integración, sigue estos pasos:

1. Publica la integración con el activador de Cloud Pub/Sub configurado. En este paso, se crea la suscripción en el proyecto de integración.
2. En la consola de Google Cloud, ve a la página Suscripciones.

   Ir a Suscripciones

3. Abre la suscripción y copia todos los detalles, incluido el nombre.
4. Borra la suscripción existente.
5. Crea una suscripción nueva con todos los detalles de la suscripción borrada (incluido el nombre) que copiaste en el paso 3 y, además, agrega un filtro a la suscripción nueva.

   La suscripción recién creada activa la integración con mensajes filtrados.

Exclusiones del ANS

El activador de Cloud Pub/Sub depende del producto Pub/Sub. Como esta dependencia es externa a Application Integration, los Términos y Condiciones del Acuerdo de Nivel de Servicio (ANS) de Application Integration se aplican solo cuando el activador de Cloud Pub/Sub inicia correctamente la ejecución de una integración con active.