Einstellungen für die Projektversionsverwaltung konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Elemente Ihres Projekts so konfigurieren, dass sie zur Versionsverwaltung in Git integriert werden können.

Projekteinstellungen

Sie müssen Looker-Administrator sein, um die Optionen auf der Seite Projekteinstellungen zu ändern. Looker-Entwickler, die keine Administratoren sind, können die Seite Projekteinstellungen aufrufen, aber die Optionen dort nicht ändern.

Auf der Seite Projekteinstellungen finden Sie Konfigurationsoptionen für Ihr Projekt. Um diese Seite aufzurufen, öffnen Sie Ihr Projekt und wählen Sie im Symbolmenü der Looker IDE das Symbol Einstellungen aus.

Von hier aus haben Sie Zugriff auf drei Bereiche:

Konfiguration

Auf dem Tab Konfiguration der Seite Projekteinstellungen können Sie die folgenden Einstellungen konfigurieren:

  • Name: Der Name Ihres Projekts. Sie können das Projekt umbenennen, indem Sie den Text bearbeiten und auf die Schaltfläche Projektkonfiguration speichern klicken. Weitere Informationen finden Sie auf der Dokumentationsseite Projektinformationen aufrufen und bearbeiten.

  • Git-Produktionszweigname: Geben Sie den Git-Zweignamen an, der als Zusammenführungsziel für Entwicklungszweige in Ihrem Projekt verwendet werden soll. Der Git-Zweig muss in Ihrem Git-Repository vorhanden sein. Weitere Informationen finden Sie im Abschnitt Name des Git-Produkts im Produktionszweig auf dieser Seite.

  • Codequalität: Legt fest, ob Entwickler den LookML Validator für das Projekt ausführen müssen, bevor sie Änderungen am Projekt übernehmen. Für Codequalität gibt es folgende Optionen:

    • Beheben von Fehlern und Warnungen vor dem Commit erforderlich: Looker-Entwickler können nur dann einen Commit für Änderungen durchführen, wenn Sie den LookML-Validator erfolgreich ausgeführt und alle Fehler und Warnungen behoben haben. Dabei handelt es sich um die empfohlene Einstellung.
    • Fehler nur vor Commit beheben: Looker-Entwickler können nur dann Änderungen vornehmen, wenn sie den LookML-Validator erfolgreich ausgeführt und alle Fehler behoben haben. Entwickler können Commits für Änderungen durchführen, wenn Warnungen vorhanden sind. Diese Option wird zwar nicht empfohlen, kann aber nützlich sein, z. B. wenn nach einem Looker-Update neue Warnungen für das Funktionieren von LookML eingeführt werden.
    • Commit von fehlerhaftem Code zulassen: Looker-Entwickler können Commits für Änderungen durchführen, ohne den LookML Validator auszuführen. Dabei spielt es keine Rolle, ob Fehler oder Warnungen in LookML vorhanden sind. Diese Option wird nicht empfohlen, da LookML dazu führen kann, dass sie nicht funktioniert oder fehlerhafte Ergebnisse liefert.

  • Datentests müssen bestanden werden, bevor dieses Projekt in der Produktion bereitgestellt wird: Wenn das LookML-Projekt einen oder mehrere test-Parameter hat, müssen Entwickler bei dieser Option die Datentests ausführen, bevor sie Änderungen vornehmen. Wenn die Datentests erfolgreich sind, ermöglicht die IDE dem Entwickler, Änderungen in der Produktion bereitzustellen. Informationen zum Einrichten von Datentests in Ihrem LookML-Projekt finden Sie auf der Dokumentationsseite zum Parameter test. Informationen zum Ausführen von Datentests in Ihrem Projekt finden Sie auf der Dokumentationsseite Versionsverwaltung verwenden und bereitstellen. Standardmäßig ist die Option Für neue LookML-Projekte müssen Datentests bestanden werden, bevor dieses Projekt in der Produktion bereitgestellt wird aktiviert.

  • Git Integration (Git-Integration): Gibt die Integrationsstufen Ihres Git-Anbieters an. Weitere Informationen finden Sie unter Optionen für die Git-Integration.

  • Erweiterten Bereitstellungsmodus aktivieren: Wenn diese Einstellung aktiviert ist, können Nutzer beliebige SHA-Werte, Tags und Zweige für die Produktion bereitstellen. Weitere Informationen zur Verwendung der Versionsverwaltung bei aktiviertem erweiterten Bereitstellungsmodus finden Sie auf der Seite Erweiterter Bereitstellungsmodus.

  • Webhook-Bereitstellungs-Secret: Richtet die Authentifizierung zum Bereitstellen von Produktionsänderungen auf Ihrer Looker-Instanz ein. Weitere Informationen finden Sie auf der Dokumentationsseite Webhook-Bereitstellungs-Secret konfigurieren.

  • Reset Git Connection (Git-Verbindung zurücksetzen): Mit dieser Schaltfläche wird das Fenster Configure Git (Git konfigurieren) geöffnet. Hier können Sie die Verbindungseinstellungen für Ihr Git-Repository aktualisieren.

    Durch das Zurücksetzen Ihrer Git-Verbindung wird der Git-Verlauf für den Hauptzweig beibehalten. Außerdem wird der Verlauf des persönlichen Zweigs jedes Looker-Entwicklers beibehalten, sobald dieser seinen Dev-Modus synchronisiert hat. Informationen zum Beibehalten des Verlaufs für alle Zweige finden Sie auf der Seite Zu einem neuen Git-Repository migrieren.

  • Projekt löschen: Mit dieser Schaltfläche wird das Projekt gelöscht. Dadurch wird der gesamte LookML-Code aus dem Projekt in allen Entwicklungs- und Produktionsumgebungen Ihrer Looker-Instanz entfernt.

  • Git-Zusammenfassung: In diesem Abschnitt werden die Git-Konfiguration des Projekts und die Git-Branch-Informationen des aktuellen Nutzers angezeigt.

