Einstellungen für die Versionsverwaltung des Projekts konfigurieren

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

Projekteinstellungen

Wenn Sie die Projekteinstellungen aufrufen möchten, öffnen Sie Ihr Projekt und wählen Sie dann im Symbolmenü der Looker IDE das Symbol Einstellungen aus.

Hier haben Sie Zugriff auf drei Tabs mit Projekteinstellungen:

Konfiguration

Über den 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.

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

  • Codequalität: Bestimmt, ob Entwickler den LookML-Validator für das Projekt erfolgreich ausführen müssen, bevor sie Änderungen am Projekt vornehmen können. Für Codequalität sind die folgenden 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 Änderungen festschreiben, wenn Warnungen vorhanden sind. 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 sie zu nicht funktionierender LookML oder fehlerhaften Ergebnissen führen kann.

  • Verlangen Sie bestandene Datentests, bevor dieses Projekt für die Produktion bereitgestellt wird: Wenn das LookML-Projekt einen oder mehrere test-Parameter enthält, müssen Entwickler mit dieser Option die Datentests ausführen, bevor sie Änderungen implementieren. 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 Seite mit der Parameterdokumentation für test. Informationen zum Ausführen von Datentests in Ihrem Projekt finden Sie auf der Dokumentationsseite Versionskontrolle und Bereitstellung verwenden. Für neue LookML-Projekte ist standardmäßig die Option Verlangen Sie bestandene Datentests, bevor dieses Projekt für die Produktion bereitgestellt wird aktiviert.

  • Git-Integration: Hiermit werden die Integrationsebenen mit Ihrem Git-Anbieter angegeben. Weitere Informationen finden Sie unter Git-Integrationsoptionen.

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

  • 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, bleibt der Git-Verlauf für den Hauptzweig erhalten. 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 Best Practices-Seite 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. Im Feld Git-Produktionszweigname können Sie angeben, welchen Zweig aus Ihrem Git-Repository Looker als Zielzweig verwenden soll, in den die Zweige Ihrer Looker-Entwickler zusammengeführt werden. Auf der Seite Versionskontrolle und Bereitstellung verwenden finden Sie den Standard-Git-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 im Looker-Projekt, ihre Änderungen zu committen und ihre Branche mit dem vorhandenen Produktionszweig zusammenzuführen. Bitten Sie sie dann, ihre Arbeit pausieren, bis der Name des Git-Produktionszweigs aktualisiert und in der Looker-Projektkonfiguration gespeichert wurde.
  • Wenn in Ihrem Projekt integrierte Pull-Anfragen verwendet werden, schließen Sie alle offenen Pull-Anfragen ab und führen Sie sie zusammen.
  • Führen Sie alle erforderlichen Vorbereitungen auf der Seite des Git-Anbieters aus, z. B. erstellen Sie einen neuen Branch in Ihrem Repository, benennen Sie den vorhandenen Standard-Git-Branch um oder führen Sie alle anderen Aktionen aus, die erforderlich sind, um den Branch so vorzubereiten, dass Looker ihn als Ziel-Branch für das Zusammenführen verwenden kann. Sie müssen mindestens prüfen, ob der gewünschte Branch in Ihrem Git-Repository vorhanden ist.

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

  1. Klicken Sie im Symbolmenü der Looker IDE auf das Symbol Einstellungen, um die Projekteinstellungen aufzurufen. Der Tab Konfiguration wird standardmäßig geöffnet.
  2. Geben Sie im Feld Git-Produktionszweigname 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 Projektkonfiguration speichern, um die Änderung zu speichern.

Anmeldedaten importieren

Im Bereich Anmeldedaten importieren können Sie Anmeldedaten 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.

Optionen für die Git-Integration

Nachdem Sie Ihre Git-Verbindung eingerichtet haben, verwendet Looker Ihren Git-Anbieter zum Verwalten Ihrer LookML-Quelldateien, wie auf der Dokumentationsseite 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 auch Links für jede Projektdatei bereit, damit Ihre Entwickler den Verlauf der Datei und Git-Blame-Informationen in der Benutzeroberfläche Ihres Git-Anbieters aufrufen können. Informationen zu den Links finden Sie im Abschnitt Externe Links zu Ihrem Git-Anbieter einbinden.
  • 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. Informationen zur Einrichtung finden Sie im Abschnitt Pull-Requests in Ihr Projekt einbinden.

Klicken Sie unter Bereitstellung auf Projektkonfiguration speichern, um die Einstellungen für die Git-Integration zu speichern.

Wenn Sie eine der zusätzlichen Optionen für die Git-Integration aktiviert haben (Links anzeigen, Pull-Requests empfohlen oder Pull-Requests erforderlich), stellt Looker externe Links zur Benutzeroberfläche 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.

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

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 in den Looker-Produktionszweig einzubinden, 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 über die Weboberfläche des Git-Anbieters einen Pull-Request für andere Looker-Entwickler öffnen, der von diesen geprüft und genehmigt werden kann. 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 In Produktion bereitstellen ist nicht verfügbar, wenn das Projekt mit dem erweiterten Bereitstellungsmodus aktiviert ist.
  • Pull-Anfragen erforderlich: Nachdem ein Entwickler Änderungen an seinem Entwicklungszweig committet hat, wird er über die Git-Schaltfläche in der Looker IDE aufgefordert, einen Pull-Request zu öffnen. Der Entwickler muss einen Pull-Request ö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“)

