Creare CICD per l'integrazione

Questo tutorial descrive come automatizzare la promozione di un'integrazione tra diversi ambienti in diversi progetti Google Cloud 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à Chiama endpoint REST e Connettori. Puoi archiviare l'integrazione di esempio in repository GitHub corrispondenti ai diversi ambienti e progetti Google Cloud.

Obiettivi

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

  • Crea un'integrazione.
  • Crea variabili di configurazione e utilizzale nella tua integrazione.
  • Promuovi l'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 delle funzionalità cloud e dell'offerta di prova gratuite di Google Cloud.

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. Inserisci un ID per l'argomento nel campo ID argomento. Per ulteriori informazioni sull'assegnazione dei nomi agli argomenti, vedi Linee guida per assegnare un nome a un argomento, una sottoscrizione, uno schema o uno snapshot.

  4. Mantieni l'opzione Aggiungi una sottoscrizione predefinita.

  5. Non selezionare le altre opzioni.

  6. Fai clic su Crea argomento.

configura un connettore Pub/Sub

  1. Nella console Google Cloud, vai a Integration Connectors (Connettori di integrazione) > Pagina Connessioni e poi selezionare o creare 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 aree geografiche supportate, consulta la sezione Località.

    2. Fai clic su AVANTI.
  4. Nella sezione Dettagli connessione, completa i seguenti passaggi:
    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 progetto Google Cloud in cui si trova 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. Verifica: controlla i dettagli della connessione e dell'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.

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Integrations (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 opzioni di cui è stato eseguito il provisioning. regioni. Se non viene eseguito il provisioning della regione che vuoi selezionare, 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 regione, consulta Modifica regione.
    5. Fai clic su Crea. Viene visualizzata la pagina dell'editor delle integrazioni in cui puoi aggiungere le tasks e gli attivatori per creare l'integrazione.

Crea 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 Application Integration.

    Vai ad Application Integration

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

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

  3. Seleziona l'integrazione di build-cicd.

    L'integrazione viene aperta nell'editor dell'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 perimetrale dall'elemento trigger API all'elemento Richiama l'endpoint REST passando il mouse sopra un punto di controllo sull'elemento trigger API facendo clic su una linea e trascinandola fino a un punto di controllo sull'elemento dell'attività Chiama endpoint REST.

Crea variabili di configurazione

Per creare variabili di configurazione:
  1. Nella barra di navigazione dell'editor delle integrazioni, 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, consulta Caricare e scaricare le integrazioni.

    2. Per 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 di chiamata REST

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`$.

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 campo seguente:
    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 (Endpoint REST di chiamata) all'elemento L'elemento Mappatura dei dati passa il mouse sopra un punto di controllo sull'elemento Call REST Endpoint, quindi facendo clic su una linea e trascinandola fino a un punto di controllo sull'elemento dell'attività Mappatura dei dati.
  3. Aggiungi un'altra connessione perimetrale dall'elemento Data Mapping alla Elemento Connettori passando il mouse sopra un punto di controllo sull'elemento Mappatura dei dati, quindi facendo clic su una linea e trascinandola fino a un punto di controllo nell'elemento dell'attività Connettori.
  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à Connectors.

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 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. Dopo aver pubblicato correttamente 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 in più 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 scaffold per l'integrazione e applicare le modifiche generate dallo scaffold, consulta Introduzione a integrationcli nel blog della community.

Puoi anche promuovere cambiamenti tra ambienti impostando pipeline DevOps, ad esempio utilizzando Jenkins, GitLab, Cloud Build e così via. Per saperne di più, vedi 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, Application Integration ti consente di inserire i valori per le variabili di configurazione.

Passaggi successivi