Name des Git-Produktionszweigs

Mit der standardmäßigen Looker-Git-Integration führen alle Looker-Entwickler ihre Änderungen in einem Zweig namens main zusammen. Im Feld Name des Git-Produktionszweigs können Sie angeben, welcher Zweig Ihres Git-Repositorys von Looker als Zielzweig verwendet werden soll, mit dem die Zweige Ihrer Looker-Entwickler zusammengeführt werden. Auf der Dokumentationsseite Versionsverwaltung und Bereitstellung verwenden finden Sie den Standard-Git-Workflow und weitere Optionen für erweiterte Git-Implementierungen.

Bei vorhandenen Projekten sollten Sie Folgendes tun, bevor Sie den Namen des Git-Produktionszweigs ändern:

  • Bitten Sie alle Entwickler im Looker-Projekt, ihre Änderungen zu übernehmen und ihre Zweige mit der vorhandenen Produktions-Verzweigung zusammenzuführen. Pausieren Sie dann ihre Arbeit, bis der Git-Produktionszweigname aktualisiert und in der Looker-Projektkonfiguration gespeichert wurde.
  • Wenn Ihr Projekt integrierte Pull-Anfragen verwendet, schließen Sie alle offenen Pull-Anfragen ab und führen Sie sie nach Bedarf zusammen.
  • Führen Sie alle erforderlichen Vorbereitungen auf der Seite des Git-Anbieters durch, z. B. Erstellen eines neuen Zweigs in Ihrem Repository, Umbenennen des vorhandenen Standard-Git-Zweigs oder andere Aktionen, die möglicherweise erforderlich sind, um den Zweig vorzubereiten, damit Looker ihn als Zielzweig für die Zusammenführung verwenden kann. Sie müssen zumindest bestätigen, dass der Branch, den Sie verwenden möchten, ein vorhandener Branch in Ihrem Git-Repository ist.

So ändern Sie den Git-Zweig, den Ihr Projekt als Zusammenführungsziel für Entwicklungszweige verwendet:

  1. Wählen Sie im Symbolmenü der Looker IDE das Symbol Settings (Einstellungen) aus, um die Seite Project Settings (Projekteinstellungen) aufzurufen. Der Tab Konfiguration wird standardmäßig geöffnet.
  2. Geben Sie im Feld Name des Git-Produktionszweigs den Namen des Git-Zweigs ein, den Sie als Produktionszweig für Ihr Looker-Projekt verwenden möchten.
  3. Klicken Sie auf die Schaltfläche Save Project Configuration (Projektkonfiguration speichern), um die Änderung zu speichern.

Anmeldedaten importieren

Im Abschnitt Anmeldedaten importieren können Sie Anmeldedaten für die Authentifizierung für private Remote-Repositories verwalten. Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren .

