Einstellungen für die Projektversionsverwaltung konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Elemente Ihres Projekts für die Versionskontrolle mit Git konfigurieren.

Projekteinstellungen

Zum Aufrufen der Projekteinstellungen öffnen Sie Ihr Projekt und wählen dann im Symbolmenü der Looker IDE das Symbol Einstellungen aus.

Von hier aus haben Sie Zugriff auf drei Tabs für Projekteinstellungen:

Konfiguration

Auf dem Tab Konfiguration auf der Seite Projekteinstellungen wird die Seite Projektkonfiguration geöffnet. Auf der Seite Projektkonfiguration 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 Auf Projektinformationen zugreifen und sie 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 sind folgende Optionen verfügbar:

    • Beheben von Fehlern und Warnungen vor Commit verlangen: Looker-Entwickler können Änderungen erst committen, nachdem sie den LookML-Validator erfolgreich ausgeführt und alle Fehler und Warnungen behoben haben. Dabei handelt es sich um die empfohlene Einstellung.
    • Nur Beheben von Fehlern vor Commit verlangen: Looker-Entwickler können Änderungen erst committen, nachdem der LookML-Validator erfolgreich ausgeführt und alle Fehler behoben wurden. Entwickler können Commits für Änderungen durchführen, wenn Warnungen vorliegen. Diese Option wird nicht empfohlen, kann aber nützlich sein, z. B. wenn nach einem Looker-Update neue Warnungen in der LookML-Datei angezeigt werden.
    • Committing fehlerhaften Codes zulassen: Looker-Entwickler können Änderungen ohne Ausführen des LookML-Validators committen, unabhängig davon, ob in der LookML Fehler oder Warnungen vorhanden sind. Diese Option wird nicht empfohlen, da LookML dazu führen kann, dass sie nicht funktioniert oder fehlerhafte Ergebnisse erzeugt.

  • 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 bestanden werden, können die Entwickler die Änderungen über die IDE in der Produktion bereitstellen. 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 Seite Versionskontrolle und Bereitstellung verwenden. 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 jeden SHA, jedes Tag oder jeden Branch in der Produktion bereitstellen. Weitere Informationen zur Verwendung der Versionskontrolle mit aktiviertem erweiterten Bereitstellungsmodus finden Sie auf der Dokumentationsseite Erweiterter Bereitstellungsmodus.

  • Webhook-Bereitstellungs-Secret: Hiermit wird die Authentifizierung für das Bereitstellen von Änderungen in der Produktion in Ihrer Looker-Instanz eingerichtet. 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 Branches jedes Looker-Entwicklers beibehalten, sobald er seinen Entwicklungsmodus synchronisiert. Informationen zum Erhalt des Verlaufs für alle Branches finden Sie auf der Seite mit Best Practices zur Migration zu einem neuen Git-Repository.

  • Projekt löschen: Über diese Schaltfläche wird das Projekt gelöscht. Dadurch wird die gesamte LookML 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

Bei der standardmäßigen Looker-Git-Integration führen alle Looker-Entwickler ihre Änderungen in einem Hauptzweig namens master zusammen. Sie können im Feld Name des Git-Produktionszweigs angeben, welchen Zweig Ihres Git-Repositorys Looker als Zielzweig Ihres Looker-Entwicklers verwenden soll. Zweige zusammengeführt. Auf der Seite Versionskontrolle und Bereitstellung verwenden finden Sie den Standard-Git-Workflow und andere Optionen für erweiterte Git-Implementierungen.

Bei bestehenden 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, der in Ihrem Projekt als Zusammenführungsziel für Entwicklungszweige verwendet wird:

  1. Wählen Sie im Symbolmenü der Looker IDE das Symbol Einstellungen aus, um die 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 Bereich Anmeldedaten importieren können Sie Authentifizierungsanmeldedaten für private Remote-Repositories verwalten. Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren.

Zweigverwaltung