Hier sind einige weitere Hinweise zur Verwendung von Pull-Requests 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 in Ihrer 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-Requests in LookML-Projekte einzubinden. 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, ist es nicht erforderlich, im Abschnitt Projekt mit integrierten Pull-Requests einrichten einen Webhook zu konfigurieren, da die Zusammenführungs- und Bereitstellungsfunktionen im erweiterten Bereitstellungsmodus getrennt sind.

  • 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 aus Looker über GitHub rückgängig machen.

  • 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 erfolgen. Der überprüfte Code kann dann in der Produktionsinstanz bereitgestellt werden. Informationen zur Einrichtung finden Sie im Communitybeitrag Git-Workflow mit einem Repository für mehrere Instanzen – Entwicklung, Staging und Produktion.

  • 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-Requests 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 Einstellungen aus.
  2. Wählen Sie auf dem Tab Konfiguration im Abschnitt Git-Integration die Option Pull-Requests empfohlen oder Pull-Requests erforderlich aus.
  3. Optional: Wenn Sie einen automatischen Deploy-Webhook auf der Benutzeroberfläche Ihres 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 sich auch später entscheiden und zu den Projekteinstellungen zurückkehren, um die Webhook-Informationen abzurufen.
  4. Optional können Sie ein Webhook-Bereitstellungssecret einrichten, um einen automatischen Bereitstellungs-Webhook von Ihrem Git-Anbieter oder einen Webhook für den erweiterten Bereitstellungsmodus zu authentifizieren. Klicken Sie auf Webhook-Secret festlegen, um ein Webhook-Secret zu erstellen. 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 Bereitstellungssecret hinzuzufügen. Weitere Informationen finden Sie auf der Seite Webhook-Bereitstellungssecret konfigurieren.
  5. Klicken Sie auf Projektkonfiguration speichern.

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

Nachdem Sie Ihr Looker-Projekt für die Verwendung von Pull-Requests eingerichtet haben, können Sie so festlegen, wie Commits in Ihrer Produktionsumgebung bereitgestellt werden:

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 letzten 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 den erweiterten Bereitstellungsmodus konfiguriert ist. Im erweiterten Bereitstellungsmodus können Sie den Commit und den Branch auswählen, die Sie bereitstellen möchten. In den meisten Fällen würde die Einrichtung eines Webhooks für die automatische Bereitstellung die Funktionen des erweiterten Bereitstellungsmodus aufheben.

Wenn Sie in der Benutzeroberfläche Ihres Git-Anbieters einen Webhook für automatische Bereitstellungen hinzufügen möchten, rufen Sie zuerst die Projekteinstellungen in Looker auf. Klicken Sie dazu im Symbolmenü der Looker IDE des Projekts auf das Symbol 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 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

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 Seite Webhook-Bereitstellungssecret konfigurieren.

Sobald Sie die Webhook-URL und das Webhook-Secret für die Bereitstellung haben, können Sie sie in die Benutzeroberfläche Ihres Git-Anbieters eingeben. Wenn Ihr Git-Anbieter GitHub ist, gehen Sie so vor:

  1. Rufen Sie die Repository-Einstellungen Ihres Projekts in Ihrem GitHub-Repository 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 die Webhook-Informationen ein, die Sie im Abschnitt Git-Integration in Looker kopiert haben.
  4. Optional können Sie ein Webhook-Deployment-Secret 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 sollen 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. Das kann in den folgenden Fällen passieren:

  • 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
    • In einer anderen Looker-Instanz, z. B. einer Staging-Instanz

Sie können den Looker-Produktionszweig mit dem Hauptzweig des Repositorys mithilfe eines Bereitstellungs-Webhooks synchronisieren:

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

Der Produktionsmodus in Looker wurde jetzt an den Remote-Git-Hauptzweig angepasst. Ihr persönlicher Entwicklerzweig und freigegebene Zweige sind davon nicht betroffen.

Daten aus einem Remote-Git-Repository für Webhooks mit Bereitstellungssecrets abrufen

Wenn für Ihr LookML-Projekt auch ein Webhook-Deploy-Secret erforderlich ist, um Änderungen aus dem Hauptzweig an den Produktionszweig zu übertragen, erhalten Sie einen der folgenden Fehler, wenn Sie den Produktionszweig mit dem Hauptzweig des Repositorys mithilfe der im vorherigen Abschnitt Mit einem Deploy-Webhook Daten aus einem Remote-Git-Repository abrufen beschriebenen Methode synchronisieren:

{"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 Bereitstellungssecret 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 Instanz Brettcase mit dem Hauptzweig des Repositorys synchronisieren möchten, gehen Sie so vor:

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

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

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

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. Deaktivieren Sie diese Optionen nach Möglichkeit für Ihr Repository. 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: Bei Projekten, die mit der Git-Integration konfiguriert sind, können Sie die Option Projekt in Git ansehen im Git-Menü des Projekts in Looker verwenden.

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

  3. Gehen Sie zum Bereich Schaltfläche „Merge“ und lassen Sie nur die Option Merge-Commits zulassen aktiviert. Deaktivieren Sie die Optionen Squash-Merge zulassen und Rebase-Merge zulassen.

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