Zweigverwaltung

Auf dem Tab Branch Management der Seite Projects Settings (Projekteinstellungen) werden alle mit dem Projekt verknüpften Git-Zweige angezeigt. Weitere Informationen finden Sie auf der Dokumentationsseite Versionsverwaltung verwenden und bereitstellen.

Git-Integrationsoptionen

Sobald Sie Ihre Git-Verbindung eingerichtet haben, verwendet Looker Ihren Git-Anbieter zum Verwalten Ihrer LookML-Quelldateien, wie auf der Dokumentationsseite Versionsverwaltung und Bereitstellung verwenden beschrieben.

Als Looker-Administrator können Sie zusätzliche Optionen für die Looker-Integration in Git konfigurieren. Dazu wählen Sie auf der Seite Projekteinstellungen auf dem Tab Konfiguration die Optionen für die Git-Integration aus:

  • Aus: In Looker werden keine externen Links zur Benutzeroberfläche Ihres Git-Anbieters angezeigt.
  • Links anzeigen: Looker stellt externe Links zur Oberfläche Ihres Git-Anbieters bereit, damit Ihre Entwickler das Projekt auf der Benutzeroberfläche des Git-Anbieters ansehen können. Looker stellt außerdem Links für jede Projektdatei bereit, damit Ihre Entwickler den Dateiverlauf und die Git-Blame-Informationen auf der Benutzeroberfläche Ihres Git-Anbieters einsehen können. Informationen zu den Links finden Sie im Abschnitt Integration externer Links zu Ihrem Git-Anbieter.
  • Pull-Anfragen empfohlen: Zusätzlich zu externen Links zur Benutzeroberfläche Ihres Git-Anbieters bietet Looker Entwicklern die Möglichkeit, eine Pull-Anfrage zu senden, damit ein anderer Entwickler Änderungen genehmigen kann, bevor sie dem Projekt hinzugefügt werden. Wie Sie dies einrichten, erfahren Sie im Abschnitt Pull-Anfragen für Ihr Projekt integrieren.
  • Pull-Anfragen erforderlich: Dies entspricht Pull-Anfragen empfohlen, mit der Ausnahme, dass Ihre LookML-Entwickler eine Pull-Anfrage öffnen müssen, um Änderungen an dem Projekt zu senden. Wie Sie dies einrichten, erfahren Sie im Abschnitt Pull-Anfragen für Ihr Projekt integrieren.

Klicken Sie im Abschnitt Deployment (Bereitstellung) auf Save Project Configuration (Projektkonfiguration speichern), um die Einstellungen für die Git-Integration zu speichern.

Wenn Sie eine der zusätzlichen Git-Integrationsoptionen aktiviert haben (Links anzeigen, Pull-Anfragen empfohlen oder Pull-Anfragen erforderlich), stellt Looker externe Links zur Schnittstelle Ihres Git-Anbieters bereit. Über diese externen Links wird ein neuer Browsertab zur Website Ihres Git-Anbieters geöffnet.

Um diese externen Links anzeigen zu können, benötigen Ihre Entwickler ein Konto bei Ihrem Git-Anbieter und Zugriff auf das Git-Repository des Projekts.

Das Dreipunkt-Menü File Options (Dateioptionen) für jede LookML-Datei enthält Links zur Website Ihres Git-Anbieters, über die Sie die Datei, die Git-Blame-Informationen für die Datei und den Commit-Verlauf für die Datei aufrufen können.

Im Bereich Git Actions können Sie auch die Option View Project on <Git provider> (Projekt anzeigen auf) verwenden, um Ihre Projektdateien auf der Website Ihres Git-Anbieters zu öffnen.

Pull-Anfragen für Ihr Projekt einbinden

Mit der standardmäßigen Looker-Git-Integration übernehmen Looker-Entwickler ihre Änderungen auf ihren Entwicklungszweig und führen dann ihre Entwicklungszweige mit der Produktions-Verzweigung zusammen. Bei der Bereitstellung in der Looker-Umgebung verwendet Looker dann das neueste Commit im Produktionszweig. Auf der Dokumentationsseite Versionsverwaltung und Bereitstellung verwenden finden Sie den Standard-Git-Workflow und weitere Optionen für erweiterte Git-Implementierungen.

