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 Navigationsleiste der IDE 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.
- Klicken Sie zum Bearbeiten einer vorhandenen Suite auf die Schaltfläche Suite bearbeiten für die Suite.
- 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 Suite-Namen 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, sobald 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 Option E-Mail-Benachrichtigungen aktivieren , wenn Sie E-Mail-Benachrichtigungen basierend auf dem Status einer CI-Ausführung erhalten möchten. Weitere Informationen finden Sie im Abschnitt Benachrichtigung einrichten auf dieser Seite.
Optional: Aktivieren Sie die Schalter 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 Wochentage 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 verwendet werden kann, muss Ihr Git-Repository von Ihrem Looker-Administrator auf der Continuous Integration Admin Seite 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 automatische Pull-Anfrage-Trigger von CI-Ausführungen 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 main, release_1 in das Feld Nur für Zielbranch 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.
Benachrichtigung einrichten
Wenn Sie E-Mail-Benachrichtigungen basierend auf dem Status Ihrer CI-Ausführungen erhalten möchten, können Sie Benachrichtigungen für eine CI-Suite einrichten. So können Sie Continuous Integration-Ausführungen überwachen, ohne die Seite Ausführungen in der Looker IDE aufrufen zu müssen.
So konfigurieren Sie E-Mail-Benachrichtigungen für eine CI-Suite, wenn Sie eine CI-Suite erstellen oder bearbeiten:
- Aktivieren Sie die Option E-Mail-Benachrichtigungen aktivieren.
- Geben Sie im Feld E-Mail-Adressen eine durch Kommas getrennte Liste der E-Mail-Adressen ein, an die die Benachrichtigungen gesendet werden sollen.
- Wählen Sie mit den Kästchen die Jobstatus aus, die eine Benachrichtigung auslösen sollen:
- Fehlgeschlagen: Löst eine E-Mail aus, wenn bei einer CI-Ausführung Validierungstests fehlschlagen.
- Fehler: Löst eine E-Mail aus, wenn bei einer CI-Ausführung ein System- oder Konfigurationsfehler auftritt.
- Bestanden: Löst eine E-Mail aus, wenn eine CI-Ausführung erfolgreich abgeschlossen wurde.
- Abgebrochen: Löst eine E-Mail aus, wenn eine CI-Ausführung abgebrochen wurde.
Suite löschen
So löschen Sie eine CI-Suite:
- Klicken Sie in der Looker IDE in der Navigationsleiste der IDE auf das Symbol Continuous Integration.
- Klicken Sie auf den Tab Suites , um die Seite Suites zu öffnen.
- Klicken Sie auf der Seite Suites auf die Schaltfläche Suite bearbeiten für die Suite.
- 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.