Activador de Cloud Scheduler

Anuncio: Ahora Application Integration está disponible para tu proyecto de Google Cloud. Ahora puedes usar la integración de Apigee y la integración de aplicaciones dentro del mismo proyecto de Google Cloud. Más información

El activador de Cloud Scheduler te permite programar las 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 trabajos cron de nivel empresarial completamente administrado dentro de Apigee Integration. Con este activador, ahora puedes administrar todos tus trabajos cron creados en tu integración, tanto desde la IU de Apigee 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 tus ejecuciones de 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 que se crearon con el activador de Cloud Scheduler en Apigee Integration. Para obtener más información sobre los cargos de Cloud Scheduler, consulta los 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 Invocador de Apigee Integration asignado. Si no tienes una cuenta de servicio, debes crear una nueva y asignarle el rol Invocador de Apigee Integration.

   Para obtener información para crear y administrar cuentas de servicio, consulta Crea y administra cuentas de servicio

   Para obtener información sobre los roles predefinidos de Apigee 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 IU de Apigee, elige 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 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 de la semana específicos 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 esté configurado y publicado en tu versión de integración, Apigee Integration creará un trabajo nuevo de Cloud Scheduler en tu proyecto de Google Cloud.

Los trabajos de Cloud Scheduler se crean 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

Los activadores de Cloud Scheduler generan registros al inicio y al final de cada ejecución de la 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: Apigee Integration no almacena ni recopila ningún registro generado por 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

Apigee Integration

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

Para cambiar el activador de Cloud Scheduler desde Apigee Integration, sigue estos pasos:

1. En la IU de Apigee, elige tu organización de Apigee.
2. Haz clic en Desarrollar > 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.

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

Apigee Integration 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 de forma manual 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 Pausa o reanuda un trabajo.

Borra un trabajo de Cloud Scheduler

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

Apigee Integration

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

1. En la IU de Apigee, elige tu organización de Apigee.
2. Haz clic en Desarrollar > 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.

Nota:

• Borrar un trabajo de Cloud Scheduler de Cloud Scheduler no borra el activador de Cloud Scheduler dentro de tu integración en Apigee Integration.
• El activador de Cloud Scheduler de tu integración muestra 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 cualquier activador de Cloud Scheduler cuando ya no sea necesario. Si dejas publicado un activador de Cloud Scheduler redundante, el activador seguirá invocando la integración de forma automática, lo que podría causar cargos de facturación adicionales.

Soluciona problemas del activador de Cloud Scheduler

En la siguiente tabla, se describen los errores que puedes 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 mediante Cloud Scheduler.	Crea una versión de integración nueva para reemplazar el trabajo de Cloud Scheduler existente.
		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.	Verifica los Registros del activador para identificar el problema.	Crea una versión de integración nueva para reemplazar el 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