Anstatt Looker-Entwicklern zu erlauben, ihren Entwicklungszweig mit der Looker-Produktionsbranche zusammenzuführen, können Sie Ihr Projekt mit der Option Pull-Anfragen empfohlen oder Pull-Anfragen erforderlich einrichten:

  • Pull-Anfragen empfohlen: Nachdem ein Entwickler Änderungen an seinem Entwicklungszweig vorgenommen hat, wird er über die Git-Schaltfläche in der Looker-IDE aufgefordert, eine Pull-Anfrage zu öffnen, um den Entwicklungszweig mit dem Produktionszweig zusammenzuführen. Der Entwickler kann dann eine Pull-Anfrage für andere Looker-Entwickler zur Überprüfung und Genehmigung über die Weboberfläche des Git-Anbieters erstellen. Alternativ kann der Entwickler die Option Deploy to Production (In Produktion bereitstellen) im Bereich Git Actions (Git-Aktionen) verwenden, um das Erstellen einer Pull-Anfrage zu überspringen und die Änderungen in der Produktion bereitzustellen. Die Option Deploy to Production (In Produktion bereitstellen) ist nicht verfügbar, wenn für das Projekt der erweiterte Bereitstellungsmodus aktiviert ist.
  • Pull-Anfragen erforderlich: Nachdem ein Entwickler Änderungen an seinem Entwicklungszweig vorgenommen hat, wird er über die Git-Schaltfläche in der Looker-IDE aufgefordert, eine Pull-Anfrage zu öffnen. Der Entwickler muss eine Pull-Anfrage öffnen, um seinen Entwicklungszweig mit dem Produktionszweig zusammenzuführen. Anschließend können andere Looker-Entwickler die Pull-Anfrage von der Weboberfläche des Git-Anbieters aus prüfen und genehmigen.

Looker unterstützt die Pull-Anfrageintegration für die folgenden Git-Anbieter:

  • GitHub
  • GitLab
  • Bitbucket Cloud
  • Bitbucket Server (früher „Stash“)

Im Folgenden finden Sie einige zusätzliche Hinweise zur Verwendung von Pull-Anfragen mit Looker:

  • Zum Öffnen von Pull-Anfragen müssen Ihre Entwickler ein Konto bei Ihrem Git-Anbieter und Zugriff auf das Git-Repository des Projekts haben.

  • Wenn die Funktion IP-Zulassungsliste für Ihre Instanz aktiviert ist, müssen Sie den Bereich der IP-Adressen, von denen Ihr Git-Anbieter ausgehende Anfragen sendet, der Zulassungsliste hinzufügen, um Pull-Anfragen in LookML-Projekte einzubinden. Aktuelle GitHub-IP-Adressen sind beispielsweise im GitHub-Änderungsprotokoll aufgeführt. Die IP-Adressen können sich ändern und unterscheiden sich bei anderen Git-Anbietern.

  • Wenn Sie den erweiterten Bereitstellungsmodus aktiviert haben, müssen Sie im Abschnitt Eigenes Projekt mit integrierten Pull-Anfragen einrichten keinen Webhook konfigurieren, da der erweiterte Bereitstellungsmodus die Zusammenführungs- und Bereitstellungsfunktionen trennt.

  • Wenn ein Looker-Entwickler eine Pull-Anfrage gestellt hat, die Sie rückgängig machen möchten, finden Sie weitere Informationen im Communitybeitrag Pull-Anfragen von Looker über GitHub zurücksetzen.

  • Mit Git-Pull-Anfragen können Sie eine Staging-Instanz für Looker verwenden, sodass Sie eine Staging-Instanz und eine Produktionsinstanz mit aktivierten Pull-Anfragen für die Staging-Instanz haben. Die gesamte Entwicklung und Codeüberprüfung kann in der Staging-Umgebung durchgeführt werden. Der überprüfte Code kann dann auf der Produktionsinstanz bereitgestellt werden. Informationen zur Einrichtung finden Sie im Communitybeitrag Git Workflow Using One Repository Across Multiple Instances – Development, Staging, and Production.

  • Looker führt Änderungen aus einem Looker-Entwicklerzweig mithilfe der Zusammenführungsmethode Merge Commit mit dem Produktionszweig zusammen. Achten Sie bei Verwendung der Benutzeroberfläche Ihres Git-Anbieters darauf, dass Ihre Entwickler weder die Squash-Zusammenführung noch die Rebase-Zusammenführung verwenden. Weitere Informationen finden Sie im Abschnitt Merge Options in the Git Provider's Interface (Zusammenführungsoptionen in der Benutzeroberfläche des Git-Anbieters).

