Continuous Integration-Suites ausführen

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

Nach Abschluss der Validierungstests können Sie die Ergebnisse wie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Läufen ansehen beschrieben prüfen.

Automatische Auslösung durch Pull-Anfragen

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

Bei automatischen Validierungsläufen für Pull-Requests validiert CI den letzten Commit des Pull-Requests 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-Läufen 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 einen neuen Lauf einer CI-Suite 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 Lauf manuell auslösen mit den Arbeitsbereich-Optionen den Branch aus, den Sie validieren möchten (siehe Abschnitt Arbeitsbereich):

    • Wenn Sie die Produktionsversion Ihres LookML-Projekts validieren möchten, klicken Sie auf Production (Produktion).
    • Wenn Sie einen Entwicklungszweig Ihres LookML-Projekts validieren möchten, klicken Sie auf Entwicklermodus. Wählen Sie im Drop-down-Menü Branch den zu validierenden Entwicklungs-Branch aus.

  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 Ausführung abgeschlossen ist.

Nachdem Sie einen Lauf ausgelöst haben, wird in der Looker-IDE die Seite Lauf für die Suite angezeigt, die Sie ausgelöst haben. Nach Abschluss der Validierungstests werden auf der Seite Ausführen die Ergebnisse für die einzelnen Validatoren 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 zu sehen.

Informationen zum Ansehen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Läufen ansehen.

Arbeitsbereich

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

Wenn Sie für die Option Production (Produktion) ermitteln möchten, welcher Branch oder Commit für die Produktionsversion verwendet wird, können Sie in der Looker-IDE im Abschnitt Git Summary (Git-Zusammenfassung) auf der Seite Branch Management (Branch-Verwaltung) der Project Settings (Projekteinstellungen) nachsehen:

  • Bei Projekten, die mit dem erweiterten Bereitstellungsmodus konfiguriert sind, ist die Produktionsversion ein Commit oder Tag, der vom Looker-Entwickler mit der Berechtigung deploy im Bereitstellungsmanager ausgewählt wird.
  • Bei Projekten ohne erweiterten Bereitstellungsmodus ist die Produktionsversion der Branch, der auf der Seite Projektkonfiguration der Projekteinstellungen im Feld Name des Git-Produktionszweigs konfiguriert ist.

Beachten Sie bei der Option Entwicklermodus Folgendes, wenn Sie Entwicklungszweige in Ihrem Projekt 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 in den Projekteinstellungen Ihres Projekts.
  • Damit ein Entwicklungszweig validiert werden kann, muss er in Ihr LookML-Repository übertragen werden. In der Looker-IDE muss der Entwickler dazu auf die Schaltfläche Commit Changes & Push klicken oder im Bereich „Git-Aktionen“ in der IDE die Option Commit auswählen.

Vorherigen CI-Lauf manuell noch einmal ausführen

Für abgeschlossene Läufe (unabhängig davon, ob sie erfolgreich waren, fehlgeschlagen sind, einen Fehler aufgewiesen haben oder abgebrochen wurden) kann ein Looker-Nutzer mit der Berechtigung see_ci einen erneuten Lauf des CI-Laufs manuell über die Looker-IDE auslösen:

  • Wenn Sie einen durch einen Pull-Request ausgelösten Lauf noch einmal ausführen, wird die Continuous Integration für dasselbe Commit wie beim ursprünglichen Lauf ausgeführt.
  • Wenn Sie einen manuell ausgelösten Lauf noch einmal ausführen, wird die kontinuierliche Integration zum Zeitpunkt der erneuten Ausführung für den Produktionsstatus oder den HEAD des Produktionszweigs ausgeführt. Dies umfasst alle nachfolgenden Commits, die seit dem ursprünglichen CI-Lauf vorgenommen wurden.

Wenn Sie die CI-Suite seit dem ersten Lauf bearbeitet haben, werden bei einem erneuten Lauf alle Änderungen berücksichtigt, die Sie seit dem ersten Lauf an der CI-Suite vorgenommen haben.

So führen Sie einen CI-Lauf 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 bei der 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 den ausgewählten Lauf oben auf die Schaltfläche Rerun (Erneut ausführen).

Wenn Sie auf Nochmal ausführen klicken, wird die Ausführung des Content-Validators gestartet und Sie werden zur Seite Ausführen für die neue Ausführung zurückgeleitet.

Informationen zum Ansehen der Ergebnisse finden Sie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Läufen ansehen.

CI-Ausführung abbrechen

Wenn Sie einen laufenden CI-Lauf abbrechen möchten, können Sie das auf der Seite Lauf 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 bei der 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.

Wenn Sie auf Abbrechen klicken, wird die Ausführung von Continuous Integration abgebrochen und auf der Seite Ausführung wird der Status Abgebrochen angezeigt.