Eine Continuous Integration-Suite (CI-Suite) ist eine Reihe von Validierungsanweisungen, die mit Ihrem LookML-Projekt verknüpft sind. Ein Looker-Nutzer mit der manage_ci Berechtigung kann in einer CI-Suite Folgendes konfigurieren:
- Wie eine CI-Validierungsausführung ausgelöst wird (manuell über die Looker-IDE oder automatisch, wenn eine Pull-Anfrage an Ihr Repository gesendet wird).
- Welche CI-Validatoren ausgeführt werden sollen.
- Zusätzliche Optionen für jeden Validierungstest. Weitere Informationen finden Sie auf den Dokumentationsseiten für die einzelnen Validatoren:
Hinweis
Bevor Sie eine CI-Suite erstellen können, benötigen Sie Folgendes:
- Eine Looker-Instanz, die die Anforderungen für CI erfüllt und für CI aktiviert ist.
- Ein Looker-Nutzerkonto mit der Berechtigung
manage_ci(diese Berechtigung ist im Berechtigungssatz „Administrator“ enthalten).
CI-Suite erstellen
Sie können die Validatoren auf der Seite Suites in der Looker-IDE konfigurieren und ausführen:
So erstellen Sie eine CI-Suite:
- Klicken Sie in der Looker-IDE in der IDE-Navigationsleiste auf das Symbol Continuous Integration.
- Klicken Sie auf den Tab Suites , um die Seite Suites zu öffnen.
- Auf der Seite Suites können Sie eine neue Suite erstellen oder eine vorhandene Suite bearbeiten:
- Klicken Sie zum Erstellen einer neuen Suite auf die Schaltfläche Suite erstellen.
- Wenn Sie eine vorhandene Suite bearbeiten möchten, klicken Sie für die Suite auf die Schaltfläche Suite bearbeiten.
- Geben Sie einen Namen für den Suite-Namen ein. Wenn Sie eine vorhandene Suite bearbeiten, können Sie optional auf das Stiftsymbol klicken, um den Namen der Suite zu bearbeiten.
- Optional: Aktivieren Sie die Option Trigger nach Zeitplan starten , wenn Sie automatische Validierungstests nach einem wiederkehrenden Zeitplan einrichten möchten. Weitere Informationen finden Sie im Abschnitt Trigger nach Zeitplan starten auf dieser Seite.
Optional: Aktivieren Sie die Option Bei Pull-Anfragen von Looker auslösen , wenn Sie automatische Validierungstests einrichten möchten, die immer dann ausgeführt werden, wenn ein Looker-Entwickler eine Pull-Anfrage an Ihr Repository sendet. Weitere Informationen finden Sie im Abschnitt Bei Pull-Anfragen von Looker auslösen auf dieser Seite.
Wenn Sie die Auslösung von Pull-Anfragen für eine CI-Suite aktivieren, können Sie optional im Feld Nur für Zielbranch angeben, dass Pull-Anfragen nur an bestimmte Branches im Repository eine Ausführung der CI-Suite auslösen sollen. Weitere Informationen finden Sie im Abschnitt Bei Pull-Anfragen von Looker auslösen auf dieser Seite.
Optional: Aktivieren Sie die Umschalter für die Validatoren, um einen Validator zu aktivieren und seine Optionen zu konfigurieren. Weitere Informationen finden Sie auf den Dokumentationsseiten für die einzelnen Validatoren:
Speichern Sie Ihre Änderungen:
- Wenn Sie eine neue Suite erstellen, klicken Sie auf die Schaltfläche Suite erstellen.
- Wenn Sie eine vorhandene Suite bearbeiten, klicken Sie auf die Schaltfläche Suite aktualisieren.
Trigger
CI-Ausführungen können auf verschiedene Arten ausgelöst werden:
- Automatisch nach einem wiederkehrenden Zeitplan.
- Automatisch, wenn ein Looker-Entwickler eine Pull-Anfrage an das Repository Ihres LookML-Projekts sendet.
- Manuell über die Schaltfläche Suite ausführen auf der Seite Suites in der Looker-IDE.
- Manuell, indem Sie eine vorherige CI-Ausführung noch einmal ausführen, von der Seite Ausführungen der Looker-IDE.
Trigger nach Zeitplan starten
Sie können eine CI-Suite so konfigurieren, dass sie automatisch nach einem Zeitplan ausgelöst wird. Aktivieren Sie dazu die Option Trigger nach Zeitplan starten.
Wenn diese Option aktiviert ist, können Sie die Häufigkeit und die Details für die automatische Ausführung Ihrer CI-Suite auswählen:
- Monatlich an einem bestimmten Tag und zu einer bestimmten Uhrzeit
- Wöchentlich an einem bestimmten Tag und zu einer bestimmten Uhrzeit
- Täglich zu einer bestimmten Uhrzeit
- Stündlich oder alle 2, 3, 4, 6, 8 oder 12 Stunden, beginnend und endend zu bestimmten Tageszeiten
- Minuten alle 5, 10, 15, 20 oder 30 Minuten, beginnend und endend zu bestimmten Tageszeiten
- Bestimmte Monate des Jahres an einem bestimmten Tag und zu einer bestimmten Uhrzeit
- Bestimmte Tage der Woche zu einer bestimmten Uhrzeit
Bei Pull-Anfragen von Looker auslösen
Wenn eine CI-Suite automatisch bei Pull-Anfragen ausgelöst werden soll, aktivieren Sie die Option Bei Pull-Anfragen von Looker auslösen. Damit die Auslösung von Pull-Anfragen funktioniert, muss Ihr Git-Repository von Ihrem Looker-Administrator auf der Seite Continuous Integration im Bereich „Admin“ von Looker konfiguriert werden.
Wenn Sie Pull-Anfrage-Trigger für eine CI-Suite aktivieren, können Sie optional angeben, dass Pull-Anfragen nur an bestimmte Branches im Repository eine Ausführung der CI-Suite auslösen sollen. Wenn Sie die automatische Auslösung von CI-Ausführungen bei Pull-Anfragen auf bestimmte Branches in Ihrem Repository beschränken möchten, geben Sie im Feld Nur für Zielbranch eine durch Kommas getrennte Liste der Branches ein.
Wenn ein Repository beispielsweise drei Branches mit den Namen main, release_1, und dev hat, können Sie im Feld Nur für Zielbranch main, release_1 eingeben. Das bedeutet, dass CI-Ausführungen ausgelöst werden, wenn ein Looker-Entwickler eine Pull-Anfrage an den Branch main oder release_1 sendet. Wenn ein Looker-Entwickler eine Pull-Anfrage an den Branch dev sendet, wird dadurch keine automatische Ausführung der CI-Suite ausgelöst.
Suite löschen
So löschen Sie eine CI-Suite:
- Klicken Sie in der Looker-IDE in der IDE-Navigationsleiste auf das Symbol Continuous Integration.
- Klicken Sie auf den Tab Suites , um die Seite Suites zu öffnen.
- Klicken Sie auf der Seite Suites für die Suite auf die Schaltfläche Suite bearbeiten.
- Klicken Sie auf der Seite der Suite auf die Schaltfläche Suite löschen.
- Klicken Sie im Bestätigungsdialogfeld auf die Schaltfläche Suite löschen.