Consulta los conectores compatibles con Application Integration.

Activador de Cloud Scheduler

El activador de Cloud Scheduler te permite programar las ejecuciones de tu integración para periodos de tiempo definidos o intervalos regulares en varias regiones.

Los activadores de Cloud Scheduler aprovechan los servicios de Cloud Scheduler para proporcionar un programador de tareas cron de nivel empresarial totalmente gestionado en Application Integration. Con este activador, ahora puedes gestionar todas las tareas cron creadas en tu integración, tanto desde la interfaz de usuario de Application Integration como desde el panel de control de Cloud Scheduler. Además, el activador de Cloud Scheduler también te permite desplegar tareas cron entre regiones para programar las ejecuciones de tu integración.

Por ejemplo, si has aprovisionado tu integración en us-central1, puedes usar el activador de Cloud Scheduler para implementar un trabajo cron en asia-east1 (o en cualquiera de las regiones admitidas de Google Cloud para Cloud Scheduler) para llamar al endpoint de tu integración en us-central1.

Antes de empezar

Antes de configurar el activador de Cloud Scheduler, asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud:

1. Habilita la API Cloud Scheduler (cloudscheduler.googleapis.com).

   Habilitar la API Cloud Scheduler

2. Confirma que tienes una cuenta de servicio de Google con el rol Invocador de integración de aplicaciones asignado. Si no tienes una cuenta de servicio, debes crear una y asignarle el rol Invocador de integración de aplicaciones.

   Para obtener información sobre cómo crear y gestionar cuentas de servicio, consulta el artículo Crear y gestionar cuentas de servicio.

   Para obtener información sobre los roles predefinidos de Application Integration, consulta Roles de IAM predefinidos.

Añadir el activador de Cloud Scheduler

Para añadir un activador de Cloud Scheduler a tu integración, 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 info 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 Scheduler y colócalo en el editor de integraciones.

Configurar el activador de Cloud Scheduler

Para configurar un activador de Cloud Scheduler, sigue estos pasos:

1. En el editor de integraciones, haz clic en el elemento Activador de Cloud Scheduler para abrir el panel de configuración del activador.

   Especifica la programación del activador de Cloud Scheduler con una de las siguientes opciones:

   • Básico: usa la interfaz de usuario para configurar la programación de la tarea cron.
   • Avanzado: usa una expresión cron para UNIX para configurar la programación de la tarea cron.
2. (Opción básica) Selecciona la pestaña Básico y haz lo siguiente en los campos indicados:
   1. Horas: selecciona los intervalos de tiempo en los que se debe ejecutar la integración.
      • Ejecutar a una hora específica: selecciona esta opción para ejecutar la integración a una hora específica.
      • Repetir cada hora: selecciona esta opción para ejecutar la integración repetidamente cada hora.
      • Repetir por minuto: selecciona esta opción para ejecutar la integración repetidamente según el número de minutos especificado.
   2. Días: selecciona los días en los que se debe ejecutar la integración. Puede elegir si quiere ejecutar la integración todos los días, en días concretos de la semana o en un día concreto del mes.
   3. Meses: selecciona los meses en los que debe ejecutarse la integración. Puedes ejecutar la integración todos los meses o solo en meses concretos.
3. (Opción avanzada) Selecciona la pestaña Avanzado y especifica la programación de la tarea cron con una expresión cron.

   La expresión cron tiene cinco valores que deben especificarse en el siguiente orden:

   1. Minuto (0-59)
   2. Hora (0-23)
   3. Día del mes (1-31)
   4. Mes, uno de los siguientes valores:
      • Un número del 1 al 12
      • Abreviatura de tres letras del mes (por ejemplo, ene, feb, mar)
   5. Día de la semana, con uno de los siguientes valores:
      • Un número del 0 al 6, donde el domingo es el 0.
      • Abreviatura de tres letras del día (por ejemplo, lun., mar., mié.)

   Por ejemplo, para ejecutar la integración el primer día de cada mes, usa la expresión cron * * 1 * *.

   Para obtener más información, consulta Configurar programaciones de tareas cron.

4. Región: selecciona la región en la que se desplegará tu tarea de Cloud Scheduler.
5. Correo de la cuenta de servicio: introduce la dirección de correo de la cuenta de servicio de Google que has creado.

Salida del activador

Por cada activador de Cloud Scheduler que se configure y publique en tu versión de integración, Application Integration crea una tarea de Cloud Scheduler en tu proyecto de Google Cloud.

Se crea una tarea de Cloud Scheduler con la siguiente convención de nomenclatura para evitar errores de duplicación de tareas:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
    

Ejemplo: DemoIntegration__V1__1

Registros de activadores

Un activador de Cloud Scheduler genera registros al principio y al final de cada ejecución de la integración. Puedes ver los registros de activadores de Cloud Scheduler en la página Explorador de registros de Cloud Logging:

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

   Ir a Cloud Scheduler

2. Busca tu trabajo de Cloud Scheduler y haz clic en Ver en la columna Registros.

   Aparecerá la página Explorador de registros de Cloud Logging, que muestra los registros generados por el activador de Cloud Scheduler.

Editar un activador de Cloud Scheduler

Pausar, reanudar o copiar una tarea de Cloud Scheduler

Application Integration no admite las operaciones de pausa, reanudación y copia de una tarea de Cloud Scheduler creada con el activador de Cloud Scheduler.

El activador de Cloud Scheduler genera un error en el panel de configuración del activador si pausas manualmente la ejecución de una tarea de Cloud Scheduler desde Cloud Scheduler.

Para obtener más información sobre los mensajes de error del activador de Cloud Scheduler, consulta Solucionar problemas con el activador de Cloud Scheduler. Para obtener información sobre cómo pausar y reanudar una tarea cron con Cloud Scheduler, consulta el artículo Pausar o reanudar una tarea.

Eliminar una tarea de Cloud Scheduler

Puedes eliminar una tarea de Cloud Scheduler desde tu integración en Application Integration o desde Cloud Scheduler.

Prácticas recomendadas

Como práctica recomendada, anula la publicación de los activadores de Cloud Scheduler cuando ya no los necesites. Si dejas publicado un activador de Cloud Scheduler redundante, el activador seguirá invocando la integración automáticamente, lo que podría generar cargos adicionales.

Solucionar problemas de un activador de Cloud Scheduler

En la siguiente tabla se describen los errores que pueden producirse en el activador de Cloud Scheduler y las causas correspondientes.

Exclusiones del SLA

El activador de Cloud Scheduler depende del producto Cloud Scheduler. 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 la ejecución se programa correctamente para una integración de active.