Eine Continuous Integration-Suite (CI) ist eine Reihe von Validierungsanweisungen, die mit Ihrem LookML-Projekt verknüpft sind. Ein Looker-Nutzer mit der Berechtigung manage_ci kann in einer CI-Suite Folgendes konfigurieren:
- Wie ein CI-Validierungslauf ausgelöst wird (manuell über die Looker-IDE oder automatisch, wenn eine Pull-Anfrage an Ihr Repository gesendet wird).
- Welche CI-Validierungen sollen ausgeführt werden?
- 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 für Administratoren 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:
- Wenn Sie eine neue Suite erstellen möchten, klicken Sie auf den Button 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 Nach Zeitplan auslösen, wenn Sie automatische Validierungstests nach einem wiederkehrenden Zeitplan einrichten möchten. Weitere Informationen finden Sie im Abschnitt Trigger für einen Zeitplan auf dieser Seite.
Optional: Aktivieren Sie die Ein/Aus-Schaltfläche 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 auf dieser Seite im Abschnitt Bei Pull-Anfragen von Looker auslösen.
Wenn Sie das Auslösen von Pull-Anfragen für eine CI-Suite aktivieren, können Sie optional das Feld Nur für Zielbranch verwenden, um anzugeben, dass Pull-Anfragen nur für bestimmte Branches im Repository einen Lauf der CI-Suite auslösen sollen. Weitere Informationen finden Sie auf dieser Seite im Abschnitt Bei Pull-Anfragen von Looker auslösen.
Optional: Aktivieren Sie die Ein/Aus-Schaltfläche Bei Pull-Anfragen von dbt Cloud auslösen, wenn Sie automatische Validierungstests einrichten möchten, die immer dann ausgeführt werden, wenn ein dbt Cloud-CI-Job ausgeführt wird. Weitere Informationen finden Sie auf dieser Seite im Abschnitt Bei Pull-Anfragen von dbt Cloud auslösen.
Optional: Aktivieren Sie den Ein/Aus-Button E‑Mail-Benachrichtigungen aktivieren, wenn Sie E‑Mail-Benachrichtigungen basierend auf dem Status eines CI-Laufs erhalten möchten. Weitere Informationen finden Sie im Abschnitt Benachrichtigungen einrichten auf dieser Seite.
Aktivieren Sie optional die Ein/Aus-Schalter für die Validierung, um eine Validierung zu aktivieren und ihre Optionen zu konfigurieren. Weitere Informationen finden Sie auf den Dokumentationsseiten für die einzelnen Validatoren:
Speichern Sie die Änderungen:
- Wenn Sie eine neue Suite erstellen möchten, klicken Sie auf den Button Suite erstellen.
- Wenn Sie eine vorhandene Suite bearbeiten, klicken Sie auf die Schaltfläche Suite aktualisieren.
Trigger
CI-Läufe können auf verschiedene Arten ausgelöst werden:
- In regelmäßigen Abständen.
- Automatisch, wenn eine Pull-Anfrage von einem Looker-Entwickler an das Repository Ihres LookML-Projekts gesendet wird.
- Automatisch, wenn ein dbt Cloud-CI-Job eine Pull-Anfrage erstellt.
- Manuell über die Schaltfläche Suite ausführen auf der Seite Suites in der Looker IDE.
- Manuell, indem Sie auf der Seite Runs der Looker-IDE einen vorherigen CI-Lauf noch einmal ausführen.
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 Ein/Aus-Schaltfläche Nach Zeitplan auslösen.
Wenn dieser Schalter 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 Zeit
- 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 Sie eine CI-Suite für die automatische Auslösung bei Pull-Anfragen konfigurieren möchten, aktivieren Sie die Ein/Aus-Schaltfläche Bei Pull-Anfragen von Looker auslösen. Damit Pull-Anfragen ausgelöst werden können, muss Ihr Git-Repository von Ihrem Looker-Administrator auf der Seite Continuous Integration Admin in Looker konfiguriert werden.
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-Anfrage-Trigger von CI-Läufen auf bestimmte Branches in Ihrem Repository beschränken möchten, geben Sie eine durch Kommas getrennte Liste der Branches in das Feld Nur für Zielbranch 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 Ziel-Branch eingeben. Das bedeutet, dass CI-Ausführungen ausgelöst werden, wenn ein Looker-Entwickler eine Pull-Anfrage für den main- oder den release_1-Branch sendet. Wenn ein Looker-Entwickler eine Pull-Anfrage für den dev-Branch einreicht, wird die CI-Suite nicht automatisch ausgeführt.
Bei Pull-Anfragen von dbt Cloud auslösen
Wenn Sie die dbt Cloud-Integration für Ihre Instanz konfiguriert haben, können Sie eine CI-Suite so konfigurieren, dass sie automatisch ausgelöst wird, wenn ein dbt Cloud-CI-Job abgeschlossen ist. Mit der CI-Suite wird geprüft, ob Änderungen an Ihren dbt-Modellen SQL-Fehler in Ihren Looker-Explores verursachen, bevor die dbt-Änderungen bereitgestellt werden.
Wenn Sie diesen Trigger konfigurieren möchten, aktivieren Sie beim Erstellen oder Bearbeiten einer CI-Suite die Ein/Aus-Schaltfläche Bei Pull-Anfragen von dbt Cloud auslösen.
Wenn Sie diesen Trigger aktiviert haben, konfigurieren Sie die folgenden Optionen:
dbt Cloud-Job: Wählen Sie den dbt Cloud-CI-Job aus dem Drop-down-Feld aus, der diese Suite auslösen soll.
Schema-Nutzerattribut: Wählen Sie das Looker-Nutzerattribut aus, das den Schemanamen für Ihre Datenbankverbindung enthält. In dieser Liste werden nur Nutzerattribute angezeigt, die im Bereich Verwaltung für CI aktiviert wurden.
Wenn Sie die Suite mit aktiviertem Trigger speichern, registriert Looker automatisch einen Webhook in Ihrem dbt Cloud-Konto, um auf den Abschluss von Jobs zu warten.
Bei dbt Cloud-ausgelösten Läufen identifiziert Looker dynamisch das temporäre Schema, das vom dbt Cloud-Lauf erstellt wurde, und überschreibt das ausgewählte Nutzerattribut mit diesem temporären Schemanamen für die Dauer des CI-Laufs.
Benachrichtigung einrichten
Wenn Sie E‑Mail-Benachrichtigungen basierend auf dem Status Ihrer CI-Läufe 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 Runs 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 den Ein/Aus-Button 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 einem CI-Lauf Validierungstests fehlschlagen.
- Fehler: Löst eine E-Mail aus, wenn bei einem CI-Lauf ein System- oder Konfigurationsfehler auftritt.
- Bestanden: Löst eine E‑Mail aus, wenn eine CI-Ausführung erfolgreich abgeschlossen wurde.
- Cancelled: Löst eine E‑Mail aus, wenn ein CI-Lauf abgebrochen wird.
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 Suite auf den Button 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.