Consulta los conectores compatibles para Application Integration.

Activador de Cloud Scheduler

El activador de Cloud Scheduler te permite programar ejecuciones de integración para períodos definidos o intervalos regulares en varias regiones.

Los activadores de Cloud Scheduler aprovechan los servicios de Cloud Scheduler para proporcionar un programador de trabajo cron de nivel empresarial completamente administrado dentro de Application Integration. Con este activador, ahora puedes administrar todos los trabajos cron creados en tu integración, tanto desde la IU de Application Integration como el panel de Cloud Scheduler. Además, el activador de Cloud Scheduler también te permite implementar trabajos cron entre regiones para programar las ejecuciones de tu integración.

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

Importante: Se aplicarán cargos independientes por el uso de los servicios de Cloud Scheduler en tu integración. Se generarán cargos según la cantidad de trabajos cron creados con el activador de Cloud Scheduler en Application Integration. Para obtener más información sobre los cargos de Cloud Scheduler, consulta Precios de Cloud Scheduler.

Antes de comenzar

Asegúrate de hacer las siguientes tareas en tu proyecto de Google Cloud antes de configurar el activador de Cloud Scheduler:

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

   Habilita la API de Cloud Scheduler

2. Confirma que tienes una cuenta de servicio de Google con el rol de invocador de Application Integration asignado. Si no tienes una cuenta de servicio, debes crear una nueva y asignarle la función Invocador de Application Integration.

   Para obtener información sobre cómo crear y administrar cuentas de servicio, consulta Cómo crear y administrar cuentas de servicio.

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

Agrega el activador de Cloud Scheduler

Para agregar un activador de Cloud Scheduler a tu integración, sigue estos pasos:

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 Scheduler en el editor de integración.

Configura el activador de Cloud Scheduler

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

1. Haz clic en el elemento Activador de Cloud Scheduler en el diseñador de integración para abrir el panel de configuración del activador.

   Especifica el programa del activador de Cloud Scheduler con una de las siguientes opciones:

   • Básico: Usa la interfaz de usuario para configurar la programación de trabajos cron.
   • Avanzado: Usa una expresión unix-cron para configurar la programación de trabajos cron.
2. (Para la opción Básico) Elige la pestaña Básico y haz lo siguiente en los campos indicados:
   1. Intervalos de tiempo: elige los intervalos en los que se debe ejecutar la integración.
      • Ejecutar en un momento específico: Elige esta opción para ejecutar la integración en un momento específico.
      • Repetir por hora: Elige esta opción para ejecutar la integración de forma repetida por hora.
      • Repetir por minuto: Elige esta opción para ejecutar la integración de forma repetida según la cantidad de minutos especificada.
   2. Días: elige los días en los que se debe ejecutar la integración. Puedes ejecutar la integración todos los días, en días específicos de la semana o en un día específico del mes.
   3. Meses: elige los meses en los que se debe ejecutar la integración. Puedes ejecutar la integración todos los meses o durante meses específicos.
3. (Para la opción Avanzado) Elige la pestaña Avanzado y especifica la programación del trabajo cron con una expresión cron.

   La expresión de cron tiene cinco valores que se deben especificar en el siguiente orden:

   1. Minuto (de 0 a 59)
   2. Hora (de 0 a 23)
   3. Día del mes (de 1 a 31)
   4. Mes, cualquiera de los siguientes valores:
      • Un número de 1 al 12
      • Una abreviatura del mes con tres letras (por ejemplo, ene, feb, mar)
   5. Día de la semana, cualquiera de los siguientes valores:
      • Un número del 0 al 6 que comience con domingo como 0
      • Una abreviatura del día con tres letras (por ejemplo, lun, mar o mié).

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

   Para obtener más información, consulta Configura programaciones de trabajos cron.

4. Región: Elige la región en la que se implementará tu trabajo de Cloud Scheduler.
5. Correo electrónico de la cuenta de servicio: Escribe la dirección de correo electrónico de la cuenta de servicio de Google creada.

Resultado del activador

Para cada activador de Cloud Scheduler que se configure y publique en tu versión de integración, Application Integration crea un trabajo nuevo de Cloud Scheduler en tu proyecto de Google Cloud.

Un trabajo de Cloud Scheduler se crea con la siguiente convención de nombres para evitar errores de duplicación de trabajos:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
    

Ejemplo: DemoIntegration__V1__1

Activar registros

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

1. En la consola de Google Cloud, 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 que generó el activador de Cloud Scheduler.

Nota: Application Integration no almacena ni recopila registros que genera el activador de Cloud Scheduler. Estos registros se almacenan en tu proyecto de Google Cloud y solo se pueden ver desde la página Explorador de registros de Cloud Logging.

Edita un activador de Cloud Scheduler

Application Integration

Advertencia: Si editas un activador de Cloud Scheduler desde Application Integration, se reemplazará tu trabajo cron existente por uno nuevo en una versión de integración nueva.

