Continuous Integration-Suite erstellen

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:

Hinweis

Bevor Sie eine CI-Suite erstellen können, benötigen Sie Folgendes:

CI-Suite erstellen

Sie können die Validatoren auf der Seite Suites in der Looker IDE konfigurieren und ausführen:

Seite „CI-Suites“

So erstellen Sie eine CI-Suite:

  1. Klicken Sie in der Looker IDE in der Navigationsleiste der IDE auf das Symbol Continuous Integration.
  2. Klicken Sie auf den Tab Suites , um die Seite Suites zu öffnen.
  3. 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.
  4. Geben Sie einen Namen für die Suite ein. Wenn Sie eine vorhandene Suite bearbeiten, können Sie optional auf das Stiftsymbol klicken, um den Namen der Suite zu bearbeiten.
  5. 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.

  6. 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 Zielzweig angeben, dass Pull-Anfragen nur an bestimmte Zweige 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.

  7. Optional: Aktivieren Sie die Option 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 im Abschnitt Bei Pull-Anfragen von dbt Cloud auslösen auf dieser Seite.

  8. 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.

  9. 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:

  10. 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:

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 funktioniert, muss Ihr Git-Repository von Ihrem Looker-Administrator auf der Continuous Integration Admin Seite 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 Zweige im Repository eine Ausführung der CI-Suite auslösen sollen. Wenn Sie automatische Pull-Anfrage-Trigger von CI-Ausführungen auf bestimmte Zweige in Ihrem Repository beschränken möchten, geben Sie im Feld Nur für Zielzweig eine durch Kommas getrennte Liste der Zweige ein.

Wenn ein Repository beispielsweise drei Zweige 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 eine Pull-Anfrage an den Zweig main oder release_1 sendet. Wenn ein Looker-Entwickler eine Pull-Anfrage an den Zweig dev sendet, wird dadurch keine automatische Ausführung der CI-Suite ausgelöst.

Bei Pull-Anfragen von dbt Cloud auslösen

Wenn Sie die dbt Cloud-Integration in Ihrer 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. Die CI-Suite prü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 Option Bei Pull-Anfragen von dbt Cloud auslösen.

Nachdem Sie diesen Trigger aktiviert haben, konfigurieren Sie die folgenden Optionen:

  • dbt Cloud-Job: Wählen Sie im Drop-down-Feld den dbt Cloud-CI-Job 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 Admin 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 Ausführungen, die von dbt Cloud ausgelöst werden, ermittelt Looker dynamisch das temporäre Schema, das von der dbt Cloud-Ausführung erstellt wurde, und überschreibt das ausgewählte Nutzerattribut mit diesem temporären Schemanamen für die Dauer der CI-Ausführung.

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 beim Erstellen oder Bearbeiten einer CI-Suite:

  1. Aktivieren Sie die Option E-Mail-Benachrichtigungen aktivieren.
  2. Geben Sie im Feld E-Mail-Adressen eine durch Kommas getrennte Liste der E-Mail-Adressen ein, an die die Benachrichtigungen gesendet werden sollen.
  3. 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 wird.

Suite löschen

So löschen Sie eine CI-Suite:

  1. Klicken Sie in der Looker IDE in der Navigationsleiste der IDE auf das Symbol Continuous Integration.
  2. Klicken Sie auf den Tab Suites , um die Seite Suites zu öffnen.
  3. Klicken Sie auf der Seite Suites für die Suite auf die Schaltfläche Suite bearbeiten.
  4. Klicken Sie auf der Seite der Suite auf die Schaltfläche Suite löschen.
  5. Klicken Sie im Bestätigungsdialogfeld auf die Schaltfläche Suite löschen.