Inizia a utilizzare Apigee Integration e la connessione Pub/Sub

Annuncio: Application Integration è ora disponibile per il tuo progetto Google Cloud. Ora puoi utilizzare sia Apigee Integration che Application Integration all'interno dello stesso progetto Google Cloud. Scopri di più

Questo tutorial mostra come utilizzare le integrazioni e i connettori per creare un'integrazione di esempio che attiva la pubblicazione di un messaggio Cloud Pub/Sub. Il tutorial presuppone che tu abbia un software conoscenza dell'integrazione Apigee.

In questo esempio, la chiamata a un endpoint API attiva la pubblicazione di un messaggio in un argomento Cloud Pub/Sub. I passaggi riportati di seguito descrivono come configurare il trigger API e la connessione Pub/Sub necessarie per eseguire un'integrazione corretta.

Prima di iniziare

Prima di iniziare questo tutorial, conferma le credenziali di accesso a Google Cloud e i dettagli dell'organizzazione. Questo necessarie per accedere all'interfaccia utente dei connettori. Per accedere all'attività dei connettori sono necessarie le tue credenziali Apigee all'interno del progettista di integrazione Apigee. Di seguito sono descritti ulteriori passaggi preliminari:

• Prima di creare una connessione per la prima volta, completa i seguenti passaggi:

  Nota: questi passaggi sono necessari solo se stai abilitando Apigee Integration e Connectors per la prima volta.
  1. Creare una nuova istanza Apigee. Le nuove istanze Apigee possono eseguire il provisioning con la UI di provisioning.

     Per l'elenco delle regioni che supportano i connettori, consulta Regioni dei connettori supportate.

  2. Conferma che le funzionalità di integrazione e connettori Apigee abbiano il diritto di il tuo abbonamento ad Apigee.
  3. Abilita le funzionalità di integrazione e connettori Apigee utilizzando il seguente comando:

     curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H \
     "content-type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/PROJECT_ID:setAddons" -XPOST \
     -d '{"addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig": {"enabled": true}}}'

     Avviso: quando esegui un comando del componente aggiuntivo, quest'ultimo sovrascrive eventuali componenti aggiuntivi. Pertanto, se disponi di componenti aggiuntivi esistenti, includili nel relativo comando. In caso contrario, il comando per abilitare Apigee Integration disabiliterà tutti gli altri componenti aggiuntivi nell'organizzazione esistente. e Se un componente aggiuntivo viene disabilitato, Apigee elimina tutte le configurazioni del componente aggiuntivo (funzionalità). Ad esempio, se disattiverai il componente aggiuntivo Integrazioni, verranno eliminate tutte le integrazioni.
  4. Se non hai un account di servizio, creane uno.

     Un account di servizio è un tipo speciale di Account Google destinato a rappresentare una persona non umana utente che deve autenticarsi e avere l'autorizzazione ad accedere ai dati nelle API di Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni le informazioni, vedi Creazione di un account di servizio.

• Prima di creare una connessione Pub/Sub da utilizzare nell'integrazione, segui questi passaggi:
  • Creare un argomento Pub/Sub e aggiungi un abbonamento, come descritto nella Guida rapida di Cloud Pub/Sub: Utilizzo della console.
  • Concedi l'autorizzazione per pubblicare nel tuo argomento Pub/Sub. Ad esempio, puoi utilizzare il ruolo roles/pubsub.publisher per pubblicare in argomenti. Per saperne di più sui ruoli Pub/Sub, consulta Controllo dell'accesso.
  • Genera una chiave per l'account di servizio. Il file della chiave JSON viene utilizzato in un passaggio successivo per configurare la connessione Pub/Sub.

Abilita i servizi richiesti

Connectors richiede l'abilitazione dei seguenti servizi Google:

Nome	Titolo
apigee.googleapis.com	API Apigee
secretmanager.googleapis.com	API Secret Manager
connectors.googleapis.com	API Connectors

Se questi servizi non sono stati abilitati per il tuo progetto in precedenza, ti verrà chiesto di abilitarli quando crei la connessione nella pagina Crea connessione.

Crea una connessione Pub/Sub

Per configurare una connessione:

1. Nella console Cloud, vai a Connettori di integrazione > Pagina Connessioni e poi selezionare o creare un progetto Google Cloud.

   Vai alla pagina Connessioni .

