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 maggiori 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 quanto segue:
- 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 anche fare clic sull'icona a forma di matita per modificare il nome della suite.
- (Facoltativo) Attiva il pulsante 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 il pulsante 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 tuo 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 ramo di destinazione per specificare che le richieste di pull solo a rami specifici del 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 il pulsante 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 i pulsanti degli strumenti di convalida per attivare uno strumento di convalida e configurarne le opzioni. Per maggiori 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.
- 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 il pulsante Attiva in base a una pianificazione.
Quando questo pulsante è attivo, 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
- Quotidiana, a un'ora specifica
- Ogni ora o ogni 2, 3, 4, 6, 8 o 12 ore, a partire da orari specifici del giorno e fino a orari specifici del giorno
- Minuti ogni 5, 10, 15, 20 o 30 minuti, a partire da orari specifici del giorno e fino a orari specifici del giorno
- 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 il pulsante 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 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 rami specifici del repository devono attivare un'esecuzione della suite CI. Per limitare i trigger automatici delle richieste di pull delle esecuzioni CI a rami specifici del repository, inserisci un elenco separato da virgole dei rami nel campo Solo per il ramo di destinazione.
Ad esempio, se un repository ha tre rami denominati main, release_1, e dev, puoi inserire main, release_1 nel campo Solo per il ramo di destinazione. Ciò significa che le esecuzioni CI verranno attivate quando uno sviluppatore Looker invia una richiesta di pull al ramo main o release_1. Se uno sviluppatore Looker invia una richiesta di pull al ramo dev, non verrà attivata un'esecuzione automatica della suite 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 quando crei o modifichi una suite CI:
- Attiva il pulsante 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.