Projekt mit integrierten Pull-Anfragen einrichten

So richten Sie Ihr Looker-Projekt mit Git-Pull-Anfragen ein:

  1. Wählen Sie in Ihrem Projekt im Symbolmenü der Looker IDE die Option Project Settings (Projekteinstellungen) aus.
  2. Wählen Sie auf dem Tab Konfiguration im Abschnitt Git-Integration die Option Pull-Anfragen empfohlen oder Pull-Anfragen erforderlich aus.
  3. Wenn Sie einen Webhook zur automatischen Bereitstellung auf der Benutzeroberfläche Ihres Git-Anbieters einrichten möchten, können Sie optional die Webhook-Informationen kopieren und in eine Textdatei einfügen. Wenn Ihr Projekt für die Verwendung des erweiterten Bereitstellungsmodus konfiguriert ist, können Sie diesen Schritt überspringen. Sie können sich auch später entscheiden und zu den Projekteinstellungen zurückkehren, um die Webhook-Informationen abzurufen.
  4. Optional können Sie ein Webhook-Bereitstellungs-Secret einrichten, um einen automatischen Bereitstellungs-Webhook von Ihrem Git-Anbieter oder einen Webhook im erweiterten Bereitstellungsmodus zu authentifizieren. Klicken Sie zum Erstellen eines Webhook-Secrets auf Set Webhook Secret (Webhook-Secret festlegen). Kopieren Sie das Bereitstellungs-Secret und fügen Sie es in eine Textdatei ein, um es beim Hinzufügen des Webhooks zur Schnittstelle Ihres Git-Anbieters zu verwenden. Sie können sich auch später entscheiden und zu den Projekteinstellungen zurückkehren, um ein Bereitstellungs-Secret hinzuzufügen. Weitere Informationen finden Sie auf der Dokumentationsseite Webhook-Bereitstellungs-Secret konfigurieren.
  5. Klicken Sie auf Projektkonfiguration speichern.

Wenn jetzt ein Looker-Entwickler Änderungen an Ihrem Projekt vornimmt, wird in der Looker IDE die Schaltfläche Open Pull Request (Pull-Anfrage öffnen) angezeigt. Über die Schaltfläche wird ein neuer Browsertab geöffnet, der direkt zur neuen Pull-Anfrageseite auf der Website Ihres Git-Anbieters führt.

Nachdem Sie Ihr Looker-Projekt für die Verwendung von Pull-Anfragen eingerichtet haben, führen Sie einen der folgenden Schritte aus, um festzulegen, wie Commits in Ihrer Produktionsumgebung bereitgestellt werden:

  • Um die neuesten Commits, die in Ihrem Produktionszweig zusammengeführt wurden, automatisch bereitzustellen, verwenden Sie die Schnittstelle Ihres Git-Anbieters, um einen Webhook hinzuzufügen, wie im nächsten Abschnitt auf dieser Seite beschrieben.
  • Wenn Sie manuell angeben möchten, welche Branches oder Commits bereitgestellt werden, aktivieren Sie den erweiterten Bereitstellungsmodus. Informationen zum Aktivieren und Verwalten des erweiterten Bereitstellungsmodus finden Sie auf der Seite Erweiterter Bereitstellungsmodus.

Webhook zu Ihrem Git-Anbieter hinzufügen

Für Looker-Projekte, die für Pull-Anfragen aktiviert sind, können Sie einen Bereitstellungs-Webhook auf der Benutzeroberfläche Ihres Git-Anbieters einrichten. Dieser Webhook löst Looker zur Bereitstellung des neuesten Commits aus dem Produktionszweig aus, wenn Sie eine Pull-Anfrage auf der Benutzeroberfläche des Git-Anbieters zusammenführen.

In den meisten Fällen sollten Sie keinen Webhook für die automatische Bereitstellung einrichten, wenn Ihr Projekt für die Verwendung des erweiterten Bereitstellungsmodus konfiguriert ist. Im erweiterten Bereitstellungsmodus können Sie den Commit und den Zweig auswählen, den Sie bereitstellen möchten. Das Einrichten eines Webhooks zur automatischen Bereitstellung würde also in den meisten Fällen die Funktionen des erweiterten Bereitstellungsmodus auf null setzen.

