Trigger di Cloud Scheduler

Il trigger di Cloud Scheduler consente di pianificare le esecuzioni delle integrazioni per periodi di tempo definiti o intervalli regolari su più regioni.

I trigger di Cloud Scheduler sfruttano i servizi Cloud Scheduler per fornire uno scheduler di cron job di livello enterprise completamente gestito all'interno di Apigee Integration. Con questo trigger, ora puoi gestire tutti i cron job creati all'interno della tua integrazione, sia dall'interfaccia utente di Apigee Integration sia dalla dashboard Cloud Scheduler. Inoltre, il trigger di Cloud Scheduler consente di eseguire il deployment di cron job tra regioni per pianificare le esecuzioni delle integrazioni.

Ad esempio, se hai eseguito il provisioning dell'integrazione in us-central1, puoi utilizzare il trigger di Cloud Scheduler per eseguire il deployment di un cron job in asia-east1 (o in una qualsiasi delle regioni di Google Cloud supportate per Cloud Scheduler) per chiamare l'endpoint dell'integrazione all'indirizzo us-central1.

Prima di iniziare

Assicurati di eseguire le attività seguenti nel progetto Google Cloud prima di configurare il trigger di Cloud Scheduler:

  1. Attiva l'API Cloud Scheduler (cloudscheduler.googleapis.com).

    Abilita l'API Cloud Scheduler

  2. Conferma di avere un account di servizio Google a cui è assegnato il ruolo Invoker di integrazione Apigee. Se non hai un account di servizio, devi crearne uno nuovo a cui assegnare il ruolo Invoker di integrazione Apigee.

    Per informazioni sulla creazione e la gestione degli account di servizio, vedi Creazione e gestione degli account di servizio.

    Per informazioni sui ruoli predefiniti di Apigee Integration, consulta Ruoli IAM predefiniti.

Aggiungi il trigger di Cloud Scheduler

Per aggiungere un trigger di Cloud Scheduler all'integrazione, esegui questi passaggi:

  1. Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppa > Integrazioni.
  3. Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
    2. Seleziona una regione per l'integrazione dall'elenco delle regioni supportate.
    3. Fai clic su Crea.

    In questo modo viene aperta l'integrazione nel designer dell'integrazione.

  4. Nella barra di navigazione del designer dell'integrazione, fai clic su + Aggiungi un'attività/un attivatore > Trigger per visualizzare l'elenco dei trigger disponibili.
  5. Fai clic e posiziona l'elemento attivatore di Cloud Scheduler nell'editor di integrazione.

Configura il trigger di Cloud Scheduler