2. Fai clic su + CREA NUOVO per aprire la pagina Crea connessione.
3. Configura la connessione:
   1. Nella sezione Crea connessione, completa i seguenti passaggi:
      • Connettore: seleziona Cloud Pub/Sub dall'elenco a discesa dei connettori disponibili.
      • Versione connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
      • Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.

        I nomi delle connessioni devono soddisfare i seguenti criteri:

        • I nomi delle connessioni possono contenere lettere, numeri o trattini.
        • Le lettere devono essere minuscole.
        • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
        • I nomi delle connessioni non possono contenere più di 63 caratteri.
      • Facoltativamente, inserisci una descrizione per l'istanza di connessione.
      • Account di servizio: seleziona un account di servizio con i ruoli richiesti.
      • ID progetto: l'ID del progetto Google Cloud in cui si trova l'istanza Pub/Sub.
      • ID argomento: il nome dell'argomento in cui deve essere pubblicato il messaggio.
      • Facoltativamente, fai clic su + AGGIUNGI ETICHETTA per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
      • Fai clic su AVANTI.
   2. Posizione: scegli la posizione per la connessione.
      • Seleziona una località in cui Apigee è disponibile dall'elenco a discesa Regione.

        Le regioni supportate per i connettori includono:

        Per l'elenco di tutte le aree geografiche supportate, consulta la sezione Località.

      • Fai clic su AVANTI.
   3. Autenticazione: tipi di autenticazione supportati dalla connessione Cloud Pub/Sub.
      • AUTH_TYPE_UNSPECIFIED

      Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

      • AUTH_TYPE_UNSPECIFIED .
   4. Fai clic su AVANTI.
   5. Verifica: controlla i dettagli della connessione e dell'autenticazione.
4. Fai clic su Crea.
Nota: il completamento della creazione della connessione potrebbe richiedere diversi minuti. In data Se la connessione viene riuscita, lo stato della connessione sarà Attivo nella visualizzazione elenco Connettori.

Creazione di una nuova integrazione

Per creare una nuova integrazione:

1. Vai all'UI di Apigee e accedi allo stesso progetto in cui è stata creata la connessione.
2. Fai clic su Sviluppo > Integrazioni.
3. Fai clic su CREA NUOVO.
4. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
   Nota: i nomi delle integrazioni devono soddisfare i seguenti requisiti:

   • I nomi devono iniziare e terminare con lettere o numeri.
   • I nomi non possono contenere spazi o più di un trattino o un trattino basso in una riga.
5. Fai clic su Crea per aprire il designer dell'integrazione.

Aggiungi un trigger API

Gli attivatori sono necessari per avviare la sequenza di attività che compongono un'integrazione. Qualsiasi disponibile un trigger per avviare un'integrazione. Questo tutorial utilizza il trigger API per richiamare direttamente nell'esecuzione dell'integrazione.

Per aggiungere un trigger API a un'integrazione nuova o esistente:

1. Nel progettista dell'integrazione, fai clic su + Aggiungi un'attività/un attivatore per visualizzare l'attività. finestra di dialogo di selezione dell'attivatore.
2. Fai clic su Attivatori per visualizzare gli attivatori disponibili.
3. Trascina l'elemento trigger API nel designer.

Non sono necessarie ulteriori configurazioni per questo trigger. Per visualizzare l'ID trigger API, Fai clic sull'elemento trigger API nel progettista dell'integrazione. Nel riquadro di configurazione viene visualizzato l'ID trigger, ovvero un generato automaticamente nel formato api_trigger/TRIGGER_NAME.

Aggiungi e configura attività

Un'attività è un insieme eseguibile di passaggi che possono prendere le variabili come input e generare variabili come output. Come per i trigger, qualsiasi attività disponibile può essere utilizzata in un'integrazione.

Questo tutorial utilizza l'attività Connettori. Configurazione i dettagli dell'attività sono descritti nei passaggi riportati di seguito.

configura l'attività Crea un connettore con una connessione Pub/Sub

Per configurare l'attività Connettori in Apigee Integration in modo da utilizzare la connessione Pub/Sub:

1. Vai all'UI di Apigee ed esegui l'accesso.
2. Seleziona la tua organizzazione utilizzando il menu a discesa nell'angolo in alto a sinistra dell'interfaccia utente.
3. Fai clic su Sviluppo > Integrazioni.
4. Cerca o seleziona l'integrazione da modificare dall'elenco Integrazioni e fai clic per aprire la progettista dell'integrazione.
5. Fai clic su + Aggiungi un'attività/un attivatore > Tasks per visualizzare l'elenco delle attività disponibili.
6. Trascina l'elemento dell'attività Connettori nel progettista dell'integrazione.
7. Fai clic sull'elemento attività Connettori nel designer per visualizzare l'attività Connettori di configurazione del deployment.
8. Se vuoi, fai clic sulla per modificare il nome dell'attività. In questo modo puoi modificare il nome dell'attività dal generico Connettori a un nome significativo per l'integrazione.
9. Nella scheda Configurazione della sezione Configurazione, fai clic sul pulsante Configura attività per aprire il riquadro Configura attività connettore.
1. Nella colonna Connessione, scegli la connessione Pub/Sub creata in un passaggio precedente dall'elenco delle connessioni disponibili.
2. Una volta scelta una connessione, viene visualizzata la colonna Tipo. Per questo esempio, seleziona Azioni e poi publishMessage dalla delle azioni disponibili.
   • Un'entità può essere considerata come un oggetto o un insieme di proprietà nell'applicazione connessa o servizio, che possono essere esposti a un'integrazione tramite l'interfaccia del connettore. La connessione Pub/Sub non esporre eventuali entità.
   • Una Azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia di Connector. Le funzioni sono definite nell'applicazione o nel servizio connesso e definiscono una modifica o una serie di modifiche che è possibile apportare una o più entità. La connessione Pub/Sub ha una azione disponibile
3. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.
10. Il riquadro di configurazione dell'attività Connettori per una connessione Pub/Sub mostra anche le variabili Task Input e la variabile Task Output, generata automaticamente da Entità e operazione o Azione. selezionato nel passaggio precedente per l'utilizzo nella connessione. Queste variabili sono accessibili come input per le attività successive o condizionali configurati nell'integrazione attuale. Per configurare l'input dell'attività:
    1. Fai clic sul testo della variabile Payor input del connettore per aprire il riquadro Configura variabile.
    2. Nel campo Valore predefinito, inserisci il seguente testo: {"message": "test message from integration platform"}.
    3. Seleziona la casella di controllo Utilizza come input per l'integrazione.
    4. Fai clic su Salva.

11. Puoi configurare varie strategie di ripetizione per gestire gli errori in un'attività. Strategie per i nuovi tentativi ti consentono di specificare come eseguire nuovamente l'attività in caso di errore. Per ulteriori informazioni, consulta le Strategie di gestione degli errori.

12. Aggiungi una connessione perimetrale dall'elemento trigger API all'elemento Elemento Connectors passando il mouse sopra un punto di controllo sull'elemento trigger API, quindi facendo clic su una linea e trascinandola fino a un punto di controllo nell'elemento dell'attività Connettori. I punti di controllo e la linea sul bordo diventerà gialla. Il perimetro indica il flusso di controllo dal trigger API all'attività Connettori.

Testare l'integrazione

Per testare la nuova integrazione:

1. Fai clic sul pulsante Pubblica nella barra degli strumenti del Designer di integrazione.
2. Fai clic su Test per attivare ed eseguire l'integrazione. Si aprirà la finestra Test Integration (Test integrazione), che mostra la variabile di input (messaggio) che hai impostato in un passaggio precedente. Se vuoi, la variabile di input può essere modificata qui.
3. Fai clic su Verifica integrazione.
4. Se l'operazione riesce, la finestra Testa integrazione visualizza un messaggio di operazione riuscita, insieme al valore del parametro di input e output variabili.
5. Fai clic su Close (Chiudi) per uscire dalla finestra Test Integration (Test integrazione).

Per verificare il successo dell'integrazione:

• Vai alla pagina Pub/Sub.

  Vai a Pub/Sub.

  Seleziona l'argomento Pub/Sub e fai clic su Visualizza i messaggi per confermare la ricezione del messaggio inviato e integrazione.
  Nota: la visualizzazione del messaggio potrebbe richiedere diversi minuti.
• Controlla i log di Apigee Integration per visualizzare lo stato di una determinata integrazione. Per visualizzare i log:
  1. Fai clic su Log nella barra degli strumenti del designer dell'integrazione.
  2. Nella pagina Log di esecuzione puoi visualizzare i dettagli di ogni tentativo di eseguire un'integrazione. Ogni voce include i dettagli del tentativo di esecuzione, tra cui:
     • Nome integrazione
     • ID esecuzione
     • Stato
     • Data/Ora di inizio
     • Durata
     • ID integrazione
     • ID attivatore
  3. Fai clic sulla freccia di espansione (>) accanto all'integrazione eseguita per visualizzare un elenco espanso di attività e variabili nell'integrazione, oltre allo stato delle attività e ai payload variabili.

Complimenti! Hai appena creato e testato una connessione Pub/Sub in Apigee Integration.

Passaggi successivi

• Consulta l'elenco dei connettori supportati in Apigee.
• Scopri come creare e gestire le connessioni.