Continuous Integration-Suites ausführen

Continuous Integration-Ausführungen (CI) können auf verschiedene Arten ausgelöst werden:

Nach Abschluss der Validierungstests können Sie die Ergebnisse prüfen, wie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Ausführungen ansehen beschrieben.

Automatische Auslösung über Pull-Anfragen

Wenn Sie Ihre CI-Suite mit Bei Pull-Anfragen von Looker auslösen aktiviert haben, löst CI automatisch eine Validierungsausführung aus, wenn ein Looker-Entwickler eine Pull-Anfrage an Ihr LookML-Repository sendet. Optional können Sie festlegen, dass Pull-Anfragen nur an bestimmte Zweige in Ihrem Repository automatische CI-Ausführungen auslösen sollen.

Bei automatischen Validierungsausführungen für Pull-Anfragen validiert CI den neuesten Pull-Anfrage-Commit und gibt alle Fehler in dieser Version des Repositorys zurück.

Informationen zum Ansehen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Ausführungen ansehen.

Automatische Auslösung über dbt Cloud

Wenn Sie Ihre CI-Suite mit Bei Pull-Anfragen von dbt Cloud auslösen aktiviert haben, löst CI automatisch eine Validierungsausführung aus, wenn der angegebene dbt Cloud CI-Job abgeschlossen ist.

Eine CI-Ausführung, die durch einen dbt Cloud CI-Job ausgelöst wird, soll prüfen, ob Schemasänderungen in dbt LookML-Inhalte beschädigen. Während der Ausführung führt Looker die folgenden Aktionen aus:

  1. Empfängt die Benachrichtigung von dbt Cloud nach Abschluss des Jobs.
  2. Extrahiert die Details des temporären Schemas, das von dbt Cloud für diese bestimmte Ausführung erstellt wurde.
  3. Überschreibt das konfigurierte Nutzerattribut (z. B. das Schemaattribut für Ihre Verbindung) mit dem Namen dieses temporären Schemas.
  4. Führt die CI-Validatoren für dieses temporäre Schema aus.

So können Sie Breaking Changes (z. B. gelöschte Spalten oder umbenannte Tabellen) erkennen, bevor die dbt-Änderungen in die Produktion übernommen werden. Nach Abschluss der Ausführung wird der Wert des Nutzerattributs auf den Standardwert für die CI-Nutzer zurückgesetzt.

Automatische Auslösung nach Zeitplan

Wenn Sie Ihre CI-Suite mit Nach Zeitplan auslösen aktiviert haben, löst CI automatisch eine Validierungsausführung nach dem von Ihnen angegebenen Zeitplan aus.

Bei automatischen geplanten Validierungsausführungen validiert CI die Produktionsversion des Repositorys und gibt alle Fehler in dieser Version zurück.

Informationen zum Ansehen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Ausführungen ansehen.

Manuelles Auslösen einer neuen Ausführung einer CI-Suite

Ein Looker-Nutzer mit der see_ci Berechtigung kann eine CI-Ausführung manuell über die Looker-IDE auslösen.

So lösen Sie eine neue Ausführung einer CI-Suite manuell aus:

  1. Klicken Sie in der Looker-IDE in der Navigationsleiste der IDE auf das Symbol Continuous Integration.
  2. Klicken Sie auf Suites , um die Seite Suites zu öffnen.
  3. Klicken Sie für die CI-Suite, die Sie ausführen möchten, auf die Schaltfläche Suite ausführen. Wenn Sie keine CI-Suites für Ihr Projekt haben, können Sie eine CI-Suite erstellen.

  4. Wählen Sie im Dialogfeld Ausführung manuell auslösen mit den Optionen unter Arbeitsbereich den Zweig aus, den Sie validieren möchten. Weitere Informationen finden Sie im Abschnitt Arbeitsbereich.

    • Wenn Sie die Produktionsversion Ihres LookML-Projekts validieren möchten, klicken Sie auf Produktion.
    • Wenn Sie einen Entwicklungszweig Ihres LookML-Projekts validieren möchten, klicken Sie auf Entwicklermodus. Wählen Sie im Drop-down-Menü Zweig den Entwicklungszweig aus, der validiert werden soll.

  5. Klicken Sie auf Ausführung starten, um die Ausführung der CI-Suite auszulösen.

Je nach Größe Ihres Projekts, den in der CI-Suite enthaltenen Validatoren und der Konfiguration der CI-Suite kann es einige Minuten dauern, bis die CI-Suite ausgeführt wurde.

