Esecuzione di suite di integrazione continua

Le esecuzioni di integrazione continua (CI) possono essere attivate in diversi modi:

Una volta completati i test di convalida, puoi esaminare i risultati, come descritto nella pagina di documentazione Visualizzazione dei risultati dell'esecuzione di integrazione continua.

Attivazione automatica dalle richieste di pull

Se hai abilitato la suite CI con l'opzione Attiva su richieste di pull da Looker, la CI attiverà automaticamente un'esecuzione di convalida quando uno sviluppatore Looker invia una richiesta di pull al repository LookML. (Facoltativamente, puoi specificare che le esecuzioni CI automatiche devono essere attivate solo dalle richieste di pull a determinati branch del repository.)

Per le esecuzioni di convalida automatica delle richieste di pull, la CI convalida l'ultimo commit della richiesta di pull e restituisce tutti gli errori in quella versione del repository.

Per informazioni sulla visualizzazione dei risultati, consulta la pagina di documentazione Visualizzazione dei risultati dell'esecuzione di integrazione continua.

Attivazione automatica da dbt Cloud

Se hai abilitato la suite CI con l'opzione Attiva su richieste di pull da dbt Cloud, la CI attiverà automaticamente un'esecuzione di convalida al termine del job CI di dbt Cloud specificato.

