Einstellungen für die Versionsverwaltung des Projekts konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Elemente Ihres Projekts für die Einbindung in Git für die Versionsverwaltung konfigurieren.

Projekteinstellungen

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

Auf der Seite Projekteinstellungen finden Sie Konfigurationsoptionen für Ihr Projekt. Öffnen Sie Ihr Projekt und wählen Sie im Menü auf der linken Seite das Symbol Einstellungen aus, um diese Seite aufzurufen.

Von hier aus können Sie auf drei Abschnitte zugreifen:

Konfiguration

Auf der Seite Projekteinstellungen auf dem Tab Konfiguration 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.

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

  • Codequalität: Legt fest, ob Entwickler den LookML-Validator für das Projekt ausführen müssen, bevor sie Änderungen für das Projekt durchführen. Codequalität bietet folgende Optionen:

    • Fehler und Warnungen vor dem Commit beheben: Looker-Entwickler können erst dann Änderungen übernehmen, wenn der LookML-Validator erfolgreich ausgeführt und alle Fehler und Warnungen behoben wurden. Dabei handelt es sich um die empfohlene Einstellung.
    • Fehler müssen nur vor dem Commit behoben werden: Looker-Entwickler können erst dann Änderungen übernehmen, wenn der LookML Validator erfolgreich ausgeführt und alle Fehler behoben wurden. Entwickler können Änderungen übernehmen, wenn Warnungen vorhanden sind. Diese Option wird zwar nicht empfohlen, eignet sich aber z. B., wenn nach einem Looker-Update neue Warnungen für die Funktionsweise von LookML eingeführt werden.
    • Commit für fehlerhaften Code zulassen: Looker-Entwickler können Änderungen übernehmen, ohne den LookML-Validator auszuführen und unabhängig davon, ob Fehler oder Warnungen in LookML vorliegen. Diese Option wird nicht empfohlen, weil sie zu LookML führen kann, das nicht funktioniert oder fehlerhafte Ergebnisse liefert.

  • Datentests bestehen, bevor das Projekt in der Produktion bereitgestellt werden kann: Entwickler müssen Datentests durchführen, bevor sie Änderungen vornehmen können. Wenn die Datentests erfolgreich sind, können Entwickler in der IDE Änderungen in der Produktionsumgebung bereitstellen. Informationen zum Einrichten von Datentests in Ihrem LookML-Projekt finden Sie auf der Seite mit der Parameterdokumentation zu test. Informationen zum Ausführen von Datentests für Ihr Projekt finden Sie auf der Dokumentationsseite Versionsverwaltung und Bereitstellung verwenden.

  • Git-Integration: Gibt die Integrationsstufen für Ihren Git-Anbieter an. Weitere Informationen

  • Erweiterten Bereitstellungsmodus aktivieren: Mit dieser Einstellung können Nutzer jedes SHA, Tag oder einen Zweig in der Produktion bereitstellen. Weitere Informationen zur Verwendung der Versionsverwaltung mit aktiviertem erweitertem Bereitstellungsmodus finden Sie auf der Dokumentationsseite zum erweiterten Bereitstellungsmodus.

  • Webhook-Bereitstellungs-Secret: Richtet die Authentifizierung zum Bereitstellen von Änderungen für die Produktion auf Ihrer Looker-Instanz ein. Weitere Informationen finden Sie auf der Dokumentationsseite zum Konfigurieren des Webhook-Deployments.

  • Git-Verbindung zurücksetzen: Über diese Schaltfläche wird das Fenster Git konfigurieren geöffnet, in dem Sie die Verbindungseinstellungen für Ihr Git-Repository aktualisieren können.

    Wenn Sie Ihre Git-Verbindung zurücksetzen, wird der Git-Verlauf für den Master-Zweig beibehalten. Außerdem wird auch der Verlauf der einzelnen Zweige des Looker-Entwicklers gespeichert, sobald er seinen Entwicklermodus synchronisiert. Wenn Sie den Verlauf für alle Zweige beibehalten möchten, lesen Sie die Seite Migration zu einem neuen Git-Repository.

  • Projekt löschen: Mit dieser Schaltfläche wird das Projekt gelöscht. Es wird alle LookML-Daten aus dem Projekt in allen Entwicklungs- und Produktionsumgebungen auf der Looker-Instanz entfernt.

  • Git-Zusammenfassung: In diesem Abschnitt werden die Git-Konfigurationen des Projekts und die Git-Zweiginformationen 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 master zusammen. Sie können im Feld Git Production-Zweigname angeben, welcher Zweig aus Ihrem Git-Repository als Zielzweig verwendet werden soll. Dies wird als Zielzweig verwendet, mit dem die Looker-Entwicklerzweige zusammengeführt werden. Auf der Dokumentationsseite Versionsverwaltung und Bereitstellung finden Sie den Standardgit-Workflow und andere 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 des Looker-Projekts, ihre Änderungen zu übernehmen und ihre Zweige mit dem vorhandenen Produktionszweig zusammenzuführen. Anschließend können Sie ihre Arbeit pausieren, bis der Name des Git-Produktionszweigs aktualisiert und in der Looker-Projektkonfiguration gespeichert wird.
  • Wenn in Ihrem Projekt integrierte Pull-Anfragen verwendet werden, können Sie alle offenen Pull-Anfragen abschließen und zusammenführen.
  • Führen Sie alle erforderlichen Vorkehrungen auf der Seite des Git-Anbieters aus, z. B. das Erstellen eines neuen Zweigs in Ihrem Repository, das Umbenennen des vorhandenen Git-Standardzweigs oder alle Maßnahmen, die möglicherweise zum Vorbereiten des Zweigs erforderlich sind, damit Looker ihn als Zielzweig für das Zusammenführen verwenden kann. Sie müssen mindestens prüfen, ob der zu verwendende Zweig ein vorhandener Zweig in Ihrem Git-Repository ist.