Auf dem Tab Branch-Verwaltung der Seite Projekteinstellungen sehen Sie alle mit dem Projekt verknüpften Git-Branches. Weitere Informationen finden Sie auf der Seite Versionskontrolle und Bereitstellung verwenden.

Git-Integrationsoptionen

Nachdem Sie Ihre Git-Verbindung eingerichtet haben, verwendet Looker Ihren Git-Anbieter zum Verwalten Ihrer LookML-Quelldateien, wie auf der Seite Versionskontrolle verwenden und bereitstellen beschrieben.

Als Looker-Administrator können Sie über die Optionen Git-Integration auf dem Tab Konfiguration im Bereich „Einstellungen“ des Projekts zusätzliche Optionen für die Looker-Integration mit Git konfigurieren:

  • Aus: In Looker werden keine externen Links zur Benutzeroberfläche Ihres Git-Anbieters angezeigt.
  • Links anzeigen: Looker stellt externe Links zur Benutzeroberfläche Ihres Git-Anbieters bereit, damit Ihre Entwickler das Projekt in der Benutzeroberfläche des Git-Anbieters aufrufen können. Looker stellt außerdem Links für jede Projektdatei bereit, damit Ihre Entwickler den Verlauf der Datei und 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: Neben externen Links zur Benutzeroberfläche Ihres Git-Anbieters bietet Looker Entwicklern die Möglichkeit, einen Pull-Request einzureichen, damit ein anderer Entwickler Änderungen genehmigen kann, bevor sie dem Projekt hinzugefügt werden. Informationen zur Einrichtung finden Sie im Abschnitt Pull-Requests in Ihr Projekt einbinden.
  • Pull-Requests erforderlich: Diese Option entspricht der Option Pull-Requests empfohlen, mit der Ausnahme, dass Ihre LookML-Entwickler einen Pull-Request öffnen müssen, um Änderungen am Projekt vorzunehmen. Wie Sie dies einrichten, erfahren Sie im Abschnitt Pull-Anfragen für Ihr Projekt integrieren.

Klicken Sie unter Bereitstellung auf 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 in einem neuen Browsertab die Website Ihres Git-Anbieters geöffnet.

Damit Ihre Entwickler diese externen Links sehen können, benötigen sie 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-Aktionen können Sie auch die Option Projekt auf <Git provider> ansehen verwenden, um Ihre Projektdateien auf der Website Ihres Git-Anbieters zu öffnen.

Pull-Requests in Ihr Projekt einbinden

Bei der standardmäßigen Looker-Git-Integration committen Looker-Entwickler ihre Änderungen in ihrem Entwicklungszweig und führen ihn dann mit dem Produktionszweig zusammen. Wenn Sie dann in der Looker-Umgebung bereitstellen, verwendet Looker das neueste Commit im Produktions-Branch. Auf der Seite Versionskontrolle und Bereitstellung verwenden finden Sie den Standard-Git-Workflow und andere 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 committet hat, wird er über 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 zur Überprüfung und Genehmigung über die Weboberfläche des Git-Anbieters erstellen. Alternativ kann der Entwickler die Option In Produktion bereitstellen im Bereich Git-Aktionen verwenden, um das Erstellen einer Pull-Anfrage zu überspringen und seine Ä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. Andere Looker-Entwickler können dann die Pull-Anfrage über die Weboberfläche des Git-Anbieters prüfen und genehmigen.

