Consulta los conectores compatibles para la integración de aplicaciones.

Activador de Cloud Scheduler

El activador de Cloud Scheduler te permite programar las ejecuciones de tus integraciones 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 trabajos cron de nivel empresarial completamente administrado dentro de la integración de aplicaciones. Con este activador, ahora puedes administrar todos los trabajos cron creados en tu integración, tanto desde la IU de Application Integration como desde 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 tus integraciones.

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.

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 integración de aplicaciones asignado. Si no tienes una cuenta de servicio, debes crear una nueva y asignarle el rol Invocador de Application Integration.

    Para obtener información sobre cómo crear y administrar cuentas de servicio, consulta Crea y administra 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, en la que se enumeran 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.
    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 Integration summary de la barra de herramientas de integración.
    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 elegir 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 elegir 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

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

Para evitar errores de duplicación de trabajos, se crea un trabajo de Cloud Scheduler con la siguiente convención de nombres:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
    

EjemploDemoIntegration__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.

Edita un activador de Cloud Scheduler

Application Integration

Para editar el 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 Integraciones.
  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. Haga clic en Editar.
  4. Modifica las opciones de configuración del trabajo de Cloud Scheduler como desees.

Pausa, reanuda y copia un trabajo de Cloud Scheduler

La integración de aplicaciones no admite operaciones de pausa, reanudación ni copia para un trabajo de Cloud Scheduler creado con el activador de Cloud Scheduler.

El activador de Cloud Scheduler muestra un error en el panel de configuración del activador si pausas manualmente la ejecución de un trabajo de Cloud Scheduler desde 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 la integración de aplicaciones 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 Integraciones.
  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.

Prácticas recomendadas

Como práctica recomendada, deja de publicar 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ías encontrar en el activador de Cloud Scheduler y las causas correspondientes de los errores.

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 detiene 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. Consulta los registros de activadores para identificar el problema. Crea una nueva versión de integración para reemplazar tu trabajo de Cloud Scheduler existente.
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 de Cloud Scheduler producto. Como esta dependencia es externa a la integración de aplicaciones, los términos y condiciones del Acuerdo de Nivel de Servicio (ANS) de la integración de aplicaciones solo se aplican cuando la ejecución se programa correctamente para una integración de active.