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 der Continuous Integration-Ausführung ansehen beschrieben.

Automatisches Auslösen von Pull-Anfragen

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

Bei automatischen Validierungsläufen für Pull-Anfragen validiert die CI den neuesten Commit der Pull-Anfrage und gibt alle Fehler in dieser Version des Repositorys zurück.

Informationen zum Aufrufen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse der Continuous Integration-Ausführung ansehen.

Automatisches Auslösen von Pull-Anfragen aus importierten Projekten

Wenn Sie Ihre CI-Suite in einem Downstream-Projekt (Spoke) mit Trigger on pull requests from imported projects aktiviert haben, löst die CI automatisch einen Validierungslauf im Spoke-Projekt aus, wenn ein Entwickler eine Pull-Anfrage im Repository eines abonnierten Upstream-Projekts (Hub) öffnet oder aktualisiert.

Während einer CI-Ausführung, die durch eine Pull-Anfrage für ein importiertes Projekt ausgelöst wird, führt Looker die folgenden Aktionen aus:

  1. Validiert die Produktionsversion des Spoke-Projekts, während das importierte Hub-Projekt vorübergehend an den Commit der Pull-Anfrage angepinnt wird.
  2. Schreibt das Ergebnis der CI-Ausführung des Spoke-Projekts zurück in die Pull-Anfrage im Repository des Hub-Projekts.

Informationen zum Aufrufen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse der Continuous Integration-Ausführung ansehen.

Automatisches Auslösen über dbt Cloud

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

Ein CI-Lauf, der durch einen dbt Cloud-CI-Job ausgelöst wird, soll prüfen, ob in dbt vorgenommene Schemaänderungen LookML-Inhalte beeinträchtigen. Während der Ausführung führt Looker die folgenden Aktionen aus:

  1. Empfängt die Benachrichtigung von dbt Cloud, wenn der Job abgeschlossen ist.
  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 funktionsgefährdende Änderungen (z. B. gelöschte Spalten oder umbenannte Tabellen) erkennen, bevor die dbt-Änderungen in der Produktion zusammengeführt werden. Nach Abschluss der Ausführung wird der Attributwert für die CI-Nutzer auf den Standardwert zurückgesetzt.

Automatische Auslösung nach einem Zeitplan

Wenn Sie in Ihrer CI-Suite Trigger on a schedule (Trigger nach Zeitplan) aktiviert haben, wird automatisch ein Validierungslauf nach dem von Ihnen angegebenen Zeitplan ausgelöst.

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

Informationen zum Aufrufen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse der Continuous Integration-Ausführung ansehen.

Neue Ausführung einer CI-Suite manuell auslösen

Ein Looker-Nutzer mit der Berechtigung see_ci kann einen CI-Lauf manuell über die Looker-IDE auslösen.

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

  1. Klicken Sie in der Looker-IDE in der IDE-Navigationsleiste 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 den Button Suite ausführen. Wenn Sie keine CI-Suiten 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 Arbeitsbereich-Optionen 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 Entwicklungsmodus. Wählen Sie im Drop-down-Menü Branch den Entwicklungszweig aus, den Sie validieren möchten.

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

Die Ausführung der CI-Suite kann je nach Größe des Projekts, den in der CI-Suite enthaltenen Validatoren und der Konfiguration der CI-Suite mehrere Minuten dauern.

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

Informationen zum Aufrufen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse der Continuous Integration-Ausführung ansehen.

Arbeitsbereich

Wenn Sie einen CI-Lauf manuell auslösen, können Sie mit den Arbeitsbereichsoptionen entweder die Produktionsversion Ihres Repositorys oder einen Entwicklungszweig Ihres Repositorys validieren.

Wenn Sie bei der Option Produktion herausfinden möchten, welcher Branch oder Commit für die Produktionsversion verwendet wird, können Sie in der Looker-IDE im Feld Standard-Produktions-Branch im Abschnitt Git-Zusammenfassung auf der Seite Branch-Verwaltung der Projekteinstellungen nachsehen:

Beachten Sie bei der Option Entwicklermodus Folgendes, um Entwicklungszweige in Ihrem Projekt zu validieren:

  • Die Branches in Ihrem LookML-Projekt sowie den Produktions-Branch und die persönlichen Branches Ihrer Entwickler finden Sie in der Looker-IDE auf der Seite Branch-Verwaltung der Projekteinstellungen Ihres Projekts.
  • Um einen Entwicklungszweig zu validieren, muss er in Ihr LookML-Repository übertragen werden. In der Looker-IDE bedeutet dies, dass der Entwickler auf die Schaltfläche Commit Changes & Push klicken oder die Option Commit im Git-Aktionsbereich in der IDE auswählen muss.

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

Für abgeschlossene Ausführungen (wenn die Ausführung erfolgreich war, fehlgeschlagen ist, einen Fehler verursacht hat oder abgebrochen wurde) kann ein Looker-Nutzer mit der Berechtigung see_ci die CI-Ausführung manuell über die Looker-IDE noch einmal auslösen:

  • Wenn Sie einen PR-getriggerten Lauf noch einmal ausführen (der durch eine Pull-Anfrage im Repository des Projekts oder in einem importierten Projekt ausgelöst wird), wird die Continuous Integration für denselben Commit wie der ursprüngliche Lauf ausgeführt.
  • Wenn Sie einen manuell ausgelösten Lauf noch einmal ausführen, wird die Continuous Integration für den Produktionsstatus oder den Branch-HEAD zum Zeitpunkt der erneuten Ausführung ausgeführt. Dies umfasst alle nachfolgenden Commits, die seit dem ersten CI-Lauf vorgenommen wurden.

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

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

  1. Klicken Sie in der Looker-IDE in der IDE-Navigationsleiste 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 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 den Button Noch einmal ausführen.

Wenn Sie auf Erneut ausführen klicken, wird die Inhaltsvalidierung gestartet und Sie werden zur Seite Ausführen für die neue Ausführung weitergeleitet.

Informationen zum Aufrufen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse der Continuous Integration-Ausführung ansehen.

CI-Ausführung abbrechen

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

  1. Klicken Sie in der Looker-IDE in der IDE-Navigationsleiste 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 Ausführung ansehen.
  4. Klicken Sie auf der Seite Ausführung für die ausgewählte Ausführung oben auf der Seite auf den Button Abbrechen.

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