Para editar tu activador de Cloud Scheduler desde Application Integration, sigue estos pasos:

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.
3. Elige la integración que deseas cambiar.
4. En el diseñador de integración, haz clic en el menú desplegable Versión y elige la versión de integración que contiene el activador de Cloud Scheduler que deseas borrar.
5. Anula la publicación y habilita la edición si la versión de integración elegida está publicada (en estado activo).
6. Haz clic en el elemento Activador de Cloud Scheduler en el diseñador de integración para abrir el panel de configuración del activador.
7. Cambia las opciones de configuración del trabajo de Cloud Scheduler como desees.

Cloud Scheduler

Puedes cambiar tu activador de Cloud Scheduler si cambias la configuración de tu trabajo de Cloud Scheduler desde Cloud Scheduler:

1. En la consola de Google Cloud ve a Cloud Scheduler.

   Ir a Cloud Scheduler

2. Elige el trabajo de Cloud Scheduler para editarlo.
3. Haz clic en Editar.
4. Modifica las opciones de configuración del trabajo de Cloud Scheduler como desees.

Nota: Editar un trabajo de Cloud Scheduler desde Cloud Scheduler no cambia el estado de la versión de integración de destino.

Pausa, reanuda y copia un trabajo de Cloud Scheduler

Application Integration no admite operaciones de pausa, reanudación ni copia para un trabajo de Cloud Scheduler que se creó con el activador de Cloud Scheduler.

El activador de Cloud Scheduler arroja un error en el panel de configuración del activador si pausas manualmente la ejecución de un trabajo de Cloud Scheduler en Cloud Scheduler.

Para obtener más información sobre los mensajes de error del activador de Cloud Scheduler, consulta Soluciona problemas del activador de Cloud Scheduler. Para obtener información sobre cómo pausar y reanudar un trabajo cron con Cloud Scheduler, consulta Cómo pausar o reanudar un trabajo.

Borra un trabajo de Cloud Scheduler

Puedes borrar un trabajo de Cloud Scheduler desde tu integración en Application Integration o desde Cloud Scheduler.

Application Integration

Para borrar un trabajo de Cloud Scheduler de Application Integration, sigue estos pasos:

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.
3. Elige la integración que deseas cambiar.
4. En el diseñador de integración, haz clic en el menú desplegable Versión y elige la versión de integración que contiene el activador de Cloud Scheduler que deseas borrar.
5. Anula la publicación de la versión de integración elegida

   Se borra el trabajo de Cloud Scheduler para la versión de integración correspondiente.

Cloud Scheduler

Para borrar un trabajo de Cloud Scheduler desde Cloud Scheduler, sigue estos pasos:

1. En la consola de Google Cloud ve a Cloud Scheduler.

   Ir a Cloud Scheduler

2. Elige el trabajo de Cloud Scheduler para borrarlo.
3. Haz clic en Borrar.

   Se borra el trabajo de Cloud Scheduler para la versión de integración correspondiente.

Nota:

• Si borras un trabajo de Cloud Scheduler desde Cloud Scheduler, no se borra el activador de Cloud Scheduler dentro de tu integración en Application Integration.
• El activador de Cloud Scheduler de tu integración arroja un error en el panel de configuración del activador si se borra un trabajo de Cloud Scheduler con Cloud Scheduler. Para obtener más información sobre los mensajes de error del activador de Cloud Scheduler, consulta Soluciona problemas del activador de Cloud Scheduler.

prácticas recomendadas

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

Soluciona problemas del activador de Cloud Scheduler

En la siguiente tabla, se describen los errores que podrían surgir en el activador de Cloud Scheduler y las causas correspondientes.

Ubicación del error	Caso de error	Mensaje de error	Causas posibles	Solución
Panel de configuración del activador > Mensaje de error	Cuando el trabajo de Cloud Scheduler detenga la ejecución de tu integración	The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB doesn’t exist. It might be deleted from your Google Cloud project.	El trabajo de Cloud Scheduler se borra con Cloud Scheduler.	Crea una versión de integración nueva para reemplazar tu trabajo existente de Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project.	El trabajo de Cloud Scheduler se pausa con Cloud Scheduler.	Reanuda el trabajo de Cloud Scheduler desde Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error.	Revisa los Registros del activador para identificar el problema.	Crea una versión de integración nueva para reemplazar tu trabajo existente de Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation.	La cuenta de servicio proporcionada no tiene los permisos de IAM necesarios.	Para recuperar un trabajo de este estado, vuelve a intentar la operación CloudScheduler.UpdateJob hasta que se reciba una respuesta correcta.
		The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more.	CLOUD_SCHEDULER_JOB_ISSUE	N/A

Exclusiones del ANS

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 se aplican solo cuando la ejecución está programada correctamente para una integración con active.