Un'esecuzione CI attivata da un job CI di dbt Cloud è progettata per verificare se le modifiche dello schema apportate in dbt interromperanno i contenuti LookML. Durante l'esecuzione, Looker esegue le seguenti azioni:

  1. Riceve la notifica da dbt Cloud al termine del job.
  2. Estrae i dettagli dello schema temporaneo creato da dbt Cloud per l'esecuzione specifica.
  3. Esegue l'override dell'attributo utente configurato (ad esempio, l'attributo dello schema per la connessione) con il nome di questo schema temporaneo.
  4. Esegue gli strumenti di convalida CI su questo schema temporaneo.

In questo modo, puoi rilevare le modifiche che causano interruzioni (ad esempio colonne eliminate o tabelle rinominate) prima che le modifiche dbt vengano unite alla produzione. Al termine dell'esecuzione, il valore dell'attributo utente torna al valore standard per gli utenti CI.

Attivazione automatica in base a una pianificazione

Se hai abilitato la suite CI con l'opzione Attiva in base a una pianificazione, la CI attiverà automaticamente un'esecuzione di convalida in base alla pianificazione specificata.

Per le esecuzioni di convalida automatica pianificata, la CI convalida la versione di produzione del repository e restituisce tutti gli errori in quella versione.

Per informazioni sulla visualizzazione dei risultati, consulta la pagina di documentazione Visualizzazione dei risultati dell'esecuzione di integrazione continua.

Attivazione manuale di una nuova esecuzione di una suite CI

Un utente Looker con l'autorizzazione see_ci può attivare manualmente un'esecuzione CI dall'IDE di Looker.

Per attivare manualmente una nuova esecuzione di una suite CI:

  1. Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
  2. Fai clic su Suite per aprire la pagina Suite.
  3. Fai clic sul pulsante Esegui suite per la suite CI che vuoi eseguire (se non hai suite CI per il tuo progetto, puoi crearne una).

  4. Nella finestra di dialogo Attiva manualmente un'esecuzione , utilizza le opzioni Workspace per selezionare il branch che vuoi convalidare (per i dettagli, consulta la sezione Workspace):

    • Per convalidare la versione di produzione del progetto LookML, fai clic su Produzione.
    • Se vuoi convalidare un branch di sviluppo del progetto LookML, fai clic su Modalità di sviluppo. Utilizza il menu a discesa Branch per selezionare il branch di sviluppo da convalidare.

  5. Per attivare l'esecuzione della suite CI, fai clic su Avvia esecuzione.

Il completamento dell'esecuzione della suite CI potrebbe richiedere diversi minuti, a seconda delle dimensioni del progetto, degli strumenti di convalida inclusi nella suite CI e della configurazione della suite CI.

Dopo aver attivato un'esecuzione, l'IDE di Looker visualizzerà la pagina Esecuzione per la suite che hai attivato. Una volta completati i test di convalida, la pagina Esecuzione mostrerà i risultati per ciascuno degli strumenti di convalida. Puoi uscire dalla pagina Esecuzione durante l'esecuzione dei test di convalida e poi tornare alla pagina Esecuzione per visualizzare i risultati.

Per informazioni sulla visualizzazione dei risultati, consulta la pagina di documentazione Visualizzazione dei risultati dell'esecuzione di integrazione continua.

Workspace

Quando attivi manualmente un'esecuzione CI, puoi utilizzare le opzioni Workspace per convalidare la versione di produzione del repository o un branch di sviluppo del repository.

Per l'opzione Produzione, se vuoi identificare il branch o il commit utilizzato per la versione di produzione, puoi consultare il campo Branch di produzione predefinito della sezione Riepilogo Git della pagina Gestione branch di Impostazioni progetto nell'IDE di Looker:

Per l'opzione Modalità di sviluppo, tieni presente quanto segue per la convalida dei branch di sviluppo nel tuo progetto:

  • Per visualizzare i branch nel progetto LookML e identificare il branch di produzione e i branch personali degli sviluppatori, consulta la pagina Gestione branch di Impostazioni progetto del tuo progetto nell'IDE di Looker.
  • Per convalidare un branch di sviluppo, questo deve essere eseguito con push nel repository LookML. Nell'IDE di Looker, lo sviluppatore deve fare clic sul pulsante Esegui commit delle modifiche e push o selezionare l'opzione Commit dal riquadro Azioni Git nell'IDE.

Esecuzione di nuovo manuale di un'esecuzione CI precedente

Per le esecuzioni completate (se l'esecuzione è stata superata, non è riuscita, ha generato errori o è stata annullata), un utente Looker con l'autorizzazione see_ci può attivare manualmente una nuova esecuzione CI dall'IDE di Looker:

  • Se esegui di nuovo un'esecuzione attivata da una richiesta di pull, l'integrazione continua viene eseguita sullo stesso commit dell'esecuzione originale.
  • Se esegui di nuovo un'esecuzione attivata manualmente, l'integrazione continua viene eseguita sullo stato di produzione o sul HEAD del branch al momento della nuova esecuzione, che includerà tutti i commit successivi eseguiti dall'esecuzione CI iniziale.

Inoltre, se hai modificato la suite CI dall'esecuzione iniziale, una nuova esecuzione includerà tutte le modifiche apportate alla suite CI dall'esecuzione iniziale.

Per eseguire di nuovo un'esecuzione CI:

  1. Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
  2. Fai clic su Esecuzioni per aprire la pagina Esecuzioni.
  3. Nella pagina Esecuzioni, fai clic sul pulsante Visualizza esecuzione per l'esecuzione CI che vuoi annullare.
  4. Nella pagina dei risultati dell'esecuzione selezionata, fai clic sul pulsante Esegui di nuovo nella parte superiore della pagina.

Dopo aver fatto clic su Esegui di nuovo, lo strumento di convalida dei contenuti avvierà l'esecuzione e ti riporterà alla pagina Esecuzione per la nuova esecuzione.

Per informazioni sulla visualizzazione dei risultati, consulta la pagina di documentazione Visualizzazione dei risultati dell'esecuzione di integrazione continua.

Annullamento di un'esecuzione CI

Se vuoi annullare un'esecuzione CI in corso, puoi farlo dalla pagina Esecuzione seguendo questi passaggi:

  1. Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
  2. Fai clic su Esecuzioni per aprire la pagina Esecuzioni.
  3. Nella pagina Esecuzioni, fai clic sul pulsante Visualizza esecuzione per l'esecuzione CI che vuoi annullare.
  4. Nella pagina Esecuzione per l'esecuzione selezionata, fai clic sul pulsante Annulla nella parte superiore della pagina.

Dopo aver fatto clic su Annulla, l'integrazione continua annullerà la visualizzazione dell'esecuzione dello stato Annullato nella pagina Esecuzione.