So ändern Sie den Git-Zweig, der in Ihrem Projekt als Platzhalterziel für Entwicklungszweige verwendet wird:

  1. Wählen Sie im Menü auf der linken Seite das Symbol Einstellungen aus, um die Seite Projekteinstellungen aufzurufen. Der Tab Konfiguration wird standardmäßig geöffnet.
  2. Geben Sie im Feld Name der Zweigorganisation den Namen des Git-Zweigs ein, der als Produktionszweig für Ihr Looker-Projekt verwendet werden soll.
  3. Scrollen Sie nach unten und klicken Sie auf die Schaltfläche 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 Zweigverwaltung der Seite Projekteinstellungen sehen Sie alle mit dem Projekt verknüpften Git-Zweige. Weitere Informationen finden Sie auf der Dokumentationsseite Versionsverwaltung und Bereitstellung verwenden.

Integrationsoptionen für Git

Nachdem Sie Ihre Git-Verbindung eingerichtet haben, verwendet Looker Ihren Git-Anbieter, um Ihre LookML-Quelldateien zu verwalten, wie auf der Seite Versionsverwaltung und Bereitstellung verwenden beschrieben.

Als Looker-Administrator können Sie zusätzliche Optionen für die Integration von Looker in Git mithilfe der Optionen für die Git-Integration auf dem Tab Konfiguration der Seite Projekteinstellungen konfigurieren

  • Aus: Looker zeigt keine externen Links zur Benutzeroberfläche Ihres Git-Anbieters an.
  • Links anzeigen: Looker stellt externe Links zur Schnittstelle Ihres Git-Anbieters bereit, damit Ihre Entwickler das Projekt in der Benutzeroberfläche des Git-Anbieters sehen können. Außerdem bietet Looker Links für jede Projektdatei, damit Ihre Entwickler den Verlauf der Datei und die Git-Blame-Informationen auf der Benutzeroberfläche des Git-Anbieters einsehen können. Informationen zu den Links finden Sie im Abschnitt Externe Links zu Ihrem Git-Anbieter einbinden.
  • Pull-Anfragen empfohlen: Neben der Bereitstellung von externen Links zur Schnittstelle Ihres Git-Anbieters bietet Looker Entwicklern die Möglichkeit, eine Pull-Anfrage zu senden, damit ein anderer Entwickler Änderungen genehmigen kann, bevor er sie dem Projekt hinzufügt. Informationen zur Einrichtung finden Sie im Abschnitt Pull-Anfragen für Ihr Projekt einbinden.
  • Pull-Anfragen erforderlich: Das ist der gleiche wie oben, nur dass Ihre LookML-Entwickler eine Pull-Anfrage öffnen müssen, um Änderungen an dem Projekt zu senden. Informationen zur Einrichtung finden Sie im Abschnitt Pull-Anfragen für Ihr Projekt einbinden.

