Continuous Integration-Suites ausführen

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

Sobald die Validierungstests abgeschlossen sind, können Sie die Ergebnisse wie auf der Dokumentationsseite Ergebnisse der Ausführung der kontinuierlichen Integration ansehen beschrieben prüfen.

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 einen Validierungslauf aus, wenn ein Looker-Entwickler einen Pull-Request an Ihr LookML-Repository sendet. Optional können Sie angeben, dass automatische CI-Ausführungen nur durch Pull-Anfragen an bestimmte Branches in Ihrem Repository ausgelöst werden 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 Repositories zurück.

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

Manuelle Ausführung einer neuen CI-Suite

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 Durchlauf 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 gewünschte CI-Suite 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 Workspace den Branch aus, den Sie validieren möchten. Weitere Informationen finden Sie im Abschnitt Workspace.

    • Klicken Sie auf Produktion, um die Produktionsversion Ihres LookML-Projekts zu validieren.
    • 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, 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 Ausführung abgeschlossen ist.

Nachdem Sie einen Lauf ausgelöst haben, wird in der Looker IDE die Seite Ausführen für die ausgelöste Suite angezeigt. Sobald die Validierungstests abgeschlossen sind, werden auf der Seite Ausführen die Ergebnisse für jeden der Validator angezeigt. Sie können die Seite Ausführen verlassen, während die Validierungstests ausgeführt werden, und später wieder 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-Ausführungen ansehen.

Arbeitsbereich

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

Wenn Sie wissen möchten, welcher Branch oder Commit für die Produktionsversion verwendet wird, können Sie in der Looker-IDE im Feld Default Production Branch (Standard-Produktionszweig) im Bereich Git Summary (Git-Zusammenfassung) auf der Seite Branch Management (Zweigverwaltung) der Project Settings (Projekteinstellungen) nachsehen:

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

Beachten Sie bei der Option Entwicklungsmodus Folgendes, wenn Sie Entwicklungszweige in Ihrem Projekt validieren:

Vorherigen CI-Lauf manuell noch einmal ausführen

Bei abgeschlossenen Ausführungen (ob erfolgreich, fehlgeschlagen, mit Fehler oder abgebrochen) kann ein Looker-Nutzer mit der Berechtigung see_ci die Ausführung des CI-Laufs manuell über die Looker-IDE wiederholen:

  • Wenn Sie einen PR-ausgelösten Durchlauf noch einmal ausführen, wird Continuous Integration mit demselben Commit ausgeführt wie bei der ursprünglichen Ausführung.
  • Wenn Sie einen manuell ausgelösten Durchlauf noch einmal ausführen, wird die kontinuierliche Integration zum Zeitpunkt des erneuten Durchlaufs auf den Produktionsstatus oder den HEAD des Branches angewendet. Dazu gehören alle nachfolgenden Commits, die seit dem ersten CI-Durchlauf vorgenommen wurden.

Wenn Sie die CI-Suite seit dem ersten Durchlauf bearbeitet haben, werden bei einem erneuten Durchlauf alle Änderungen berücksichtigt, die Sie seit dem ersten Durchlauf 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 auf die Schaltfläche Ausführung ansehen für die CI-Ausführung, die Sie abbrechen möchten.
  4. Klicken Sie auf der Seite mit den Ergebnissen der ausgewählten Ausführung oben auf die Schaltfläche Wiederholen.

Wenn Sie auf Noch einmal ausführen klicken, wird der Inhaltsvalidierer gestartet und Sie werden zur Seite Ausführen für den neuen Durchlauf 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 einen laufenden CI-Lauf abbrechen möchten, können Sie dies auf der Seite Ausführen 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 auf die Schaltfläche Ausführung ansehen für die CI-Ausführung, die Sie abbrechen möchten.
  4. Klicken Sie auf der Seite Ausführen für die ausgewählte Ausführung oben auf die Schaltfläche Abbrechen.

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