Nachdem Sie eine Ausführung ausgelöst haben, wird in der Looker-IDE die Seite Ausführung für die Suite angezeigt, die Sie ausgelöst haben. Nach Abschluss der Validierungstests werden auf der Seite Ausführung die Ergebnisse für jeden der Validatoren angezeigt. Sie können die Seite Ausführung verlassen, während die Validierungstests ausgeführt werden, und später zur Seite Ausführung zurückkehren, um die Ergebnisse zu sehen.

Informationen zum Ansehen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Ausführungen ansehen.

Arbeitsbereich

Wenn Sie eine CI-Ausführung manuell auslösen, können Sie mit den Optionen unter Arbeitsbereich entweder die Produktionsversion Ihres Repositorys oder einen Entwicklungszweig Ihres Repositorys validieren.

Wenn Sie für die Option Produktion ermitteln möchten, welcher Zweig oder Commit für die Produktionsversion verwendet wird, können Sie in der Looker-IDE im Feld Standardproduktionszweig des Bereichs Git-Zusammenfassung auf der Seite Zweigverwaltung der Projekteinstellungen nachsehen:

Beachten Sie bei der Option Entwicklermodus Folgendes, wenn Sie Entwicklungszweige in Ihrem Projekt validieren möchten:

  • Die Zweige in Ihrem LookML-Projekt und die Produktionszweige und persönlichen Zweige Ihrer Entwickler finden Sie auf der Zweigverwaltung Seite der Projekteinstellungen Ihres Projekts in der Looker-IDE.
  • Wenn Sie einen Entwicklungszweig validieren möchten, muss er in Ihr LookML-Repository übertragen werden. In der Looker-IDE bedeutet das, dass der Entwickler auf die Schaltfläche Änderungen committen und übertragen klicken oder im Bereich „Git-Aktionen“ in der IDE die Option Commit auswählen muss.

Vorherige CI-Ausführung manuell noch einmal ausführen

Bei abgeschlossenen Ausführungen (wenn die Ausführung erfolgreich war, fehlgeschlagen ist, Fehler aufgetreten sind oder sie abgebrochen wurde) kann ein Looker-Nutzer mit der see_ci Berechtigung die CI-Ausführung manuell über die Looker-IDE noch einmal auslösen:

  • Wenn Sie eine durch eine Pull-Anfrage ausgelöste Ausführung noch einmal ausführen, wird Continuous Integration für denselben Commit wie bei der ursprünglichen Ausführung ausgeführt.
  • Wenn Sie eine manuell ausgelöste Ausführung noch einmal ausführen, wird Continuous Integration für den Produktionsstatus oder den Zweig-HEAD zum Zeitpunkt der erneuten Ausführung ausgeführt. Das umfasst alle nachfolgenden Commits, die seit der ersten CI-Ausführung vorgenommen wurden.

Wenn Sie die CI-Suite seit der ersten Ausführung bearbeitet haben, werden bei einer erneuten Ausführung auch alle Änderungen berücksichtigt, die Sie seit der ersten Ausführung an der CI-Suite vorgenommen haben.

So führen Sie eine CI-Ausführung noch einmal aus:

  1. Klicken Sie in der Looker-IDE in der Navigationsleiste der IDE auf das Symbol Continuous Integration.
  2. Klicken Sie auf Ausführungen , um die Seite Ausführungen zu öffnen.
  3. Klicken Sie auf der Seite Ausführungen für die CI-Ausführung, die Sie abbrechen möchten, auf die Schaltfläche Ausführung ansehen.
  4. Klicken Sie auf der Seite mit den Ausführungsergebnissen für die ausgewählte Ausführung oben auf der Seite auf die Schaltfläche Nochmal ausführen.

Sobald Sie auf Nochmal ausführen klicken, startet die Inhaltsvalidierung die Ausführung und Sie werden zur Seite Ausführung für die neue Ausführung zurückgeleitet.

Informationen zum Ansehen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Ausführungen ansehen.

CI-Ausführung abbrechen

Wenn Sie eine laufende CI-Ausführung abbrechen möchten, können Sie das auf der Seite Ausführung tun. Gehen Sie dazu so vor:

  1. Klicken Sie in der Looker-IDE in der Navigationsleiste der IDE auf das Symbol Continuous Integration.
  2. Klicken Sie auf Ausführungen , um die Seite Ausführungen zu öffnen.
  3. Klicken Sie auf der Seite Ausführungen für die CI-Ausführung, die Sie abbrechen möchten, auf die Schaltfläche Ausführung ansehen.
  4. Klicken Sie auf der Seite Ausführung für die ausgewählte Ausführung oben auf der Seite auf die Schaltfläche Abbrechen.

Sobald Sie auf Abbrechen klicken, bricht Continuous Integration die Ausführung ab und zeigt auf der Seite Ausführung den Status Abgebrochen an.