Scrollen Sie nach unten und klicken Sie im Abschnitt Deployment auf Projektkonfiguration speichern, um Ihre Git-Integrationseinstellungen 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 des Git-Anbieters geöffnet.

Damit diese externen Links aufgerufen werden können, müssen Ihre Entwickler ein Konto bei Ihrem Git-Anbieter haben und Zugriff auf das Git-Repository des Projekts haben.

Über das Dreipunkt-Menü Dateioptionen für jede Ihrer LookML-Dateien bietet Looker Links zur Website Ihres Git-Anbieters, um die Datei anzusehen, die Git-Blame-Informationen für die Datei und den Commit-Verlauf für die Datei anzusehen.

Im Bereich Git Actions (Git-Aktionen) können Sie die Option Projekt in <Git provider> ansehen verwenden, um Ihre Projektdateien auf der Website Ihres Git-Anbieters zu öffnen.

Pull-Anfragen für Ihr Projekt einbinden

Bei der standardmäßigen Looker-Git-Integration übernehmen Looker-Entwickler ihre Änderungen in ihren Entwicklungszweig und führen dann ihren Entwicklungszweig mit dem Produktionszweig zusammen. Bei der Bereitstellung in der Looker-Umgebung verwendet Looker dann den neuesten Commit für den Produktionszweig. Auf der Dokumentationsseite Versionsverwaltung und Bereitstellung finden Sie den Standardgit-Workflow und andere Optionen für erweiterte Git-Implementierungen.

Statt es den Looker-Entwicklern zu erlauben, ihren Entwicklungszweig mit dem Looker-Produktionszweig zusammenzuführen, können Sie Ihr Projekt entweder mit der Option Pull-Anfragen empfohlen oder der Pull-Anfrage erforderlich einrichten:

  • Pull-Anfragen empfohlen: Nachdem ein Entwickler Änderungen an seinem Entwicklungszweig vorgenommen hat, wird er durch die Git-Schaltfläche in der Looker-IDE aufgefordert, eine Pull-Anfrage zu öffnen, um seinen Entwicklungszweig mit dem Produktionszweig zusammenzuführen. Der Entwickler kann dann eine Pull-Anfrage für andere Looker-Entwickler öffnen, damit er sie über die Weboberfläche des Git-Anbieters prüfen und genehmigen kann. Alternativ kann der Entwickler die Option In Produktion bereitstellen im Bereich Git Actions verwenden, um das Erstellen einer Pull-Anfrage zu überspringen und die Änderungen in der Produktion bereitzustellen. Die Option In Produktion bereitstellen ist nicht verfügbar, wenn das Projekt im erweiterten Bereitstellungsmodus aktiviert ist.
  • Pull-Anfragen erforderlich: Nachdem ein Entwickler per Commit Änderungen an seinem Entwicklungszweig vorgenommen hat, wird er durch 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 über die Weboberfläche des Git-Anbieters 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“)

