Crea CICD per la tua integrazione

Questo tutorial descrive come automatizzare la promozione di un'integrazione tra ambienti diversi in progetti Google Cloud diversi utilizzando le variabili di configurazione (anteprima).

Panoramica

In questo tutorial automatizzerai i deployment di Application Integration utilizzando la variabile di configurazione per un'integrazione di esempio. Questo flusso di integrazione di esempio chiama un'API e pubblica la risposta dall'API in un argomento Pub/Sub. Questo esempio ha lo scopo di illustrare l'utilizzo delle attività Chiamata endpoint REST e Connettori. Puoi archiviare l'integrazione di esempio nei repository GitHub corrispondenti ai diversi ambienti e progetti Google Cloud.

Obiettivi

Questo tutorial ti mostra come completare le attività seguenti nell'integrazione:

  • Crea un'integrazione.
  • Crea variabili di configurazione e utilizzale nella tua integrazione.
  • Promuovi la tua integrazione in un altro ambiente.

Costi

In questo tutorial utilizzerai i seguenti componenti fatturabili di Google Cloud:

Le istruzioni di questo tutorial sono pensate per mantenere l'utilizzo delle risorse entro i limiti previsti dalle funzionalità cloud gratuite e dall'offerta di prova di Google Cloud.

Una volta completate le attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la pagina Pulizia.

Prima di iniziare

  1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Abilita le API Secret Manager API, Connectors API.

    Abilita le API

  5. Crea un account di servizio:

    1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
    2. Seleziona il progetto.

    3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

    4. Fai clic su Crea e continua.

    5. Concedi il ruolo Pub/Sub Publisher (roles/pubsub.publisher) all'account di servizio.

      Per concedere il ruolo, trova l'elenco Seleziona un ruolo e scegli Pub/Sub Publisher (roles/pubsub.publisher).

    6. Fai clic su Continua.

    7. Fai clic su Fine per completare la creazione dell'account di servizio.

  6. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  7. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  8. Abilita le API Secret Manager API, Connectors API.

    Abilita le API

  9. Crea un account di servizio:

    1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
    2. Seleziona il progetto.

    3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

    4. Fai clic su Crea e continua.

    5. Concedi il ruolo Pub/Sub Publisher (roles/pubsub.publisher) all'account di servizio.

      Per concedere il ruolo, trova l'elenco Seleziona un ruolo e scegli Pub/Sub Publisher (roles/pubsub.publisher).

    6. Fai clic su Continua.

    7. Fai clic su Fine per completare la creazione dell'account di servizio.

crea un argomento Pub/Sub

  1. Nella console Google Cloud, vai alla pagina Argomenti di Pub/Sub.

    Vai ad Argomenti

  2. Fai clic su Crea argomento.

  3. Nel campo ID argomento, inserisci un ID per l'argomento. Per ulteriori informazioni sulla denominazione degli argomenti, consulta le Linee guida per assegnare un nome a un argomento, a una sottoscrizione, a uno schema o a uno snapshot.

  4. Mantieni l'opzione Aggiungi un abbonamento predefinito.

  5. Non selezionare le altre opzioni.

  6. Fai clic su Crea argomento.

Configurare un connettore Pub/Sub

  1. Nella console Google Cloud, vai alla pagina Connettori di integrazione > Connessioni, quindi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + Crea nuova per aprire la pagina Crea connessione.
  3. Nella sezione Posizione, scegli la località per la connessione.
    1. Regione: seleziona una località dall'elenco a discesa.

      Per l'elenco di tutte le regioni supportate, vedi Località.

    2. Fai clic su AVANTI.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona Pub/Sub dall'elenco a discesa dei connettori disponibili.
    2. Versione connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
    3. Nel campo Nome connessione, inserisci pub-sub-connector.
    4. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
    5. ID progetto: ID del progetto Google Cloud in cui si trova l'istanza Pub/Sub.
    6. ID argomento: inserisci il nome del tuo argomento Pub/Sub.
    7. Tocca Avanti.
  5. Nella sezione Autenticazione, fai clic su AVANTI.
  6. Verifica: controlla i dettagli di connessione e autenticazione.
  7. Fai clic su Crea.

Creazione di una nuova integrazione

