Eine Continuous Integration-Suite (CI) besteht aus einer Reihe von Validierungsanweisungen, die mit Ihrem LookML-Projekt verknüpft sind. Ein Looker-Nutzer mit der Berechtigung manage_ci kann Folgendes in einer CI-Suite konfigurieren:
- Wie ein CI-Validierungslauf ausgelöst wird (manuell über die Looker IDE oder automatisch, wenn ein Pull-Request 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 der einzelnen Validator:
Hinweise
Bevor Sie eine CI-Suite erstellen können, benötigen Sie Folgendes:
- Eine Looker-Instanz, die den Anforderungen für CI entspricht und für CI aktiviert ist.
- Ein Looker-Nutzerkonto mit der Berechtigung
manage_ci(diese Berechtigung ist in der Berechtigungsgruppe „Administrator“ enthalten).
CI-Suite erstellen
Sie können die Validator in der Looker IDE auf der Seite Suites 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 bearbeiten:
- Klicken Sie auf die Schaltfläche Suite erstellen, um eine neue Suite zu erstellen.
- Wenn Sie eine vorhandene Suite bearbeiten möchten, klicken Sie 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 Bei Pull-Anfragen von Looker auslösen, wenn Sie automatische Validierungstests einrichten möchten, wenn ein Looker-Entwickler einen Pull-Request an Ihr Repository sendet. Weitere Informationen finden Sie im Abschnitt Trigger auf dieser Seite.
Wenn Sie das Auslösen von Pull-Requests für eine CI-Suite aktivieren, können Sie optional das Feld Nur für Zielzweig verwenden, um anzugeben, dass Pull-Requests nur für bestimmte Zweige im Repository einen Lauf der CI-Suite auslösen sollen. Weitere Informationen finden Sie im Abschnitt Trigger auf dieser Seite.
Optional können Sie die Ein-/Aus-Schaltflächen für Validator aktivieren, um einen Validator zu aktivieren und seine Optionen zu konfigurieren. Weitere Informationen finden Sie in den Dokumentationsseiten der einzelnen Validator:
Speichern Sie die Ä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, indem Sie auf der Seite Ausführungen der Looker-IDE einen vorherigen CI-Lauf noch einmal ausführen.
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 Pull-Anfragetrigger verwendet werden können, muss Ihr Looker-Administrator Ihr Git-Repository auf der Seite Continuous Integration Admin (Continuous Integration – Administrator) in Looker konfigurieren.
Wenn Sie Pull-Anfrage-Trigger für eine CI-Suite aktivieren, können Sie optional angeben, dass Pull-Anfragen nur für bestimmte Branches im Repository einen Lauf der CI-Suite auslösen sollen. Wenn Sie automatische Pull-Request-Trigger von CI-Ausführungen auf bestimmte Zweige in Ihrem Repository beschränken möchten, geben Sie in das Feld Nur für Zielzweig eine durch Kommas getrennte Liste der Zweige 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 Zielzweig eingeben. Das bedeutet, dass CI-Ausführungen ausgelöst werden, wenn ein Looker-Entwickler einen Pull-Request für den main- oder release_1-Zweig einreicht. Wenn ein Looker-Entwickler einen Pull-Request an den dev-Branch 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 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 für die jeweilige 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.