Hier 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 haben und Zugriff auf das Git-Repository des Projekts haben.

  • Wenn die Funktion IP-Zulassungsliste für Ihre Instanz aktiviert ist, müssen Sie den IP-Adressbereich von Ihrem Git-Anbieter hinzufügen, um ausgehende Anfragen an Looker zu senden, damit sie in LookML-Projekte eingebunden werden können. Aktuelle GitHub-IP-Adressen werden beispielsweise im GitHub-Änderungsprotokoll aufgeführt. IP-Adressen können sich ändern und sind für andere Git-Anbieter anders.

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

  • Wenn ein Looker-Entwickler eine Pull-Anfrage gesendet hat, die Sie wiederherstellen möchten, finden Sie weitere Informationen im Community-Beitrag Pull-Anfragen von Looker über GitHub zurücksetzen.

  • Mit Git-Pull-Anfragen können Sie eine Staging-Instanz für Looker verwenden. So haben Sie eine Staging-Instanz und eine Produktionsinstanz, wobei Pull-Anfragen auf der Staging-Instanz aktiviert sind. Die gesamte Entwicklungs- und Codeüberprüfung kann in der Staging-Umgebung durchgeführt und der überprüfte Code dann auf der Produktionsinstanz bereitgestellt werden. Weitere Informationen dazu finden Sie im Community-Beitrag Git Workflow Use One One Repository across Multiple Instanz – Development, Staging, and Production.

  • Looker führt Änderungen von einem Looker-Entwicklerzweig mit dem Merge-Commit im Produktionszweig zusammen. Wenn Sie die Benutzeroberfläche Ihres Git-Anbieters verwenden, achten Sie darauf, dass Ihre Entwickler weder Squash Merge noch Rebase Merge verwenden. Weitere Informationen finden Sie im Abschnitt Zusammenführungsoptionen auf 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 Menü auf der linken Seite 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 für die automatische Bereitstellung auf der Benutzeroberfläche des Git-Anbieters einrichten möchten, kopieren Sie die Webhook-Informationen und fügen Sie sie in eine Textdatei ein. Wenn Ihr Projekt für den erweiterten Bereitstellungsmodus konfiguriert ist, können Sie diesen Schritt überspringen. Sie können die Entscheidung auch später treffen 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 erweiterten Bereitstellungsmodus-Webhook zu authentifizieren. Klicken Sie auf Webhook-Secret festlegen, um ein Webhook-Secret zu erstellen. Kopieren Sie das Bereitstellungs-Secret und fügen Sie es in eine Textdatei ein, die Sie beim Hinzufügen des Webhooks zur Schnittstelle Ihres Git-Anbieters verwenden möchten. Sie können die Entscheidung auch später vornehmen und zu den Projekteinstellungen zurückkehren, um ein Bereitstellungs-Secret hinzuzufügen. Weitere Informationen finden Sie auf der Dokumentationsseite zum Konfigurieren des Webhook-Deployments.
  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 direkt zur neuen Pull-Anfrageseite auf der Website Ihres Git-Anbieters geöffnet.

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

  • Damit die neuesten Commits, die mit Ihrem Produktionszweig zusammengeführt werden, automatisch bereitgestellt werden, müssen Sie über die Schnittstelle Ihres Git-Anbieters einen Webhook hinzufügen, wie im nächsten Abschnitt auf dieser Seite beschrieben.
  • Aktivieren Sie den erweiterten Bereitstellungsmodus, um manuell anzugeben, welche Zweige oder Commits bereitgestellt werden. Informationen zum Aktivieren und Verwalten des erweiterten Bereitstellungsmodus finden Sie in der Dokumentation zum erweiterten Bereitstellungsmodus.

Webhook zum Git-Anbieter hinzufügen

Für Looker-Projekte, die für Pull-Anfragen aktiviert sind, können Sie einen Bereitstellungs-Webhook auf der Schnittstelle Ihres Git-Anbieters einrichten. Dieser Webhook löst Looker aus, um den neuesten Commit aus dem Produktionszweig bereitzustellen, wenn Sie eine Pull-Anfrage auf der Schnittstelle des Git-Anbieters zusammenführen.

In den meisten Fällen sollten Sie keinen automatischen Webhook für die 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. In den meisten Fällen werden durch das Einrichten eines automatischen Webhook-Webhooks die Funktionen des erweiterten Bereitstellungsmodus annulliert.

Wenn Sie auf der Benutzeroberfläche des Git-Anbieters einen automatischen Webhook für die Bereitstellung hinzufügen möchten, rufen Sie zuerst in Looker die Projekteinstellungen auf. Klicken Sie dazu im linken Projektmenü auf das Symbol „Einstellungen“. Kopieren Sie als Nächstes den Webhook-Abschnitt aus dem Abschnitt Git-Integration.

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

Ersetzen Sie <instance_url> durch die URL Ihrer Looker-Instanz. Wenn die URL Ihrer Looker-Instanz beispielsweise example.looker.com und der Projektname e_faa lautet, würde der Webhook so aussehen:

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 mit Ihrem Git-Anbieter zu authentifizieren. Weitere Informationen finden Sie auf der Dokumentationsseite zum Konfigurieren des Webhook-Deployments.