Dopo aver configurato Application Integration, puoi creare una nuova integrazione:

  1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Elenco delle integrazioni.
  3. Fai clic su Crea integrazione e fornisci i seguenti dettagli nella pagina Crea integrazione:
    1. Integration name (Nome dell'integrazione): inserisci un nome per l'integrazione. Ad esempio, build-cicd.
    2. Descrizione:se vuoi, inserisci una descrizione per l'integrazione. Ad esempio, Demo integration created for CICD tutorial.
    3. Regione: seleziona la regione us-central1 dall'elenco delle regioni di cui è stato eseguito il provisioning. Se la regione che vuoi selezionare non esegue il provisioning, vedi Eseguire il provisioning di una nuova regione. Per visualizzare un elenco delle regioni supportate, vedi Località di Application Integration.
    4. Account di servizio: questo campo viene visualizzato se hai attivato la governance per la tua regione. Seleziona l'account di servizio per l'integrazione. Per scoprire come abilitare la governance per la tua regione, consulta Modificare la regione.
    5. Fai clic su Crea. Viene visualizzata la pagina dell'editor delle integrazioni in cui puoi aggiungere le attività e gli attivatori per creare l'integrazione.

Crea un flusso di integrazione

Aggiungi un trigger API e un endpoint REST di chiamata

Per aggiungere un trigger attivatore API, segui questi passaggi:
  1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

    Vai ad Application Integration

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

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

  3. Seleziona l'integrazione build-cicd.

    L'integrazione viene aperta nell'editor di integrazione.

  4. Nella barra di navigazione dell'editor di integrazione, fai clic su Trigger > Trigger API per aggiungere il trigger.
  5. Nella barra di navigazione dell'editor di integrazione, fai clic su Tasks > Chiama endpoint REST per aggiungere l'attività.
  6. Aggiungi una connessione perimetrale dall'elemento attivatore API all'elemento Endpoint REST di chiamata passando il mouse sopra un punto di controllo sull'elemento Trigger API, quindi facendo clic e trascinando una linea in un punto di controllo sull'elemento dell'attività Endpoint REST di chiamata.

Crea variabili di configurazione

Per creare variabili di configurazione:
  1. Nella barra di navigazione dell'editor di integrazione, fai clic su (riquadro di attivazione/disattivazione) per visualizzare il riquadro Variabili.
  2. Fai clic su +Crea.
  3. Nel riquadro Crea variabile:
    1. In Nome, inserisci url.

      Application Integration aggiunge il prefisso `CONFIG_ alle variabili di configurazione. Se vuoi aggiungere la variabile config all'integrazione utilizzando le API, utilizza il seguente formato per le variabili di configurazione: `CONFIG_CONFIG_VARIABLE_NAME`. Per informazioni su come scaricare e caricare le integrazioni, vedi Caricare e scaricare le integrazioni.

    2. In Tipo di variabile, seleziona Variabile di configurazione.
    3. In Tipo di dati, seleziona Stringa.
    4. Fai clic su Crea.

      La variabile di configurazione viene visualizzata nel riquadro Variabili.

  4. Ripeti i passaggi 2 e 3 per aggiungere la seguente variabile di configurazione:
    • Nome: connection_name
    • Tipo di variabile:Config Variable
    • Tipo di dati: String

Aggiungi e configura endpoint REST di chiamata

Per creare una variabile di configurazione:
  1. Nell'editor di integrazione, fai clic sull'attività Chiama endpoint REST per aprire il riquadro di configurazione delle attività. Poi:
    1. Espandi la sezione Input attività.
    2. In URL di base endpoint, fai clic su Variabile e aggiungi $`CONFIG_url`$.

Aggiungi e configura un'attività Connettori

  1. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività > Connettori.
  2. Fai clic su Configura connettori.
  3. Dall'elenco Regione, seleziona quella in cui hai creato il connettore Pub/Sub.
  4. Nel campo Connessione, seleziona il connettore Pub/Sub creato nel passaggio precedente.
  5. Nella sezione Tipo, seleziona Azioni.
  6. Nella sezione Imposta entità/azioni, per Azioni, seleziona publishMessage.
  7. In Valore predefinito, aggiungi il valore predefinito per la variabile di configurazione.
  8. Fai clic su Crea.
  9. Nel riquadro di configurazione dell'attività Connettori, espandi la sezione Dettagli connessione per aggiornare il seguente campo:
    1. Nel campo Nome connessione, fai clic su Variabile e seleziona $`CONFIG_connection_name`$.

Aggiungi un'attività di mappatura dei dati

  1. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività > Mappatura dei dati.
  2. Aggiungi una connessione perimetrale dall'elemento Call REST Endpoint all'elemento Data Mapping passando il mouse sopra un punto di controllo sull'elemento Call REST Endpoint, quindi facendo clic e trascinando una linea in un punto di controllo sull'elemento attività Data Mapping.
  3. Aggiungi un'altra connessione perimetrale dall'elemento Data Mapping all'elemento Connectors passando il mouse sopra un punto di controllo sull'elemento Data Mapping, quindi fai clic e trascina una linea fino a un punto di controllo sull'elemento attività Connectors.
  4. Nel riquadro di configurazione dell'attività di mappatura dei dati, fai clic su Apri editor mappatura dati.
  5. Mappa la variabile di output dell'attività di chiamata endpoint REST alla variabile di input dell'attività Connettori.

Pubblica l'integrazione

Per pubblicare l'integrazione:
  1. Per pubblicare l'integrazione, fai clic su Pubblica nella barra degli strumenti dell'editor delle integrazioni.

    Viene visualizzata la finestra di dialogo Pubblica integrazione.

  2. Nella finestra di dialogo Pubblica integrazione, inserisci il valore delle seguenti variabili di configurazione:
    1. url: inserisci il nome dell'URL dell'endpoint.
    2. connection_name: inserisci il nome del connettore Pub/Sub che hai creato nel passaggio precedente.
  3. Fai clic su Pubblica.
  4. Una volta pubblicata l'integrazione, puoi visualizzare e controllare i log di esecuzione dell'integrazione pubblicata. Per visualizzare i log, fai clic su Log nella barra degli strumenti dell'editor di integrazione.

Promuovi l'integrazione tra più ambienti

Per promuovere la tua integrazione tra più ambienti, puoi usare lo strumento integrationcli, che è uno strumento open source che ti consente di interagire con le API Application Integration e le API Integration Connectors. Questo strumento consente di gestire le entità di integrazione, come le integrazioni, le configurazioni di autenticazione e così via. Per informazioni su come generare lo scaffold per l'integrazione e applicare le modifiche generate dallo scaffold, consulta l'articolo Introduzione a integrationcli nel blog della community.

Puoi anche promuovere i cambiamenti nei vari ambienti configurando le pipeline DevOps, ad esempio utilizzando Jenkins, GitLab, Cloud Build e così via. Per saperne di più, consulta Integrazione con Cloud Build.

Se non vuoi utilizzare integrationcli, puoi scaricare e caricare manualmente l'integrazione in un nuovo progetto. Dovrai creare manualmente i connettori nel nuovo progetto poiché al momento non sono scaricabili. Quando pubblichi l'integrazione nel nuovo ambiente, Application Integration ti consente di inserire i valori per le variabili di configurazione.

Passaggi successivi