Una suite di integrazione continua (CI) è un insieme di istruzioni di convalida associate al tuo progetto LookML. Un utente Looker con l'autorizzazione manage_ci può configurare quanto segue in una suite CI:
- Come viene attivata un'esecuzione di convalida CI (manualmente dall'IDE di Looker o automaticamente quando viene inviata una richiesta di pull al repository).
- Quali strumenti di convalida CI eseguire.
- Opzioni aggiuntive per ogni test di convalida. Per i dettagli, consulta le pagine della documentazione di ciascuno degli strumenti di convalida:
Prima di iniziare
Prima di poter creare una suite CI, devi disporre di:
- Un'istanza di Looker che soddisfi i requisiti per la CI e che sia abilitata per la CI.
- Un account utente Looker con l'autorizzazione
manage_ci(questa autorizzazione è inclusa nel set di autorizzazioni Amministratore ).
Creazione di una suite CI
Puoi configurare ed eseguire gli strumenti di convalida nella pagina Suite dell'IDE di Looker:
Per creare una suite CI:
- Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
- Fai clic sulla scheda Suite per aprire la pagina Suite.
- Nella pagina Suite, puoi creare una nuova suite o modificarne una esistente:
- Per creare una nuova suite, fai clic sul pulsante Crea suite.
- Per modificare una suite esistente, fai clic sul pulsante Modifica suite della suite.
- Inserisci un nome per il Nome della suite. Se stai modificando una suite esistente, puoi fare clic sull'icona a forma di matita per modificare il nome della suite.
- (Facoltativo) Attiva l'opzione Attiva in base a una pianificazione se vuoi configurare test di convalida automatici in base a una pianificazione ricorrente. Per saperne di più, consulta la sezione Attiva in base a una pianificazione in questa pagina.
(Facoltativo) Attiva l'opzione Attiva su richieste di pull da Looker se vuoi configurare test di convalida automatici ogni volta che uno sviluppatore Looker invia una richiesta di pull al repository. Per saperne di più, consulta la sezione Attiva su richieste di pull da Looker in questa pagina.
Se attivi l'attivazione delle richieste di pull per una suite CI, puoi anche utilizzare il campo Solo per il branch di destinazione per specificare che le richieste di pull solo a branch specifici nel repository devono attivare un'esecuzione della suite CI. Per saperne di più, consulta la sezione Attiva su richieste di pull da Looker in questa pagina.
(Facoltativo) Attiva l'opzione Attiva su richieste di pull da dbt Cloud se vuoi configurare test di convalida automatici ogni volta che viene eseguito un job CI di dbt Cloud. Per saperne di più, consulta la sezione Attiva su richieste di pull da dbt Cloud in questa pagina.
(Facoltativo) Attiva l'opzione Abilita avvisi email se vuoi ricevere avvisi email in base allo stato di un'esecuzione CI. Per saperne di più, consulta la sezione Configura avvisi in questa pagina.
(Facoltativo) Attiva le opzioni degli strumenti di convalida per attivare uno strumento di convalida e configurarne le opzioni. Per i dettagli, consulta le pagine della documentazione di ciascuno degli strumenti di convalida:
Salva le modifiche:
- Se stai creando una nuova suite, fai clic sul pulsante Crea suite.
- Se stai modificando una suite esistente, fai clic sul pulsante Aggiorna suite.
Trigger
Le esecuzioni CI possono essere attivate in diversi modi:
- Automaticamente, in base a una pianificazione ricorrente.
- Automaticamente, quando viene inviata una richiesta di pull al repository del progetto LookML da uno sviluppatore Looker.
- Automaticamente, quando un job CI di dbt Cloud crea una richiesta di pull.
- Manualmente, utilizzando il pulsante Esegui suite nella pagina Suite dell'IDE di Looker.
- Manualmente, eseguendo di nuovo un'esecuzione CI precedente dalla pagina Esecuzioni dell'IDE di Looker.
Attiva in base a una pianificazione
Puoi configurare una suite CI in modo che venga attivata automaticamente in base a una pianificazione attivando l'opzione Attiva in base a una pianificazione.
Quando questa opzione è attiva, puoi selezionare la frequenza e le specifiche per l'esecuzione automatica della suite CI:
- Mensile, in un giorno e un'ora specifici
- Settimanale, in un giorno e un'ora specifici
- Giornaliera, a un'ora specifica
- Ogni ora o ogni 2, 3, 4, 6, 8 o 12 ore, a partire e terminando in orari specifici della giornata
- Minuti ogni 5, 10, 15, 20 o 30 minuti, a partire e terminando in orari specifici della giornata
- Mesi specifici dell'anno, in un giorno e un'ora specifici
- Giorni specifici della settimana a un'ora specifica
Attiva su richieste di pull da Looker
Per configurare una suite CI per l'attivazione automatica su richiesta di pull, attiva l'opzione Attiva su richieste di pull da Looker. Per utilizzare l'attivazione delle richieste di pull, l'amministratore di Looker deve configurare il repository Git nella pagina di amministrazione Integrazione continua di Looker.
Se attivi i trigger per richieste di pull per una suite CI, puoi anche specificare che le richieste di pull solo a branch specifici nel repository devono attivare un'esecuzione della suite CI. Per limitare i trigger automatici delle richieste di pull delle esecuzioni CI a branch specifici nel repository, inserisci un elenco separato da virgole dei branch nel campo Solo per il branch di destinazione.
Ad esempio, se un repository ha tre branch denominati main, release_1, e dev, puoi inserire main, release_1 nel campo Solo per il branch di destinazione. Ciò significa che le esecuzioni CI verranno attivate quando uno sviluppatore Looker invia una richiesta di pull al branch main o release_1. Se uno sviluppatore Looker invia una richiesta di pull al branch dev, non verrà attivata un'esecuzione automatica della suite CI.
Attiva su richieste di pull da dbt Cloud
Se hai configurato l'integrazione di dbt Cloud nella tua istanza, puoi configurare una suite CI in modo che venga attivata automaticamente al termine di un job CI di dbt Cloud. La suite CI verifica se le modifiche ai modelli dbt causano errori SQL nelle esplorazioni di Looker prima del deployment delle modifiche dbt.
Per configurare questo trigger, attiva l'opzione Attiva su richieste di pull da dbt Cloud quando crei o modifichi una suite CI.
Dopo aver attivato questo trigger, configura le seguenti opzioni:
Job dbt Cloud: seleziona il job CI di dbt Cloud dal campo a discesa che deve attivare questa suite.
Attributo utente dello schema: seleziona l'attributo utente di Looker che contiene il nome dello schema per la connessione al database. In questo elenco verranno visualizzati solo gli attributi utente che sono stati abilitati per la CI nel riquadro Amministrazione.
Quando salvi la suite con questo trigger attivato, Looker registra automaticamente un webhook nel tuo account dbt Cloud per ascoltare i completamenti dei job.
Per le esecuzioni attivate da dbt Cloud, Looker identifica dinamicamente lo schema temporaneo creato dall'esecuzione di dbt Cloud ed esegue l'override dell'attributo utente selezionato con questo nome dello schema temporaneo per la durata dell'esecuzione CI.
Configura avvisi
Per ricevere avvisi email in base allo stato delle esecuzioni CI, puoi configurare gli avvisi per una suite CI. In questo modo puoi monitorare le esecuzioni di integrazione continua senza dover consultare la pagina Esecuzioni nell'IDE di Looker.
Per configurare gli avvisi email per una suite CI, segui questi passaggi durante la creazione o la modifica di una suite CI:
- Attiva l'opzione Abilita avvisi email.
- Nel campo Indirizzi email, inserisci un elenco separato da virgole degli indirizzi email che devono ricevere gli avvisi.
- Utilizza le caselle di controllo per selezionare gli stati dei job che devono attivare un avviso:
- Non riuscita: attiva un'email quando un'esecuzione CI non supera i test di convalida.
- Errore: attiva un'email quando un'esecuzione CI rileva un errore di sistema o di configurazione.
- Superata: attiva un'email quando un'esecuzione CI viene completata correttamente.
- Annullata: attiva un'email quando un'esecuzione CI viene annullata.
Eliminazione di una suite
Per eliminare una suite CI:
- Nell'IDE di Looker, fai clic sull'icona Integrazione continua nella barra di navigazione dell'IDE.
- Fai clic sulla scheda Suite per aprire la pagina Suite.
- Nella pagina Suite, fai clic sul pulsante Modifica suite della suite.
- Nella pagina della suite, fai clic sul pulsante Elimina suite.
- Nella finestra di dialogo di conferma, fai clic sul pulsante Elimina suite.