Sobald Sie die Webhook-URL und das Webhook-Secret bereitstellen, können Sie sie in der Benutzeroberfläche des Git-Anbieters eingeben. Wenn Ihr Git-Anbieter GitHub ist, gehen Sie so vor:

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

Bereitstellungs-Webhook zum Abrufen aus einem Remote-Git-Repository verwenden

Wenn Pull-Anfragen für Ihr LookML-Projekt aktiviert sind und Webhooks nicht automatisiert werden, kann es vorkommen, dass LookML, das im Produktionsmodus von Looker angezeigt wird, nicht mit der LookML im Master-Zweig Ihres Git-Repositorys übereinstimmt. Das kann in den folgenden Situationen passieren:

  • Wenn Pull-Anfragen für das Repository aktiviert sind
  • Wenn das LookML 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 Produktionszweig von Looker mithilfe eines Bereitstellungs-Webhooks mit dem Masterzweig des Repositorys synchronisieren:

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

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

  2. Nachdem Sie die Webhook-URL zum Bereitstellen bereitgestellt haben, wird auf einer leeren Webseite eine Erfolgsmeldung angezeigt, die in etwa so aussieht:

    {"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"}

Der Produktionsmodus in Looker wurde aktualisiert, sodass er Ihrem Remote-Git-Master-Zweig entspricht. Ihr persönlicher Entwicklerzweig und freigegebene Zweige sind davon nicht betroffen.

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

Wenn für Ihr LookML-Projekt auch ein Webhook-Bereitstellungs-Secret erforderlich ist, um Änderungen von Ihrem Master-Zweig an Ihren Produktionszweig zu übertragen, erhalten Sie einen der folgenden Fehler, wenn Sie den Produktionszweig mit dem Master-Zweig des Repositorys synchronisieren. Verwenden Sie dazu die im vorherigen Abschnitt beschriebene Methode zum Bereitstellen eines Webhooks, um einen Pull aus einem Remote-Git-Repository abzurufen:

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

oder:

{"error":"Not found."}

Anstatt den Webhook für die Bereitstellung zu verwenden, können Sie den folgenden cURL-Befehl mit dem Webhook-Secret in Ihrem Terminal ausführen. Ersetzen Sie die folgenden Felder:

  • Ersetzen Sie <instance_URL> durch die URL der 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

Gehen Sie z. B. so vor, wenn Sie einen Produktionszweig für die Instanz ecommerce_project auf der Instanz Brettcase mit dem Masterzweig des Repositorys synchronisieren möchten:

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

Optionen auf der Benutzeroberfläche des Git-Anbieters zusammenführen

Wenn Ihr Looker-Projekt in Pull-Anfragen eingebunden ist, verwenden Ihre Entwickler die Oberfläche des 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 und einem Produktionszweig zusammengeführt werden. Auf der Benutzeroberfläche Ihres Git-Anbieters werden möglicherweise zusätzliche Optionen zum Zusammenführen angezeigt, z. B. Squash and Merge oder Rebase andmerge.

Looker unterstützt nicht das Squash Merge oder das Zusammenführen von Basen. Daher sollten Ihre Entwickler diese Optionen vermeiden. Es empfiehlt sich, diese Optionen nach Möglichkeit für Ihr Repository zu deaktivieren. Führen Sie die folgenden Schritte aus, um diese Optionen in einem GitHub-Repository zu deaktivieren:

  1. Gehen Sie zum Tab 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 Projekt in Git aufrufen aus dem Git-Menü des Projekts in Looker verwenden.

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

  3. Scrollen Sie nach unten zum Abschnitt Zusammenführen und lassen Sie nur das Kästchen Zusammenführungen zulassen aktiviert. Deaktivieren Sie die Optionen Zusammenführung aus Squash zulassen und Zusammenführung in Basisbasis zulassen.

Wenn Sie das Häkchen bei diesen Optionen entfernen, sind sie nicht mehr verfügbar, wenn jemand einen Zweig im Repository zusammengeführt.

Git-Verbindung einrichten und testen

Secret für die Webhook-Bereitstellung konfigurieren