Wenn Sie auf der Benutzeroberfläche Ihres Git-Anbieters einen Webhook zur automatischen Bereitstellung hinzufügen möchten, rufen Sie zuerst die Projekteinstellungen in Looker auf. Klicken Sie dazu im Looker IDE-Symbolmenü des Projekts auf das Symbol Settings (Einstellungen). Kopieren Sie als Nächstes den Webhook aus dem Abschnitt Git-Integration.

Der Webhook hat das Format <instance_url>/webhooks/projects/<project_name>/deploy.

Ersetzen Sie <instance_url> durch die URL für Ihre Looker-Instanz. Wenn die Looker-Instanz-URL beispielsweise example.looker.com und der Projektname e_faa lautet, sieht der Webhook so aus:

https://example.looker.com/webhooks/projects/e_faa/deploy

Über die Looker-Projekteinstellungen können Sie auch ein Webhook-Bereitstellungs-Secret abrufen, um die Git-Integrationen Ihres Projekts bei Ihrem Git-Anbieter zu authentifizieren. Weitere Informationen finden Sie auf der Dokumentationsseite Webhook-Bereitstellungs-Secret konfigurieren.

Sobald Sie die Webhook-URL und das Bereitstellungs-Webhook-Secret haben, können Sie diese in die Schnittstelle Ihres Git-Anbieters eingeben. Wenn Ihr Git-Anbieter GitHub ist, gehen Sie so vor:

  1. Gehen Sie in Ihrem GitHub-Repository zu den Repository-Einstellungen Ihres Projekts.
  2. Klicken Sie in den Einstellungen Ihres Repositorys auf Webhooks. Klicken Sie auf Add Webhook (Webhook hinzufügen), um das Fenster Add Webhook (Webhook hinzufügen) zu öffnen.
  3. Fügen Sie in das Feld Payload URL (Nutzlast-URL) die Webhook-Informationen ein, die Sie in Looker aus dem Abschnitt Git-Integration kopiert haben.
  4. Optional können Sie ein Secret für die Webhook-Bereitstellung hinzufügen, mit dem die Git-Integrationen Ihres Projekts bei Ihrem Git-Anbieter authentifiziert werden. Kopieren Sie das Bereitstellungs-Secret aus den Projekteinstellungen Ihres LookML-Projekts und fügen Sie es in das Feld Secret auf der Schnittstelle des Git-Anbieters ein. Weitere Informationen finden Sie auf der Dokumentationsseite Webhook-Bereitstellungs-Secret konfigurieren.
  5. Wählen Sie im Feld Welche Ereignisse möchten diesen Webhook auslösen? die Option Nur das Push-Ereignis aus.
  6. Klicken Sie auf Add webhook (Webhook hinzufügen).

Webhook bereitstellen, um Daten aus einem Remote-Git-Repository abzurufen

Wenn Pull-Anfragen für Ihr LookML-Projekt aktiviert sind und Webhooks nicht automatisiert bereitgestellt werden, kann es vorkommen, dass der im Looker-Produktionsmodus angezeigte LookML-Code nicht mit dem LookML-Code im Hauptzweig Ihres Git-Repositorys übereinstimmt. Dies kann in folgenden Situationen auftreten:

  • Wenn Pull-Anfragen für das Repository aktiviert sind
  • Wenn der LookML-Code außerhalb der Looker-Entwicklungsumgebung bearbeitet wurde, z. B.:
    • Im Git-Repository selbst
    • Auf einer anderen Looker-Instanz, z. B. einer Staging-Instanz

Sie können den Looker-Produktionszweig mit dem Hauptzweig des Repositorys synchronisieren, indem Sie einen Bereitstellungs-Webhook verwenden:

  1. Öffnen Sie einen neuen Browsertab und geben Sie die folgende URL ein. Ersetzen Sie dabei <instance_url> durch die URL Ihrer Looker-Instanz und <project_name> durch den Namen Ihres LookML-Projekts:

    <instance_url>/webhooks/projects/<project name>/deploy

  2. Nachdem Sie die Webhook-URL zum Bereitstellen ausgeführt haben, wird auf einer leeren Webseite eine Erfolgsmeldung angezeigt, die der folgenden ähnelt:

    {"operations":[{"error":false,"error_code":0,"command":"Checkout Branch #\u003cLooker::GitBranch:0x5798672b\u003e","node_id":728,"results":["Success"]},{"error":false,"error_code":0,"command":"jgit revert_repo","node_id":728,"results":["Success"]}],"new_head":"05f772af48709fc2799fefe408e3fdd895a63284","old_head":"77412cad9fd7ed3eed1627afa201fdf7dcb97dd1"}

