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.
- 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 Namen der Suite zu bearbeiten.
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 Trigger 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 Trigger 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, 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 durch erneutes Ausführen einer vorherigen CI-Ausführung auf der Seite Ausführungen der Looker IDE.
Wenn Sie eine CI-Suite für die automatische Auslösung bei Pull-Anfragen konfigurieren möchten, 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 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 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.