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 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 che corrispondono ai diversi ambienti e Google Cloud progetti.

Obiettivi

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

  • Crea un'integrazione.
  • Crea variabili di configurazione e utilizzale nell'integrazione.
  • Promuovi l'integrazione in un altro ambiente.

Costi

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

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

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per ulteriori informazioni, vedi 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 saperne di più sulla denominazione degli argomenti, consulta Linee guida per la denominazione di 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.

Configurare un connettore Pub/Sub

  1. Nella consoleGoogle Cloud , vai alla pagina Integration Connectors > Connessioni e poi 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à per la 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. Service Account: seleziona un account di servizio con i ruoli richiesti.
    5. ID progetto: Google Cloud ID progetto 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. Rivedi: rivedi 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.

    Vai ad Application Integration

  2. Fai clic su Integrazioni nel menu di navigazione a sinistra per aprire 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: (facoltativo) 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 è disponibile, consulta Eseguire il provisioning di una nuova regione. Per visualizzare un elenco delle regioni supportate, consulta Località di Application Integration.
    4. Service account: questo campo viene visualizzato se hai attivato la governance per la tua regione. Seleziona il account di servizio per l'integrazione. Per scoprire come attivare la governance per la tua regione, vedi Modificare la regione.
    5. Fai clic su Crea. Si apre la pagina dell'editor di integrazione, in cui puoi aggiungere le attività e i trigger per creare l'integrazione.

Creare un flusso di integrazione

Aggiungere un trigger API e una chiamata endpoint REST

Per aggiungere un trigger API trigger, 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 Integrazioni.

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

  3. Seleziona l'integrazione build-cicd.

    Si apre l'integrazione nell'editor integrazioni.

  4. Nella barra di navigazione dell'Editor integrazioni, fai clic su Trigger > API trigger per aggiungere il trigger.
  5. Nella barra di navigazione dell'Editor integrazioni, fai clic su Attività > Chiamata endpoint REST per aggiungere l'attività.
  6. Aggiungi una connessione di bordo dall'elemento Trigger API all'elemento Chiamata endpoint REST passando il mouse sopra un punto di controllo sull'elemento Trigger API, quindi facendo clic e trascinando una linea su un punto di controllo nell'elemento attività Chiamata endpoint REST.

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

Aggiungere e configurare Chiamata endpoint REST

Per creare una variabile di configurazione:
  1. Nell'Editor integrazioni, fai clic sull'attività Chiamata endpoint REST per aprire il riquadro di configurazione dell'attività. Poi:
    1. Espandi la sezione Input attività.
    2. In Endpoint base URL (URL di base dell'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, in 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 edge dall'elemento Chiamata endpoint REST all'elemento Mappatura dati passando il mouse sopra un punto di controllo sull'elemento Chiamata endpoint REST, quindi facendo clic e trascinando una linea su un punto di controllo sull'elemento attività Mappatura dati.
  3. Aggiungi un'altra connessione del bordo dall'elemento Mappatura dei dati all'elemento Connettori passando il mouse sopra un punto di controllo sull'elemento Mappatura dei dati, quindi facendo clic e trascinando una linea su un punto di controllo sull'elemento 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à Connettori.

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

Promuovere l'integrazione tra gli ambienti

Per promuovere l'integrazione in tutti gli ambienti, puoi utilizzare lo strumento integrationcli, 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 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 le modifiche tra gli ambienti configurando le pipeline DevOps, ad esempio utilizzando Jenkins, GitLab, Cloud Build e così via. Per maggiori 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, in quanto 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