Ihr Produktionsmodus in Looker wurde aktualisiert und spiegelt jetzt Ihren Remote-Git-Hauptzweig wider. Ihr persönlicher Entwicklerzweig und freigegebene Zweige sind nicht betroffen.

Aus einem Remote-Git-Repository für Webhooks mit Bereitstellungs-Secrets abrufen

Wenn Ihr LookML-Projekt auch ein Webhook-Bereitstellungs-Secret zum Übertragen von Änderungen von Ihrem Hauptzweig in Ihren Produktionszweig erfordert, erhalten Sie einen der folgenden Fehler, wenn Sie den Produktionszweig mit dem Hauptzweig des Repositorys synchronisieren. Dazu verwenden Sie die im vorherigen Abschnitt Bereitstellungs-Webhook zum Abrufen aus einem Remote-Git-Repository verwenden:

{"error":"Uh oh! Something went wrong."}

oder:

{"error":"Not found."}

Anstatt den Bereitstellungs-Webhook zu verwenden, können Sie den folgenden cURL-Befehl in Ihrem Terminal mit dem Webhook-Secret ausführen. Die folgenden Felder müssen ersetzt werden:

  • Ersetzen Sie <instance_URL> durch die URL Ihrer Looker-Instanz.
  • Ersetzen Sie <deploy_secret> durch das Bereitstellungs-Secret Ihres Projekts.
  • Ersetzen Sie <project_name> durch den Namen Ihres LookML-Projekts.
curl -i -X POST -H "X-Looker-Deploy-Secret:<deploy_secret>" https://<instance_url>/webhooks/projects/<project_name>/deploy

Wenn Sie beispielsweise einen Produktionszweig für das ecommerce_project in der Brettcase-Instanz mit dem Hauptzweig des Repositorys synchronisieren:

curl -i -X POST -H "X-Looker-Deploy-Secret:123123123secretgoeshere123123123" https://brettcase.looker.com/webhooks/projects/ecommerce_project/deploy

Zusammenführungsoptionen auf der Benutzeroberfläche des Git-Anbieters

Wenn Ihr Looker-Projekt in Pull-Anfragen integriert ist, verwenden Ihre Entwickler die Benutzeroberfläche Ihres Git-Anbieters, um Pull-Anfragen zu senden und Änderungen im Produktionszweig zusammenzuführen.

Looker unterstützt die Methode Merge Commit, mit der Änderungen aus einem Entwicklungszweig in den Produktionszweig zusammengeführt werden. Auf der Benutzeroberfläche Ihres Git-Anbieters werden jedoch möglicherweise zusätzliche Optionen für die Zusammenführung angezeigt, z. B. Squash andmerge oder Rebase andmerge.

Die Squash-Zusammenführung oder die Rebase-Zusammenführung wird von Looker nicht unterstützt. Ihre Entwickler sollten diese Optionen daher nicht verwenden. Es empfiehlt sich, diese Optionen nach Möglichkeit für Ihr Repository zu deaktivieren. So deaktivieren Sie diese Optionen in einem GitHub-Repository:

  1. Gehen Sie zum Tab Settings (Einstellungen), um auf die Repository-Einstellungen Ihres Projekts auf GitHub zuzugreifen.

    TIPP: Für Projekte, die mit Git-Integration konfiguriert sind, können Sie die Option View Project on Git aus dem Git-Menü des Projekts in Looker verwenden.

  2. Klicken Sie in den Einstellungen des Repositorys im Navigationsmenü auf Optionen.

  3. Gehen Sie zum Abschnitt Schaltfläche „Zusammenführen“ und lassen Sie nur die Option Zusammenführungs-Commits zulassen aktiviert. Deaktivieren Sie die Optionen Allow Squash Merge und Allow rebase Merge.

Nachdem Sie die Zusammenführungsoptionen deaktiviert haben, sind sie in GitHub nicht mehr verfügbar, wenn Ihre Entwickler einen Zweig im Repository zusammenführen.