Activador de Cloud Pub/Sub

El activador de Cloud Pub/Sub te permite ejecutar tu integración en función de los eventos en 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. 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 los siguientes roles de IAM a tu cuenta de servicio predeterminada (service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com):
  • 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.

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 IU de Apigee, selecciona tu organización de Apigee.
  2. Haz clic en Desarrollar > Integraciones.
  3. Elige una integración existente o crea una nueva haciendo clic en Crear integración.

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

    1. Escribe un nombre y una descripción en el diálogo Crear integración.
    2. En la lista de regiones compatibles, elige Región para la integración.
    3. Haz clic en Crear.

    Esto abrirá la integración en la página del diseñador de integración.

  4. En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > 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:

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.

Aquí:
  • PROJECT_ID es el proyecto de Google Cloud en el que se crea el tema.
  • TOPIC_ID es el ID de tu tema de Pub/Sub.

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.