Le esecuzioni di integrazione continua (CI) possono essere attivate in diversi modi:
- In automatico quando uno sviluppatore Looker invia una richiesta di pull al repository del progetto LookML (per informazioni su come configurare questa opzione, consulta la pagina Creazione di una suite di integrazione continua).
- In automatico quando viene inviata una richiesta di pull a un progetto LookML importato (per informazioni su come configurare questa opzione, consulta la pagina Creazione di una suite di integrazione continua).
- In automatico al termine di un job di integrazione continua dbt Cloud (per informazioni sulla configurazione, consulta la pagina Creazione di una suite di integrazione continua).
- In automatico in base a una pianificazione ricorrente (per informazioni su come configurare questa opzione, consulta la pagina Creazione di una suite di integrazione continua).
- Attivando manualmente una nuova esecuzione di una suite di CI dall'IDE di Looker.
- Eseguire manualmente una precedente esecuzione di CI dall'IDE di Looker.
Una volta completati i test di convalida, puoi esaminare i risultati, come descritto nella pagina della documentazione Visualizzazione dei risultati dell'esecuzione dell'integrazione continua.
Attivazione automatica dalle richieste di pull
Se hai attivato la suite CI con 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 tuo repository LookML. (Facoltativamente, puoi specificare che solo le richieste di pull a determinati rami del repository devono attivare esecuzioni CI automatiche.)
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 della documentazione Visualizzazione dei risultati dell'esecuzione dell'integrazione continua.
Attivazione automatica dalle richieste di pull dei progetti importati
Se hai attivato la suite di CI in un progetto downstream (spoke) con Attiva su richieste di pull da progetti importati, la CI attiva automaticamente un'esecuzione di convalida nel progetto spoke quando uno sviluppatore apre o aggiorna una richiesta di pull nel repository di un progetto upstream (hub) sottoscritto.
Durante un'esecuzione di CI attivata da una richiesta di pull di un progetto importato, Looker esegue le seguenti azioni:
- Convalida la versione di produzione del progetto spoke, bloccando temporaneamente il progetto hub importato al commit della richiesta di pull.
- Scrive il risultato dell'esecuzione della CI del progetto spoke nella richiesta di pull nel repository del progetto hub.
Per informazioni sulla visualizzazione dei risultati, consulta la pagina della documentazione Visualizzazione dei risultati dell'esecuzione dell'integrazione continua.
Attivazione automatica da dbt Cloud
Se hai abilitato la suite CI con Attiva le richieste di pull da dbt Cloud, la CI attiverà automaticamente un'esecuzione di convalida al termine del job CI dbt Cloud specificato.
Un'esecuzione CI attivata da un job dbt Cloud CI è progettata per verificare se le modifiche allo schema apportate in dbt interromperanno i contenuti LookML. Durante l'esecuzione, Looker esegue le seguenti azioni:
- Riceve la notifica da dbt Cloud al completamento del job.
- Estrae i dettagli dello schema temporaneo creato da dbt Cloud per l'esecuzione specifica.
- Sostituisce l'attributo utente configurato (ad esempio l'attributo dello schema per la connessione) con il nome di questo schema temporaneo.
- Esegue i validator CI in base a questo schema temporaneo.
In questo modo puoi rilevare modifiche che provocano un errore (come 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 attivato la suite di CI continua con Attiva in base a una pianificazione, l'CI continua attiverà automaticamente un'esecuzione di convalida in base alla pianificazione specificata.
Per le esecuzioni di convalida pianificate automatiche, la CI convalida la versione di produzione del repository e restituisce tutti gli errori presenti in quella versione.
Per informazioni sulla visualizzazione dei risultati, consulta la pagina della documentazione Visualizzazione dei risultati dell'esecuzione dell'integrazione continua.
Attivazione manuale di una nuova esecuzione di una suite di CI
Un utente di Looker con l'autorizzazione see_ci può attivare manualmente un'esecuzione di CI dall'IDE di Looker.
Per attivare manualmente una nuova esecuzione di una suite di CI, segui questi passaggi:
- Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
- Fai clic su Suite per aprire la pagina Suite.
- Fai clic sul pulsante Esegui suite per la suite di CI che vuoi eseguire (se non hai suite di CI per il tuo progetto, puoi crearne una).
Nella finestra di dialogo Attiva un'esecuzione manualmente, 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 tuo progetto LookML, fai clic su Produzione.
- Se vuoi convalidare un branch di sviluppo del tuo progetto LookML, fai clic su Modalità di sviluppo. Utilizza il menu a discesa Branch per selezionare il branch di sviluppo da convalidare.
Per attivare l'esecuzione della suite di CI, fai clic su Avvia esecuzione.
L'esecuzione della suite CI potrebbe richiedere diversi minuti, a seconda delle dimensioni del progetto, dei validator inclusi nella suite CI e della configurazione della suite CI.
Dopo aver attivato un'esecuzione, l'IDE di Looker visualizzerà la pagina Esegui per la suite che hai attivato. Una volta completati i test di convalida, la pagina Esegui mostrerà i risultati per ciascuno dei validator. Puoi uscire dalla pagina Esegui mentre i test di convalida sono in esecuzione e tornare in un secondo momento alla pagina Esegui per visualizzare i risultati.
Per informazioni sulla visualizzazione dei risultati, consulta la pagina della documentazione Visualizzazione dei risultati dell'esecuzione dell'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 quale branch o commit viene utilizzato per la versione di produzione, puoi consultare l'IDE di Looker nel campo Branch di produzione predefinito della sezione Riepilogo Git della pagina Gestione dei branch delle Impostazioni progetto:
- Per i progetti configurati con la modalità di deployment avanzata, la versione di produzione è un commit o un tag selezionato nel gestore dei deployment da uno sviluppatore Looker che dispone dell'autorizzazione
deploy. - Per i progetti senza modalità di deployment avanzata, la versione di produzione è il branch configurato nel campo Nome branch di produzione Git nella pagina Configurazione progetto delle Impostazioni progetto.
Per l'opzione Dev Mode (Modalità di sviluppo), tieni presente quanto segue per la convalida dei rami di sviluppo nel progetto:
- Per visualizzare i branch nel tuo progetto LookML e identificare il branch di produzione e i branch personali dei tuoi sviluppatori, consulta la pagina Gestione dei branch delle Impostazioni progetto del tuo progetto nell'IDE di Looker.
- Per convalidare un branch di sviluppo, devi eseguirne il push nel repository LookML. Nell'IDE di Looker, ciò significa che lo sviluppatore deve fare clic sul pulsante Commit Changes & Push (Esegui il commit delle modifiche ed esegui il push) o selezionare l'opzione Commit (Esegui il commit) dal pannello Git Actions (Azioni Git) nell'IDE.
Esecuzione manuale di un'esecuzione CI precedente
Per le esecuzioni completate (indipendentemente dal fatto che l'esecuzione sia stata superata, non riuscita, con errori o annullata), un utente di Looker con l'autorizzazione see_ci può attivare manualmente una nuova esecuzione dell'esecuzione CI dall'IDE di Looker:
- Se esegui nuovamente un'esecuzione attivata da una richiesta di pull (attivata da una richiesta di pull nel repository del progetto o in un progetto importato), l'integrazione continua viene eseguita sullo stesso commit dell'esecuzione originale.
- Se esegui nuovamente un'esecuzione attivata manualmente, l'integrazione continua viene eseguita in base allo stato di produzione o all'HEAD del branch al momento della nuova esecuzione, che includerà tutti i commit successivi effettuati dall'esecuzione iniziale della CI.
Inoltre, se hai modificato la suite di CI dopo l'esecuzione iniziale, una nuova esecuzione includerà tutte le modifiche apportate alla suite di CI dopo l'esecuzione iniziale.
Per ripetere un'esecuzione di CI, segui questi passaggi:
- Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
- Fai clic su Esecuzioni per aprire la pagina Esecuzioni.
- Nella pagina Esecuzioni, fai clic sul pulsante Visualizza esecuzione per l'esecuzione CI che vuoi annullare.
- 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 reindirizzerà alla pagina Esegui per la nuova esecuzione.
Per informazioni sulla visualizzazione dei risultati, consulta la pagina della documentazione Visualizzazione dei risultati dell'esecuzione dell'integrazione continua.
Annullamento di un'esecuzione CI
Se vuoi annullare un'esecuzione di CI in corso, puoi farlo dalla pagina Esegui seguendo questi passaggi:
- Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
- Fai clic su Esecuzioni per aprire la pagina Esecuzioni.
- Nella pagina Esecuzioni, fai clic sul pulsante Visualizza esecuzione per l'esecuzione CI che vuoi annullare.
- Nella pagina Esecuzione dell'esecuzione selezionata, fai clic sul pulsante Annulla nella parte superiore della pagina.
Una volta fatto clic su Annulla, l'integrazione continua annullerà l'esecuzione e mostrerà lo stato Annullata nella pagina Esecuzione.