Creare CICD per l'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 dell'API in un argomento Pub/Sub. Questo esempio ha lo scopo di illustrare l'utilizzo delle attività Chiama endpoint REST e Connettori. Puoi archiviare l'integrazione di esempio nei repository GitHub corrispondenti ai diversi ambienti e ai progetti Google Cloud .

Obiettivi

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

  • Crea un'integrazione.
  • Crea variabili di configurazione e utilizzale nell'integrazione.
  • Esegui la promozione dell'integrazione in un altro ambiente.

Costi

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

Le istruzioni in questo tutorial sono progettate per mantenere l'utilizzo delle risorse entro i limiti di Google Cloud Funzionalità cloud gratuite e offerta di prova.

Al termine delle attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la sezione Pulizia.

Prima di iniziare

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Secret Manager API, Connectors API APIs.

    Enable the APIs

  5. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Pub/Sub Publisher (roles/pubsub.publisher) role to the service account.

      To grant the role, find the Select a role list, then select Pub/Sub Publisher (roles/pubsub.publisher).

    6. Click Continue.

    7. Click Done to finish creating the service account.

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Enable the Secret Manager API, Connectors API APIs.

    Enable the APIs

  9. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Pub/Sub Publisher (roles/pubsub.publisher) role to the service account.

      To grant the role, find the Select a role list, then select Pub/Sub Publisher (roles/pubsub.publisher).

    6. Click Continue.

    7. Click Done to finish creating the service account.

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 una sottoscrizione predefinita.

  5. Non selezionare le altre opzioni.

  6. Fai clic su Crea argomento.

Configurare un connettore Pub/Sub

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

    Vai alla pagina Connessioni

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

      Per l'elenco di tutte le regioni supportate, consulta 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 del 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:l'ID progetto Google Cloud in cui risiede l'istanza Pub/Sub.
    6. ID argomento: inserisci il nome dell'argomento Pub/Sub.
    7. Fai clic su Avanti.
  5. Nella sezione Autenticazione, fai clic su AVANTI.
  6. Rivedi: controlla i dettagli di connessione e autenticazione.
  7. Fai clic su Crea.

Creazione di una nuova integrazione

Dopo aver configurato l'integrazione delle applicazioni, puoi creare una nuova integrazione:

  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. Fai clic su Crea integrazione e fornisci i seguenti dettagli nella pagina Crea integrazione:
    1. Nome 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 è stata evasa, consulta Eseguire il provisioning di una nuova regione. Per visualizzare un elenco delle regioni supportate, consulta 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 attivare il controllo per la tua regione, consulta Modificare la regione.
    5. Fai clic su Crea. Viene visualizzata la pagina dell'editor di integrazione in cui puoi aggiungere le attività e gli attivatori per creare l'integrazione.

Creare un flusso di integrazione

Aggiungere un trigger API e un endpoint REST di chiamata

Per aggiungere un trigger API, 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 l'integrazione build-cicd.

    Viene visualizzata l'integrazione nell'editor di integrazione.

  4. Nella barra di navigazione dell'editor di integrazione, fai clic su Trigger > Trigger API per aggiungere l'attivatore.
  5. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività > Chiama endpoint REST per aggiungere l'attività.
  6. Aggiungi una connessione di bordo dall'elemento Trigger API all'elemento Chiama endpoint REST passando il mouse sopra un punto di controllo sull'elemento Trigger API, quindi fai clic e trascina una riga su un punto di controllo nell'elemento dell'attività Chiama endpoint REST.

Creare variabili di configurazione

Per creare variabili di configurazione:
  1. Nella barra di navigazione dell'editor dell'integrazione, fai clic su (Attiva/disattiva riquadro) 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 di configurazione 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 Var. 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

Aggiungere e configurare l'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 dell'attività. Poi:
    1. Espandi la sezione Input dell'attività.
    2. In URL base endpoint, fai clic su Variabile e aggiungi $`CONFIG_url`$.

Aggiungere e configurare un'attività Connettori

  1. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività > Connettori.
  2. Fai clic su Configura connettori.
  3. Nell'elenco Regione, seleziona la regione in cui hai creato il connettore Pub/Sub.
  4. Nel campo Connessione, seleziona il connettore Pub/Sub che hai 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`$.

Aggiungere 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 di bordo dall'elemento Chiama endpoint REST all'elemento Mappatura dati passando il mouse sopra un punto di controllo sull'elemento Chiama endpoint REST, quindi fai clic e trascina una riga in un punto di controllo nell'elemento dell'attività Mappatura dati.
  3. Aggiungi un'altra connessione dall'elemento Mappatura dati all'elemento Connettori passando il mouse sopra un punto di controllo sull'elemento Mappatura dati, quindi fai clic e trascina una riga in un punto di controllo sull'elemento dell'attività Connettori.
  4. Nel riquadro di configurazione dell'attività di mappatura dei dati, fai clic su Apri editor di mappatura dei dati.
  5. Mappa la variabile di output dell'attività di chiamata endpoint REST alla variabile di input dell'attività Connectors.

Pubblicare l'integrazione

Per pubblicare l'integrazione, segui questi passaggi:
  1. Per pubblicare l'integrazione, fai clic su Pubblica nella barra degli strumenti dell'Editor integrazioni.

    Viene visualizzata la finestra di dialogo Pubblica integrazione.

  2. Nella finestra di dialogo Pubblica integrazione, inserisci il valore per le 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 completata la pubblicazione dell'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.

Promuovere l'integrazione tra gli ambienti

Per promuovere l'integrazione tra gli ambienti, puoi utilizzare lo strumento integrationcli, uno strumento open source che ti consente di interagire con le API di integrazione delle applicazioni e le API di connettori di integrazione. Questo strumento ti consente di gestire entità di integrazione come integrazioni, configurazioni di autenticazione e così via. Per informazioni su come generare lo scafo per l'integrazione e applicare le modifiche generate dallo scafo, consulta Introduzione a integrationcli nel blog della community.

Puoi anche promuovere le modifiche tra gli ambienti configurando le pipeline DevOps, ad esempio utilizzando Jenkins, GitLab, Cloud Build e così via. Per ulteriori informazioni, 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 perché al momento non sono scaricabili. Quando pubblichi l'integrazione nel nuovo ambiente, l'Application Integration ti consente di inserire i valori per le variabili di configurazione.

Passaggi successivi