Looker unterstützt die Pull-Anfrage-Integration 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:

  • Damit Ihre Entwickler Pull-Anfragen öffnen können, benötigen sie ein Konto bei Ihrem Git-Anbieter und Zugriff auf das Git-Repository des Projekts.

  • 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 zu integrieren. Aktuelle GitHub-IP-Adressen sind beispielsweise im GitHub-Changelog aufgeführt. IP-Adressen können sich ändern und sind für andere Git-Anbieter unterschiedlich.

  • 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 die 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. So haben Sie eine Staging-Instanz und eine Produktionsinstanz, wobei Pull-Anfragen in der Staging-Instanz aktiviert sind. 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.

  • In Looker werden Änderungen aus einem Looker-Entwicklerzweig mithilfe der Zusammenführungsmethode Merge Commit in den Produktionszweig zusammengeführt. Achten Sie darauf, dass Ihre Entwickler bei der Verwendung der Benutzeroberfläche Ihres Git-Anbieters weder Squash-Merges noch Rebase-Merges verwenden. Weitere Informationen finden Sie im Abschnitt Merge-Optionen 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 Settings (Einstellungen) 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 für den erweiterten Bereitstellungsmodus zu authentifizieren. Klicken Sie zum Erstellen eines Webhook-Secrets auf Set Webhook Secret (Webhook-Secret festlegen). Kopieren Sie das Deploy-Secret und fügen Sie es in eine Textdatei ein, die Sie verwenden, wenn Sie den Webhook der Benutzeroberfläche Ihres Git-Anbieters hinzufügen. 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 Dokumentationsseite Erweiterter Bereitstellungsmodus.

Ihrem Git-Anbieter einen Webhook hinzufügen

Für Looker-Projekte, für die Pull-Anfragen aktiviert sind, können Sie einen Bereitstellungs-Webhook in der Benutzeroberfläche Ihres Git-Anbieters einrichten. Dieser Webhook löst in Looker das Bereitstellen des neuesten Commits aus dem Produktionszweig aus, wenn Sie einen Pull-Request über die 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 einen Webhook zur automatischen Bereitstellung auf der Benutzeroberfläche Ihres Git-Anbieters 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 Ihrer 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

In den Looker-Projekteinstellungen können Sie auch ein Webhook-Deploy-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. Rufen Sie in Ihrem GitHub-Repository die Repository-Einstellungen Ihres Projekts auf.
  2. Klicken Sie in den Einstellungen Ihres Repositories auf Webhooks. Klicken Sie auf Webhook hinzufügen, um das Fenster 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 Bereitstellungssecret aus den Projekteinstellungen Ihres LookML-Projekts und fügen Sie es in das Feld Secret in der Benutzeroberfläche des Git-Anbieters ein. Weitere Informationen finden Sie auf der Seite Webhook-Bereitstellungssecret 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).

Über einen Bereitstellungs-Webhook aus einem Remote-Git-Repository abrufen

Wenn Pull-Requests für Ihr LookML-Projekt aktiviert sind und Deploy-Webhooks nicht automatisiert werden, kann es gelegentlich vorkommen, dass die LookML, die Sie im Looker-Produktionsmodus sehen, nicht mit der LookML im Hauptzweig Ihres Git-Repositorys übereinstimmt. Dies kann in folgenden Situationen auftreten:

  • Wenn Pull-Anfragen für das Repository aktiviert sind
  • Wenn die 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 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 für die Bereitstellung ausgeführt haben, wird auf einer leeren Webseite eine Erfolgsmeldung wie die folgende angezeigt:

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

Daten aus einem Remote-Git-Repository für Webhooks mit Bereitstellungssecrets 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 mit dem Webhook-Secret in Ihrem Terminal ausführen. Ersetzen Sie dabei Folgendes:

  • 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. Die Benutzeroberfläche Ihres Git-Anbieters kann jedoch zusätzliche Optionen zum Zusammenführen enthalten, z. B. Squash and merge (Zusammenführen und zusammenführen) oder Rebase and merge (Neu auslagern und zusammenführen).

Looker unterstützt weder das Squash-Merge noch das Rebase-Merge. Daher sollten Ihre Entwickler diese Optionen 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. Rufen Sie den Tab Einstellungen auf, 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 Ihres Repositories 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.

Wenn Sie die Zusammenführungsoptionen deaktivieren, sind sie in GitHub nicht mehr verfügbar, wenn Ihre Entwickler einen Branch in das Repository zusammenführen.