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 prüfen, wie auf der Dokumentationsseite Ergebnisse von Continuous Integration-Läufen ansehen beschrieben.

Automatische Auslösung durch Pull-Anfragen

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

Bei automatischen Pull-Request-Validierungsläufen wird der letzte Pull-Request-Commit von CI validiert und alle Fehler in dieser Version des Repositorys werden zurückgegeben.

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

Neuen Lauf 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 Trigger a run manually (Lauf manuell auslösen) mit den Workspace-Optionen den Branch aus, den Sie validieren möchten (siehe Abschnitt Workspace):

    • 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 des 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 wird.

Nachdem Sie einen Lauf ausgelöst haben, wird in der Looker-IDE die Seite Run (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 bei der Option Produktion ermitteln möchten, welcher Branch oder Commit für die Produktionsversion verwendet wird, können Sie in der Looker-IDE im Abschnitt Git-Zusammenfassung auf der Seite Branch-Verwaltung der Projekteinstellungen nachsehen:

  • Bei Projekten, die mit dem erweiterten Bereitstellungsmodus konfiguriert sind, ist die Produktionsversion ein Commit oder Tag, der von einem Looker-Entwickler mit der Berechtigung deploy in der Bereitstellungsverwaltung 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 für 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 für 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.