Consulta los conectores compatibles con 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 Pub/Sub.

Con este activador, puedes ejecutar una integración cada vez que un editor escriba un mensaje en el tema que elijas. El tema puede estar en el mismo Google Cloud proyecto que la integración o en otro Google Cloud proyecto. Cuando se ejecuta este activador, también escribe el mensaje publicado en la variable de salida CloudPubSubMessage. En función de tus requisitos, puedes usar esta variable en los activadores o tareas posteriores.

Para saber cómo crear una integración de muestra mediante Application Integration y el activador de Cloud Pub/Sub, consulta Escuchar el tema de Cloud Pub/Sub y enviar un correo electrónico.

Con este activador, puedes ejecutar una integración cada vez que un editor escriba un mensaje en el tema que elijas. Cuando se ejecuta este activador, también escribe el mensaje publicado en la variable de salida CloudPubSubMessage. En función de tus requisitos, puedes usar esta variable en los activadores o tareas posteriores.

Antes de empezar

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

  • Asigna el rol Administrador de gestión de identidades y accesos de proyectos (roles/resourcemanager.projectIamAdmin) al usuario que cree este activador.
  • Habilita la API Pub/Sub en el Google Cloud proyecto que tenga tu integración.

    • Si la API Pub/Sub está protegida por un perímetro de servicio, asegúrate de definir los siguientes roles de gestión de identidades y accesos para gestionar estos perímetros de servicio:

    • Administrador de contextos de acceso (roles/accesscontextmanager.policyAdmin)
    • Editor del Administrador de contextos de acceso (roles/accesscontextmanager.policyEditor)
    • Lector del Administrador de contextos de acceso (roles/accesscontextmanager.policyReader)

  • Confirma que tienes un tema de Pub/Sub. Para crear un tema de Pub/Sub, sigue estos pasos:
    1. Ve a la página de temas de Pub/Sub en la consola de Cloud.

      Ir a la página Temas de Pub/Sub

    2. Haz clic en Crear un tema.
    3. En el campo Topic ID (ID de tema), proporcione un nombre de tema único.
    4. Haz clic en Guardar.
Para obtener más información sobre cómo gestionar el acceso con roles de gestión de identidades y accesos, consulta el artículo sobre el control de acceso.

Para obtener información sobre cómo conceder roles a principales, consulta Conceder, cambiar y revocar el acceso.

Añadir un activador de Cloud Pub/Sub

Para añadir un activador de Cloud Pub/Sub a una integración nueva o ya creada, sigue estos pasos:
  1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

    Ir a Application Integration

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

    Aparecerá la página Lista de integraciones, donde se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Seleccione una integración o haga clic en Crear integración para crear una.

    Si vas a crear una integración:

    1. Escribe un nombre y una descripción en el panel Crear integración.
    2. Selecciona una región para la integración.
    3. Selecciona una cuenta de servicio para la integración. Puede 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 de la barra de herramientas de integración.
    4. Haz clic en Crear.

    La integración que acabas de crear se abre en el editor de integraciones.

  4. En la barra de navegación del editor de integraciones, haga clic en Activadores para ver la lista de activadores disponibles.
  5. Haz clic en el elemento Activador de Cloud Pub/Sub y colócalo en el diseñador.

Configurar un activador de Cloud Pub/Sub

Haga clic en el elemento Activador de Cloud Pub/Sub del editor de integraciones para ver el panel de configuración del activador y, a continuación, haga lo siguiente:

  1. Especifica el tema que debe monitorizar el activador en el campo Tema de Pub/Sub con el siguiente formato: 
    projects/PROJECT_ID/topics/TOPIC_ID

    Para ver todos los temas disponibles en tu Google Cloud proyecto, consulta la columna Nombre del tema en Temas. También puedes seleccionar un tema de otro Google Cloud proyecto.

    Sustituye lo siguiente:
    • PROJECT_ID: el Google Cloud proyecto en el que se crea el tema.
    • TOPIC_ID: el ID de tu tema de Pub/Sub. El tema puede estar en el mismo proyecto Google Cloud que el de tu integración o en otro proyecto Google Cloud .
  2. Selecciona la cuenta de servicio que quieras usar para invocar la integración. También puede elegir una variable de configuración que haya creado en la integración. El valor de la variable de configuración debe ser una dirección de correo de una cuenta de servicio con el siguiente formato: SERVICE_ACCOUNT_NAME@project-id.iam.gserviceaccount.com. Por ejemplo, application-integration-invoke@project123.iam.gserviceaccount.com.

    Para obtener información sobre cómo crear una variable de configuración, consulta Crear una variable. Para obtener información sobre cómo crear una cuenta de servicio, consulta Crear una cuenta de servicio.

    Si elige una variable de configuración, debe conceder los roles necesarios a la cuenta de servicio a la que hace referencia la variable de configuración. Para obtener más información sobre cómo conceder roles, consulta el artículo sobre los roles de gestión de identidades y accesos necesarios.

    Si no hay ninguna cuenta de servicio, crea una haciendo clic en Crear nueva en la lista Cuenta de servicio.

De forma predeterminada, el periodo de vencimiento de las suscripciones es de never expire. Si quieres definir otro valor de vencimiento, ve a la página de suscripciones de Pub/Sub en la consola Google Cloud y edita la suscripción.