Per configurare un attivatore di Cloud Scheduler, segui questi passaggi:

  1. Fai clic sull'elemento attivatore di Cloud Scheduler nell'editor di integrazione per aprire il riquadro di configurazione dell'attivatore.

    Specifica la pianificazione del trigger di Cloud Scheduler utilizzando una delle seguenti opzioni:

    • Di base: utilizza l'interfaccia utente per configurare la pianificazione del cron job.
    • Avanzata: utilizza un'espressione unix-cron per configurare la pianificazione del cron job.
  2. (Per l'opzione Di base) Seleziona la scheda Di base e nei campi indicati procedi nel seguente modo:
    1. Orari:seleziona gli intervalli di tempo durante i quali deve essere eseguita l'integrazione.
      • Esegui l'integrazione a un'ora specifica: seleziona questa opzione per eseguire l'integrazione a un momento specifico.
      • Ripeti all'ora: seleziona questa opzione per eseguire ripetutamente l'integrazione su base oraria.
      • Ripeti al minuto: seleziona questa opzione per eseguire ripetutamente l'integrazione in base al numero di minuti specificato
    2. Giorni: seleziona i giorni in cui deve essere eseguita l'integrazione. Puoi scegliere di eseguire l'integrazione ogni giorno, in giorni specifici della settimana o in un giorno del mese specifico.
    3. Mesi: seleziona i mesi in cui deve essere eseguita l'integrazione. Puoi scegliere di eseguire l'integrazione ogni mese o durante mesi specifici.
  3. (Per l'opzione avanzata) Seleziona la scheda Avanzate e specifica la pianificazione del cron job utilizzando un'espressione CRON.

    L'espressione CRON contiene cinque valori che devono essere specificati nel seguente ordine:

    1. Minuto (0-59)
    2. Ora (0-23)
    3. Giorno del mese (1-31)
    4. Mese, utilizzando uno dei seguenti valori:
      • Un numero da 1 a 12
      • Un'abbreviazione del mese di tre lettere (ad esempio, Gen, Feb, Mar)
    5. Giorno della settimana, con uno dei seguenti valori:
      • Un numero compreso tra 0 e 6 che inizia con domenica come 0
      • Un'abbreviazione di tre lettere di un giorno (ad esempio, lun, mar, mer)

    Ad esempio, per eseguire l'integrazione il primo giorno di ogni mese, utilizza l'espressione cron * * 1 * *.

    Per ulteriori informazioni, consulta Configurare le pianificazioni dei cron job.

  4. Regione: seleziona la regione in cui verrà eseguito il deployment del job Cloud Scheduler.
  5. Email account per il servizio:inserisci l'indirizzo email dell'account di servizio Google creato.

Output trigger

Per ogni trigger di Cloud Scheduler configurato e pubblicato nella versione dell'integrazione, Apigee Integration crea un nuovo job Cloud Scheduler nel progetto Google Cloud.

Un job Cloud Scheduler viene creato utilizzando la seguente convenzione di denominazione per evitare errori di duplicazione dei job: 

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER

Esempio: DemoIntegration__V1__1

Log trigger

Un trigger di Cloud Scheduler genera i log all'inizio e alla fine di ogni esecuzione di integrazione. Puoi visualizzare i log del trigger di Cloud Scheduler nella pagina Esplora log di Cloud Logging:

  1. Nella console Google Cloud, vai alla pagina Cloud Scheduler.

    Vai a Cloud Scheduler

  2. Individua il job Cloud Scheduler e fai clic su Visualizza nella colonna Log.

    Viene visualizzata la pagina Esplora log di Cloud Logging con i log generati dal trigger di Cloud Scheduler.

Modifica un trigger di Cloud Scheduler

Apigee Integration

Per modificare il trigger di Cloud Scheduler da Apigee Integration, segui questi passaggi:

  1. Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppa > Integrazioni.
  3. Seleziona l'integrazione che vuoi modificare.
  4. Nell'editor di integrazione, fai clic sul menu a discesa Versione e seleziona la versione dell'integrazione contenente il trigger di Cloud Scheduler che vuoi modificare.
  5. Annulla la pubblicazione e attiva la modifica Se la versione dell'integrazione selezionata è stata pubblicata (in stato attivo).
  6. Fai clic sull'elemento attivatore di Cloud Scheduler nell'editor di integrazione per aprire il riquadro di configurazione dell'attivatore.
  7. Modifica le configurazioni dei job di Cloud Scheduler in base alle tue esigenze.

Cloud Scheduler

Puoi modificare il trigger di Cloud Scheduler modificando la configurazione del job Cloud Scheduler da Cloud Scheduler:

  1. Nella console Google Cloud, vai a Cloud Scheduler.

    Vai a Cloud Scheduler

  2. Seleziona il job Cloud Scheduler da modificare.
  3. Fai clic su Modifica.
  4. Modifica le configurazioni dei job di Cloud Scheduler in base alle tue esigenze.

Metti in pausa, riprendi, copia un job Cloud Scheduler

L'Apigee Integration non supporta le operazioni di pausa, ripresa e copia per un job Cloud Scheduler creato utilizzando il trigger di Cloud Scheduler.

Il trigger di Cloud Scheduler genera un errore nel riquadro di configurazione del trigger se sospendi manualmente l'esecuzione di un job di Cloud Scheduler da Cloud Scheduler.

Per ulteriori informazioni sui messaggi di errore del attivatore di Cloud Scheduler, consulta Risoluzione dei problemi relativi al trigger di Cloud Scheduler. Per informazioni su come mettere in pausa e ripristinare un cron job utilizzando Cloud Scheduler, vedi Mettere in pausa o riprendere un job

Elimina un job Cloud Scheduler

Puoi eliminare un job Cloud Scheduler dall'integrazione in Apigee Integration o da Cloud Scheduler.

Apigee Integration

Per eliminare un job Cloud Scheduler da Apigee Integration, segui questi passaggi:

  1. Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppa > Integrazioni.
  3. Seleziona l'integrazione che vuoi modificare.
  4. Nell'editor di integrazione, fai clic sul menu a discesa Versione e seleziona la versione dell'integrazione contenente il trigger di Cloud Scheduler che vuoi eliminare.
  5. Annulla la pubblicazione della versione dell'integrazione selezionata.

    Il job Cloud Scheduler per la versione dell'integrazione corrispondente viene eliminato.

Cloud Scheduler

Per eliminare un job Cloud Scheduler da Cloud Scheduler, segui questi passaggi:

  1. Nella console Google Cloud, vai a Cloud Scheduler.

    Vai a Cloud Scheduler

  2. Seleziona il job Cloud Scheduler da eliminare.
  3. Fai clic su Elimina.

    Il job Cloud Scheduler per la versione dell'integrazione corrispondente viene eliminato.

best practice

Come best practice, annulla la pubblicazione di tutti i trigger di Cloud Scheduler quando non sono più necessari. Se lasci pubblicato un trigger di Cloud Scheduler ridondante, questo continuerà a richiamare automaticamente l'integrazione, il che potrebbe comportare costi di fatturazione aggiuntivi.

Risolvi i problemi del trigger di Cloud Scheduler

La tabella seguente descrive gli errori che potresti riscontrare nel trigger di Cloud Scheduler e le cause corrispondenti.

Posizione errore Occorrenza dell'errore Messaggio di errore Cause possibili Risoluzione
Riquadro di configurazione dell'attivatore > Messaggio di errore Quando il job Cloud Scheduler interrompe l'esecuzione dell'integrazione The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB doesn’t exist. It might be deleted from your Google Cloud project. Il job Cloud Scheduler viene eliminato utilizzando Cloud Scheduler. Crea una nuova versione di integrazione per sovrascrivere il job Cloud Scheduler esistente.
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project. Il job Cloud Scheduler è in pausa utilizzando Cloud Scheduler. Riprendi il job Cloud Scheduler da Cloud Scheduler.
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error. Controlla i log del trigger per identificare il problema. Crea una nuova versione di integrazione per sovrascrivere il job Cloud Scheduler esistente.
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation. L'account di servizio fornito non dispone delle autorizzazioni IAM richieste. Per ripristinare un job da questo stato, riprova a eseguire l'operazione CloudScheduler.UpdateJob fino a quando non viene ricevuta una risposta corretta.
The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more. CLOUD_SCHEDULER_JOB_ISSUE NA