Consulta i connettori supportati per Application Integration.

Trigger Cloud Scheduler

L'attivatore Cloud Scheduler ti consente di pianificare le esecuzioni dell'integrazione per periodi di tempo definiti o intervalli regolari in più regioni.

Gli attivatori Cloud Scheduler sfruttano i servizi Cloud Scheduler per fornire un programmatore di cron job di livello enterprise completamente gestito all'interno dell'integrazione delle applicazioni. Utilizzando questo attivatore, ora puoi gestire tutti i cron job creati all'interno dell'integrazione, sia dall'interfaccia utente di Integrazione applicazioni sia dalla dashboard di Cloud Scheduler. Inoltre, l'attivatore Cloud Scheduler ti consente di eseguire il deployment di cron job tra regioni per pianificare le esecuzioni dell'integrazione.

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

Importante: per l'utilizzo dei servizi Cloud Scheduler nell'integrazione verranno applicati addebiti separati. Ti verranno addebitati gli importi in base al numero di cron job creati utilizzando l'trigger Cloud Scheduler in Integrazione delle applicazioni. Per ulteriori informazioni sugli addebiti di Cloud Scheduler, consulta Prezzi di Cloud Scheduler.

Prima di iniziare

Prima di configurare l'attivatore Cloud Scheduler, assicurati di eseguire le seguenti attività nel tuo progetto Google Cloud:

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

   Abilita l'API Cloud Scheduler

2. Verifica di disporre di un account di servizio Google con il ruolo Application Integration Invoker assegnato. Se non hai un account di servizio, devi crearne uno nuovo e assegnargli il ruolo Invoker di integrazione dell'applicazione.

   Per informazioni sulla creazione e sulla gestione degli account di servizio, vedi Creare e gestire gli account di servizio.

   Per informazioni sui ruoli di integrazione delle applicazioni predefiniti, consulta Ruoli IAM predefiniti.

Aggiungi l'trigger Cloud Scheduler

Per aggiungere un attivatore Cloud Scheduler all'integrazione, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Elenco integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
   2. Seleziona una regione per l'integrazione.
      Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
      Nota: l'opzione per selezionare un service account viene visualizzata solo se hai attivato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

   Viene visualizzata l'integrazione nell'editor di integrazione.

4. Nella barra di navigazione dell'editor dell'integrazione, fai clic su Attivatori per visualizzare l'elenco degli attivatori disponibili.
5. Fai clic e posiziona l'elemento Trigger Cloud Scheduler nell'editor di integrazione.

Configura l'attivatore Cloud Scheduler

Per configurare un attivatore Cloud Scheduler, segui questi passaggi:

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

   Specifica la pianificazione dell'attivatore Cloud Scheduler utilizzando una delle seguenti opzioni:

   • Di base: utilizza l'interfaccia utente per configurare la pianificazione del cron job.
   • Avanzato: utilizza un'espressione unix-cron per configurare la pianificazione del cron job.