Roles de gestión de identidades y accesos necesarios para las cuentas de servicio

Si haces clic en Grant (Conceder) al seleccionar una cuenta de servicio, se asignarán automáticamente los siguientes roles a las distintas cuentas de servicio.

Cuenta de servicio Rol de gestión de identidades y accesos concedido
Cuenta de servicio predeterminada de Application Integration: service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
  • Editor de Pub/Sub (roles/pubsub.editor)
  • Usuario de cuenta de servicio (roles/iam.serviceAccountUser)

Si el proyecto del tema de Pub/Sub es diferente del proyecto de la integración, la cuenta de servicio predeterminada necesita el rol Editor de Pub/Sub en el proyecto del tema. Google Cloud Google CloudGoogle Cloud

Cuenta de servicio que selecciones para este activador Invocador de integración de aplicaciones (roles/integrations.integrationInvoker)

Salida de activador

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

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

Si quieres definir un filtro para la suscripción de Pub/Sub de forma que se procesen eventos específicos en tu integración, sigue estos pasos:

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

    Ir a Suscripciones

  3. Abre la suscripción y copia todos los detalles, incluido el nombre de la suscripción.
  4. Elimina la suscripción actual.
  5. Crea una nueva suscripción con todos los detalles de la suscripción eliminada (incluido el nombre) que has copiado en el paso 3 y añade un filtro a la nueva suscripción.

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

Exclusiones del SLA

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 solo se aplican cuando el activador de Cloud Pub/Sub inicia correctamente la ejecución de una integración de active.

Usar activadores de Pub/Sub con Controles de Servicio de VPC

Cuando configuras un activador de Pub/Sub en Application Integration e intentas publicar la integración, se produce un error al crear la suscripción de Pub/Sub necesaria si la API Pub/Sub está protegida por un perímetro de servicio en Controles de Servicio de VPC.

Los perímetros de servicio aplican límites de seguridad en torno a tus Google Cloud recursos, y estas políticas pueden impedir que Application Integration cree la suscripción de Pub/Sub necesaria durante la publicación de la integración.

Para configurar y publicar correctamente un activador de Pub/Sub en estos casos, sigue estos pasos:

  1. Retira temporalmente la API Pub/Sub del perímetro de servicio:
    1. En la Google Cloud consola, ve a la página Controles de Servicio de VPC.

      Ir a Controles de Servicio de VPC

    2. Selecciona el proyecto Google Cloud que contiene el tema de Pub/Sub que se va a usar en la integración.
    3. (Opcional) Si no se ha configurado ninguna política de acceso para el proyecto seleccionado, aparecerá el mensaje No se han encontrado perímetros de servicio de VPC en el ámbito actual. En ese caso, haz clic en Cambiar al ámbito de la organización para ir al nivel de la organización.
    4. En la página Controles del servicio de VPC, en la tabla, haga clic en el nombre del perímetro de servicio que quiera modificar.
    5. En la página Detalles del perímetro de servicio, haz clic en Editar.
    6. En el panel Servicios restringidos, filtra y selecciona el servicio pubsub.googleapis.com.
    7. Haz clic en Quitar seleccionados.
    8. Haz clic en Guardar. En el cuadro de diálogo de confirmación, haz clic en Confirm (Confirmar) para quitar la API Pub/Sub del perímetro de servicio de Controles de Servicio de VPC.
  2. Añade y configura el activador Pub/Sub en tu integración.
  3. Publica la integración.
  4. Vuelve a añadir la API Pub/Sub al perímetro de servicio:
    1. Ve a la página Controles de Servicio de VPC.

      Ir a Controles de Servicio de VPC

    2. En la página Controles de Servicio de VPC, en la tabla, haga clic en el mismo perímetro de servicio que ha modificado anteriormente.
    3. En la página Detalles del perímetro de servicio, haz clic en Editar.
    4. En el panel Servicios restringidos, haga clic en Añadir servicios.
    5. Filtra y selecciona el servicio pubsub.googleapis.com.
    6. Haz clic en Añadir servicios seleccionados.
    7. Haz clic en Guardar. En el cuadro de diálogo de confirmación, haz clic en Confirmar para volver a añadir la API Pub/Sub a tu perímetro de servicio de Controles de Servicio de VPC.

Precios

Los activadores de Cloud Pub/Sub y Salesforce no requieren que crees un conector. Sin embargo, si usas la tarea Connectors para conectarte a Pub/Sub o Salesforce, se te cobrará por el uso del conector. Para obtener información sobre los precios, consulta la página Precios de Application Integration.

Cuestiones importantes

  • El tamaño máximo de un mensaje de Pub/Sub es de 10 MB. Para conocer todas las limitaciones de Pub/Sub, consulta 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 entender este comportamiento de Pub/Sub, consulta Entrega al menos una vez. Por lo tanto, debes diseñar tu integración para que sea idempotente y no permita que se escriba un mensaje más de una vez en un tema.

    El campo message_id de la cabecera del mensaje identifica de forma única un mensaje de Pub/Sub.

  • Si dejas de publicar una integración, la suscripción de Pub/Sub no se elimina para evitar la pérdida de mensajes. Sin embargo, si elimina la versión publicada o todas las versiones de integración de una integración, también se eliminará la suscripción de Pub/Sub.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

Siguientes pasos