2. (Per l'opzione di base) Seleziona la scheda Base ed esegui i seguenti passaggi nei campi indicati:
   1. Orari:seleziona gli intervalli di tempo in cui deve essere eseguita l'integrazione.
      • Esegui in un momento specifico : seleziona questa opzione per eseguire l'integrazione in un momento specifico.
      • Ripeti ogni ora : seleziona questa opzione per eseguire ripetutamente l'integrazione su base oraria.
      • Ripeti ogni 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 specifico del mese.
   3. Mese: seleziona i mesi in cui deve essere eseguita l'integrazione. Puoi scegliere di eseguire l'integrazione ogni mese o in mesi specifici.
3. (Per l'opzione Avanzata) Seleziona la scheda Avanzate e specifica la pianificazione del job cron utilizzando un'espressione cron.

   L'espressione cron ha 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, uno dei seguenti valori:
      • Un numero compreso tra 1 e 12
      • Un'abbreviazione di tre lettere del mese (ad es. gen, feb, mar)
   5. Giorno della settimana, uno dei seguenti valori:
      • Un numero compreso tra 0 e 6, che inizia con domenica come 0
      • Un'abbreviazione di tre lettere per il giorno (ad es. Lun, Mar, Mer)

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

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

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

Attiva l'output

Per ogni trigger Cloud Scheduler configurato e pubblicato nella versione dell'integrazione, Application 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 degli attivatori

Un attivatore Cloud Scheduler genera log all'inizio e alla fine di ogni esecuzione dell'integrazione. Puoi visualizzare i log dell'attivatore 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, che mostra i log generati dall'attivatore Cloud Scheduler.

Nota: Application Integration non memorizza né raccoglie i log generati dall'attivatore Cloud Scheduler. Questi log vengono archiviati nel tuo progetto Google Cloud e possono essere visualizzati solo dalla pagina Esplora log di Cloud Logging.

Modificare un trigger di Cloud Scheduler

Application Integration

Avviso: la modifica di un attivatore Cloud Scheduler da Integrazione delle applicazioni sovrascriverà il cron job esistente con un nuovo cron job in una nuova versione dell'integrazione.

Per modificare l'attivatore Cloud Scheduler da Integrazione applicazioni:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Integrazioni.
3. Seleziona l'integrazione che vuoi modificare.
4. Nell'editor dell'integrazione, fai clic sul menu a discesa Versione e seleziona la versione dell'integrazione contenente l'trigger Cloud Scheduler che vuoi modificare.
5. Annullamento pubblicazione e attivazione della modifica se la versione dell'integrazione selezionata è pubblicata (in stato attivo).
6. Fai clic sull'elemento Trigger Cloud Scheduler nell'editor di integrazione per aprire il riquadro di configurazione dell'attivatore.
7. Modifica le configurazioni dei job Cloud Scheduler come preferisci.

Cloud Scheduler

Puoi modificare l'attivatore 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 Cloud Scheduler come preferisci.

Nota: la modifica di un job Cloud Scheduler da Cloud Scheduler non cambia lo stato della versione dell'integrazione di destinazione.

Mettere in pausa, riprendere e copiare un job Cloud Scheduler

L'integrazione delle applicazioni non supporta le operazioni di messa in pausa, ripresa e copia per un job Cloud Scheduler creato utilizzando l'trigger Cloud Scheduler.

L'trigger Cloud Scheduler genera un errore nel riquadro di configurazione dell'attivatore se metti in pausa manualmente l'esecuzione di un job Cloud Scheduler da Cloud Scheduler.

Per ulteriori informazioni sui messaggi di errore dell'attivatore Cloud Scheduler, vedi Risolvere i problemi relativi all'attivatore Cloud Scheduler. Per informazioni su come mettere in pausa e riprendere un cron job utilizzando Cloud Scheduler, consulta Mettere in pausa o riprendere un job.

Eliminare un job Cloud Scheduler

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

Application Integration

Per eliminare un job Cloud Scheduler da Integrazione delle applicazioni:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Integrations (Integrazioni).
3. Seleziona l'integrazione che vuoi modificare.
4. Nell'editor dell'integrazione, fai clic sul menu a discesa Versione e seleziona la versione dell'integrazione contenente l'trigger Cloud Scheduler da eliminare.
5. Annullare la pubblicazione della versione dell'integrazione selezionata.

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

Cloud Scheduler

Per eliminare un 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 eliminare.
3. Fai clic su Elimina.

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

Nota:

• L'eliminazione di un job Cloud Scheduler da Cloud Scheduler non comporta l'eliminazione dell'trigger Cloud Scheduler all'interno dell'integrazione in Integrazione delle applicazioni.
• L'attivatore Cloud Scheduler nell'integrazione genera un errore nel riquadro di configurazione dell'attivatore se un job Cloud Scheduler viene eliminato utilizzando Cloud Scheduler. Per ulteriori informazioni sui messaggi di errore dell'attivatore Cloud Scheduler, consulta Risolvere i problemi relativi all'attivatore Cloud Scheduler.

Best practice

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

Risolvere i problemi relativi all'attivatore Cloud Scheduler

La tabella seguente descrive gli errori che potresti riscontrare nell'attivatore Cloud Scheduler e le cause corrispondenti.

Posizione dell'errore	Occorrenza di errore	Messaggio di errore	Possibili cause	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 dell'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 degli attivatori per identificare il problema.	Crea una nuova versione dell'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 recuperare un job da questo stato, riprova l'operazione CloudScheduler.UpdateJob finché non ricevi una risposta di esito positivo.
		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

Esclusioni SLA

L'attivatore Cloud Scheduler dipende dal prodotto Cloud Scheduler. Poiché questa dipendenza è esterna all'integrazione dell'applicazione, i termini e le condizioni del contratto di livello del servizio (SLA) per l'integrazione dell'applicazione sono applicabili solo quando l'esecuzione è pianificata correttamente per un'integrazione active.