Git-Verbindung einrichten und testen

Wenn Sie ein neues Projekt erstellen, gibt es es nur im Entwicklungsmodus – so können Sie Ihr Modell in einer sicheren Umgebung entwickeln, die keine Auswirkungen auf andere Nutzer hat. Wenn Sie bereit sind, Ihr Projekt zu veröffentlichen, konfigurieren Sie als Nächstes eine Git-Verbindung.

Wenn Sie eine Git-Verbindung für Ihr Projekt konfigurieren, können Sie LookML im Produktionsmodus bereitstellen. So können andere Nutzer Ihr Datenmodell untersuchen, Dashboards erstellen und LookML zu Ihrem Modell hinzufügen. Für eine schnellere Einrichtung sollten Sie ein einfaches Repository verwenden. Erstellen Sie für eine stabilere Git-Integration ein eigenes Git-Repository und folgen Sie der Anleitung auf dieser Seite, um es mit Ihrer Looker-Instanz zu verbinden.

Looker in Git einbinden

Looker verwendet Git, um Änderungen zu erfassen und Dateiversionen zu verwalten. Jedes LookML-Projekt entspricht einem Git-Repository und jedes Mal, wenn sich ein Nutzer im Entwicklungsmodus befindet, befindet er sich in seinem eigenen Git-Zweig. Git-Repositories werden häufig als Repos bezeichnet.

Für die Verwaltung der LookML-Quelldatei kann Looker mit jedem Git-Anbieter konfiguriert werden, der einen SSH-Schlüssel oder HTTPS zur Authentifizierung verwendet. Die allgemeinen Schritte sind unabhängig davon, welche Plattform Sie verwenden. Auf dieser Seite wird GitHub als Beispiel für die Verbindung eines Looker-Projekts mit Git verwendet, nachdem Sie ein Git-Repository erstellt haben.

Für den Zugriff auf die Git-Integrationsoptionen muss der Entwicklungsmodus aktiviert sein.

Sie können die Git-Integration mit einem der folgenden Protokolle konfigurieren:

  • HTTPS: HyperText Transfer Protocol Secure. Mit HTTPS greifen Looker mit Ihrem Nutzernamen und Passwort (oder Zugriffstoken) auf Ihr Git-Repository zu, wie unten im Abschnitt Mit HTTPS verbinden beschrieben.
  • SSH: Secure Shell. Mit SSH greift Looker mithilfe eines Bereitstellungsschlüssels, den Sie über die Website Ihres Git-Anbieters generieren, auf Ihr Git-Repository zu. Dies wird im Abschnitt Mit SSH verbinden beschrieben.

Mit HTTPS über Git verbinden

Bei LookML-Projekten, die mit HTTPS-Authentifizierung konfiguriert sind, stellt Looker eine Verbindung zu Ihrem Git-Anbieter mit einem oder mehreren Nutzerkonten her, die Sie bei Ihrem Git-Anbieter eingerichtet haben. Looker verwendet einen Nutzernamen und ein Passwort (oder ein Zugriffstoken), um sich bei Ihrem Git-Anbieter anzumelden und Git-Vorgänge im Namen Ihrer LookML-Entwickler auszuführen.

Wenn für Ihr Git-Konto die Bestätigung in zwei Schritten verwendet wird, können Sie zu Ihrem Git-Anbieter Zugriffstokens für Ihr Konto erstellen. Im Community-Beitrag HTTPS-Verbindung mit 2FA aktiviert finden Sie eine Anleitung zum Erstellen von persönlichen Zugriffstokens für gängige Git-Anbieter.

Mit der HTTPS-Authentifizierung können Sie Ihr LookML-Projekt so konfigurieren, dass es für das gesamte Projekt ein einzelnes Git-Konto verwendet. Alternativ können Sie es so konfigurieren, dass für die Git-Vorgänge die einzelnen Git-Konten Ihrer Entwickler verwendet werden.

Beachten Sie bei der GitHub-HTTPS-Authentifizierung Folgendes:

  • GitHub akzeptiert keine Kontopasswörter für die Authentifizierung von Git-Vorgängen auf github.com. Weitere Informationen finden Sie im GitHub-Blogpost. Wenn Sie ein Looker-Projekt mit HTTPS über GitHub verbinden möchten, verwenden Sie die Entwicklereinstellungen in GitHub, um ein persönliches Zugriffstoken zu erstellen.
  • Looker unterstützt nicht die detailgenauen persönlichen Zugriffstokens von GitHub. Wenn Sie Ihr Looker-Projekt über HTTPS mit GitHub verbinden möchten, verwenden Sie beim Erstellen eines persönlichen Zugriffstokens die Option Tokens (klassische) Version von GitHub.

HTTPS-Authentifizierung mit einem Konto

Wenn Sie Ihr LookML-Projekt mit einem einzelnen Git-Konto einrichten, meldet sich Looker über dieses Git-Konto bei Ihrem Git-Anbieter an, um im Namen der Entwickler Änderungen zu übernehmen. Looker erstellt diese Commits mit dem Looker-Nutzernamen des Entwicklers, damit Sie feststellen können, welcher Entwickler die einzelnen Commits erstellt hat. Sie können den Commit-Verlauf Ihres Projekts auf der Benutzeroberfläche Ihres Git-Anbieters ansehen oder die Option Verlauf aus dem Git-Menü der Looker-IDE auswählen. Weitere Informationen zu den Git-Menüs in Looker finden Sie unter Git-Befehle in Looker ausführen.

Für die HTTPS-Authentifizierung eines einzelnen Kontos muss das von Ihnen angegebene Git-Nutzerkonto Lese- und Schreibzugriff auf das Git-Repository haben. Ihre LookML-Entwickler selbst benötigen keine eigenen Git-Nutzerkonten.

HTTPS-Authentifizierung mit mehreren Konten und Nutzerattributen

Wenn Sie Ihr LookML-Projekt mit mehreren Konten einrichten, verwendet das LookML-Projekt das individuelle Git-Konto jedes Looker-Entwicklers für Git-Vorgänge. Außerdem müssen Sie ein allgemeines Git-Nutzerkonto mit mindestens Lesezugriff konfigurieren, das von Looker verwendet wird, um die Produktionsversion der Dateien abzurufen.

Die folgenden Aufgaben und Anforderungen sind für die Git-Authentifizierung mit Nutzerattributen erforderlich:

  • Jeder LookML-Entwickler muss ein eigenes Nutzerkonto bei Ihrem Git-Anbieter haben. Jedes Git-Nutzerkonto muss Lese- und Schreibzugriff auf das Repository des Projekts haben.
  • Ihr Looker-Administrator muss Looker-Nutzerkonten mit Nutzerattributen einrichten, die dem Git-Nutzernamen und dem Git-Passwort entsprechen (oder dem Zugriffstoken, wenn die Git-Nutzerkonten die Bestätigung in zwei Schritten haben).
  • Nutzerattribute für Git-Kontopasswörter (oder Zugriffstokens) müssen ausgeblendet sein. Wählen Sie beim Erstellen des Attributs „Passwort“ oder „Zugriffstoken“ unter der Option Werte ausblenden die Option Ja aus und geben Sie die URL des Git-Anbieters in das Feld Domain-Zulassungsliste ein.
  • Die Nutzerattribute für den Git-Namen und das Passwort (oder das Zugriffstoken) müssen für jeden Looker-Entwickler ausgefüllt werden. Nutzerattribute können von einem Looker-Administrator oder von einem Looker-Nutzer konfiguriert werden.

Im folgenden Beispiel sehen Sie die Seite Administratorattribute, auf der ein Looker-Administrator Nutzerattribute für den Git-Nutzernamen und das Nutzer-Zugriffstoken eingerichtet hat.

Tabelle auf der Seite „Administratorattribute“ mit den Nutzerattributen „github_token“ und „github_username“.

Das folgende Beispiel zeigt die Seite Konto eines Looker-Nutzers, bei der der Nutzer seine Git-Anmeldedaten in die Felder für Nutzerattribute eingegeben hat.

HTTPS-Git-Authentifizierung konfigurieren

So konfigurieren Sie ein LookML-Projekt mit der HTTPS-Git-Authentifizierung:

  1. Rufen Sie die HTTPS-URL für Ihr Git-Repository ab. Bei GitHub wird für neue Repositories (Repositories, die noch keine Dateien enthalten) die URL bei der Ersteinrichtung angezeigt. Klicken Sie auf dem Tab Code auf die Schaltfläche HTTPS, um die HTTPS-URL zu erhalten. Wählen Sie dann die Schaltfläche zum Kopieren aus, um sie in die Zwischenablage zu kopieren.

    Bei vorhandenen GitHub-Repositories (Repositories, die bereits Dateien enthalten) können Sie die HTTPS-URL sehen, indem Sie zum Tab Code des Repositorys wechseln und die Schaltfläche Code auswählen. Wählen Sie den Link HTTPS aus. Du kannst das Symbol für die Zwischenablage auswählen, um die HTTPS-URL in die Zwischenablage zu kopieren.

  2. Rufen Sie Ihr LookML-Projekt auf, wählen Sie in der Navigationsleiste das Symbol Einstellungen aus und öffnen Sie die Seite Git konfigurieren, indem Sie für neue Projekte die Schaltfläche Git konfigurieren oder für bereits vorhandene Projekte, die zuvor mit Git verbunden wurden, die Schaltfläche Gitterverbindung zurücksetzen auswählen.

    Wenn Sie Ihre Git-Verbindung zurücksetzen, wird der Git-Verlauf für den Master-Zweig beibehalten. Der Verlauf der privaten Zweige der Looker-Entwickler bleibt dabei erhalten, nachdem sie abgerufen, zusammengeführt und bereitgestellt wurden. Wenn Sie den Verlauf für alle Zweige beibehalten möchten, lesen Sie die Seite Migration zu einem neuen Git-Repository.

  3. Fügen Sie im Looker-Abschnitt Git konfigurieren die HTTPS-URL für Ihr Git-Repository in das Feld Repository URL ein und wählen Sie dann Continue aus.

    Looker erkennt Ihren Git-Anbieter und aktualisiert das Fenster mit Informationen zu Ihrem Git-Repository.

    Wenn Looker Ihren Git-Anbieter nicht richtig erkennt, werden Sie aufgefordert, aus einem Drop-down-Menü auszuwählen.

  4. Wählen Sie Ihre Git-Anmeldeoption aus:

  5. Geben Sie in den Feldern Nutzername und Passwort/Persönlicher Zugriffstokens die Anmeldedaten ein, die Ihr LookML-Projekt für den Zugriff auf Git verwenden soll. Dies ist unabhängig von Ihrer Git-Log-in-Einstellung erforderlich:

    • Wenn Sie Einzelne, konstante Kombination aus Nutzername und Passwort und persönlichem Zugriffstoken verwenden auswählen, ist dies der Git-Nutzername und das zugehörige Passwort, das von Ihrer Looker-Instanz für alle Git-Vorgänge verwendet wird. Dieses Git-Nutzerkonto muss Lese- und Schreibzugriff auf das Git-Repository haben.
    • Wenn Sie Nutzerattribute für Nutzername und Passwort/persönliches Zugriffstoken verwenden ausgewählt haben, sind dies der Git-Nutzername und das -Passwort (oder Zugriffstoken), das von Ihrer Looker-Instanz zum Abrufen der Produktionsversion des Repositorys verwendet wird. Dieses Git-Nutzerkonto muss mindestens Lesezugriff auf Ihr Git-Repository haben.

    Wenn für Ihr Git-Konto die Bestätigung in zwei Schritten verwendet wird oder Sie GitHub verwenden (für die ein persönliches Zugriffstoken anstelle eines Passworts erforderlich ist), können Sie bei Ihrem Git-Anbieter Zugriffstokens erstellen, die anstelle von Passwörtern verwendet werden. Im Community-Beitrag HTTPS-Verbindung mit 2FA aktiviert finden Sie eine Anleitung zum Erstellen von persönlichen Zugriffstokens für gängige Git-Anbieter.

  6. Wenn Sie Nutzerattribute für Nutzername und Passwort/persönliches Zugriffstoken verwenden ausgewählt haben, werden im Looker-Bereich im Abschnitt Anmeldedaten für den Entwicklermodus die Drop-down-Menüs Nutzernamen-Nutzerattribut und Persönliches Zugriffstoken-Nutzerattribut angezeigt. Wählen Sie über die Drop-down-Menüs die Nutzerattribute für die Git-Anmeldedaten der einzelnen Entwickler aus.

    Looker-Nutzer können die Werte für die Nutzerattributfelder auf der Kontoseite bearbeiten. Looker-Administratoren können die Nutzerattributwerte für einen Nutzer auf der Nutzerseite bearbeiten.

  7. Wählen Sie die Schaltfläche Einrichtung fortsetzen aus.

Git ist jetzt für Ihr LookML-Projekt konfiguriert. Von hier aus können Sie Ihr LookML validieren, dann Ihren ersten Commit erstellen und in der Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:

Mit SSH eine Verbindung zu Git herstellen

Mit der SSH-Authentifizierung erstellen Sie einen Bereitstellungsschlüssel für Ihren Git-Anbieter. Looker generiert das SSH-Schlüsselpaar und zeigt den öffentlichen Schlüssel wie in Schritt 4 unten auf der Benutzeroberfläche an. Looker verwendet diesen Bereitstellungsschlüssel, um sich bei Ihrem Git-Anbieter anzumelden, um Änderungen im Namen der Looker-Entwickler zu übernehmen. Looker erstellt Commits mit dem Looker-Nutzernamen eines Entwicklers, damit Sie feststellen können, welcher Entwickler die einzelnen Commits erstellt hat. Sie können den Commit-Verlauf Ihres Projekts auf der Benutzeroberfläche Ihres Git-Anbieters ansehen oder die Option Verlauf aus dem Git-Menü der Looker-IDE auswählen. Weitere Informationen zu den Git-Menüs in Looker finden Sie unter Git-Befehle in Looker ausführen.

So konfigurieren Sie ein LookML-Projekt mit SSH-Git-Authentifizierung:

  1. Öffnen Sie Ihr Projekt und wählen Sie im Bereich mit den Projekteinstellungen Konfiguration aus, um die Projektkonfiguration aufzurufen. Öffnen Sie als Nächstes die Seite Git konfigurieren, indem Sie eine der folgenden Aktionen ausführen:

    • Für ein neues Projekt wählen Sie im Bereich für die Projektkonfiguration die Schaltfläche Git konfigurieren aus.
    • Wenn Sie die Git-Einrichtung für ein vorhandenes Projekt ändern möchten, wählen Sie im Abschnitt für die Projektkonfiguration Git-Verbindung zurücksetzen aus.

    Wenn Sie Ihre Git-Verbindung zurücksetzen, wird der Git-Verlauf für den Master-Zweig beibehalten. Der Verlauf der privaten Zweige der Looker-Entwickler bleibt dabei erhalten, nachdem sie abgerufen, zusammengeführt und bereitgestellt wurden. Wenn Sie den Verlauf für alle Zweige beibehalten möchten, lesen Sie die Seite Migration zu einem neuen Git-Repository.

    Diagramm mit dem Fortschritt von der Seite „Projekteinstellungen“ zur Seite „Git konfigurieren“ Bei neuen Projekten wird die Schaltfläche „Git konfigurieren“ angezeigt und bei vorhandenen Projekten wird die Schaltfläche „Git Connect zurücksetzen“ angezeigt. Beide Schaltflächen führen jedoch zur Seite „Git konfigurieren“.

  2. Rufen Sie die SSH-URL für Ihr Git-Repository ab. Im Folgenden sind die Formate für gängige Git-Anbieter aufgeführt:

    • GitHub: git@github.com:<organization-name>/<repository-name>.git
    • GitHub Enterprise: git@example.com:<organization-name>/<repository-name>.git
    • Cloud Source Repositories: ssh://username@example.com@source.developers.google.com:2022/p/<project-id>/r/<repository-name>
    • GitLab: git@gitlab.com:<organization-name>/<repository-name>.git
    • Bitbucket: git@bitbucket.org:<organization-name>/<repository-name>.git
    • Phabricator: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    Im Fall von GitHub wird für neue Repositories (Repositories, die noch keine Dateien enthalten) die SSH-URL im Rahmen der Ersteinrichtung auf dem Tab Code angezeigt. Wählen Sie die Schaltfläche SSH aus, damit Sie die SSH-URL erhalten. Wählen Sie dann das Symbol für die Zwischenablage aus, um es in die Zwischenablage zu kopieren.

    Bei vorhandenen GitHub-Repositories (Repositories, die bereits Dateien enthalten), können Sie die SSH-URL sehen, indem Sie zum Tab Code des Repositorys wechseln und die Schaltfläche Code auswählen. Achten Sie darauf, den Link SSH verwenden auszuwählen. Du kannst das Symbol für die Zwischenablage auswählen, um es in die Zwischenablage zu kopieren.

  3. Fügen Sie im Looker-Abschnitt Git konfigurieren die SSH-URL für Ihr Git-Repository in das Feld Repository URL ein und wählen Sie dann Continue aus.

    URLs mit benutzerdefinierten oder nicht standardmäßigen Git-Ports können mit Looker verwendet werden. Fügen Sie der Git-URL die nicht standardmäßige Portnummer hinzu. Beispiel: ssh://git@corporate.git.server.com:22/myorganization/myproject.git
    Du musst ssh:// angeben, damit dies richtig funktioniert.

  4. Looker erkennt Ihren Git-Anbieter und zeigt einen Bereitstellungsschlüssel für Ihr Repository an. Wenn Ihr Git-Anbieter nicht von Looker erkannt wird, werden Sie aufgefordert, aus einem Drop-down-Menü eine Auswahl zu treffen. Kopieren Sie den Bereitstellungsschlüssel in die Zwischenablage und wählen Sie dann den Link Schlüsseleinstellungen für Ihr Repository bereitstellen aus, um die GitHub-Seite Schlüssel bereitstellen für Ihr GitHub-Repository zu öffnen.

  5. Wählen Sie auf dem Tab Einstellungen auf der Seite Schlüssel bereitstellen die Schaltfläche Bereitstellungsschlüssel hinzufügen aus:

    GitHub zeigt die Seite Schlüssel bereitstellen / Neue hinzufügen an.

  6. Fügen Sie einen Titel für den Bereitstellungsschlüssel hinzu. Der Name ist nicht wichtig. Sie sollten jedoch „Looker“ und den Projekttitel angeben, um ihn in Zukunft zu erfassen.

  7. Fügen Sie den Bereitstellungsschlüssel ein, den Sie aus Looker kopiert haben.

  8. Wählen Sie die Option Schreibzugriff zulassen aus.
    Das ist ein wichtiger Schritt, weil Looker diese Einstellung erfordert, um Änderungen an Ihrem LookML-Modell vornehmen und bereitstellen zu können.

  9. Wählen Sie die Schaltfläche Schlüssel hinzufügen aus. Sie werden dann möglicherweise von Ihrem Git-Anbieter aufgefordert, Ihr Passwort einzugeben. Falls ja, geben Sie Ihr Passwort ein und wählen Sie Passwort bestätigen aus.)

  10. GitHub zeigt alle Bereitstellungsschlüssel an, die für Ihr Repository hinzugefügt wurden.

  11. Kehren Sie zum Looker-Fenster zurück und wählen Sie im Abschnitt Git konfigurieren die Option Testen und abschließen aus.

Hier können Sie noch einmal versuchen, den Bereitstellungsschlüssel einzurichten. Alternativ können Sie Tests überspringen und Einrichtung abschließen auswählen, um Ihre aktuellen Einstellungen beizubehalten.

Git ist jetzt für Ihr LookML-Projekt konfiguriert. Von hier aus können Sie Ihr LookML validieren, dann Ihren ersten Commit erstellen und in der Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:

Bare-Git-Repository konfigurieren

Wenn Sie noch kein Remote-Git-Repository erstellt haben oder die Einrichtung schnell durchführen möchten, damit andere von Ihrem LookML profitieren können, können Sie ein Git-Repository konfigurieren. Wenn Sie ein Bare-Git-Repository konfigurieren, wird ein lokales Git-Repository auf Ihrer Looker-Instanz erstellt, statt eine Verbindung zu einem Remote-Repository herzustellen.

So konfigurieren Sie ein LookML-Projekt mit einem Bare-Git-Repository:

  1. Öffnen Sie Ihr Projekt und wählen Sie im Bereich mit den Projekteinstellungen Konfiguration aus, um die Projektkonfiguration aufzurufen. Führen Sie anschließend eine der folgenden Aktionen aus:

    • Für ein neues Projekt wählen Sie im Bereich für die Projektkonfiguration die Schaltfläche Git konfigurieren aus.
    • Wenn Sie die Git-Einrichtung für ein vorhandenes Projekt ändern möchten, wählen Sie im Abschnitt für die Projektkonfiguration Git-Verbindung zurücksetzen aus.

    Wenn Sie Ihre Git-Verbindung zurücksetzen, wird der Git-Verlauf für den Master-Zweig beibehalten. Der Verlauf der persönlichen Zweige der Looker-Entwickler bleibt dabei erhalten, nachdem sie per Pull, Merge und Bereitstellung abgerufen wurden. Wenn Sie den Verlauf für alle Zweige beibehalten möchten, lesen Sie die Seite Migration zu einem neuen Git-Repository.

  2. Wählen Sie unten im Dialogfeld Git konfigurieren, das sich über der Schaltfläche Weiter befindet, die Option Stattdessen Repository einrichten aus.

  3. Wählen Sie im Dialogfeld Bare-Git-Repository konfigurieren die Option Repository erstellen aus.

    Nachdem das Git-Repository erstellt wurde, wird in Looker das Dialogfeld Bare Repository erstellt angezeigt.

Git ist jetzt für Ihr LookML-Projekt konfiguriert. Von hier aus können Sie Ihr LookML validieren, dann Ihren ersten Commit erstellen und in der Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:

Neues LookML-Projekt mit einem nicht leeren Git-Repository verbinden

Das Konfigurieren von Git für die Versionsverwaltung ist ein wichtiger Schritt beim Erstellen eines neuen LookML-Projekts. In der Regel sollte jedes Projekt ein eigenes Repository haben. In den folgenden Situationen müssen Sie jedoch ein Projekt mit einem Git-Repository konfigurieren, das vorhandenes LookML enthält:

  • Wenn Sie ein vorhandenes LookML-Projekt zwischen Instanzen verschieben
  • Wenn Sie den Code aus einem fehlerhaften oder eingestellten LookML-Projekt abrufen, um es in einem neuen Projekt zu verwenden

In diesem Abschnitt werden Best Practices zum Konfigurieren eines neuen LookML-Projekts mit einem vorhandenen, nicht leeren Git-Repository für die weitere Entwicklung in LookML beschrieben.

Dieser Workflow gilt nur für Repositories, auf die Sie Schreibzugriff haben.

  1. Erstellen Sie ein neues LookML-Projekt, indem Sie Leeres Projekt als Ausgangspunkt auswählen. Ein leeres Projekt ist der Ausgangspunkt, da es mit LookML-Objekten aus einem vorhandenen Repository und nicht aus einem Datenbankschema oder einer SQL-Abfrage ausgefüllt wird.
  2. Konfigurieren Sie Git für Ihr Projekt entweder mit HTTPS oder SSH. Verwenden Sie dazu die URL für das nicht leere Projekt im Abschnitt Repository-URL des Abschnitts Git konfigurieren.
  3. Nachdem Sie Git für Ihr Projekt konfiguriert haben, rufen Sie über den Bereich Git Actions aus der Produktion auf.
  4. Wenn Sie die Produktionsversion abgerufen haben, wählen Sie In Produktion bereitstellen aus.

Änderungen, die Sie an LookML in Ihrem Projekt vornehmen, wirken sich nicht auf das ursprüngliche Repository aus, sondern auf Ihre lokale Version.

Wenn Sie ein öffentliches Repository als Basis für ein leeres LookML-Projekt verwenden möchten, aber keinen Schreibzugriff auf das Repository haben, folgen Sie der Anleitung im Abschnitt Klonen eines öffentlichen Git-Repositorys auf der Dokumentationsseite Neues LookML-Projekt erstellen.

Wenn Sie einen Git-Workflow mit einem Repository über mehrere Instanzen einrichten, lesen Sie den Communitybeitrag zum Git-Workflow mithilfe eines Repositorys für mehrere Instanzen – Entwicklung, Staging und Produktion.

Git-Verbindung testen

Looker bietet einen Git-Verbindungstest, um Ihre Git-Verbindung zu überprüfen. Mit dem Git-Verbindungstest wird geprüft, ob Sie die richtige Git-URL eingerichtet haben und der Git-Host für Looker erreichbar ist. Mit dem Git-Verbindungstest wird auch bestätigt, dass Sie einen gültigen Git-Bereitstellungsschlüssel bereitgestellt haben und dass der Bereitstellungsschlüssel Schreibzugriff auf Ihr Git-Repository hat.

Wenn Looker keine Verbindung zu Ihrem Git-Repository herstellen kann, wird auf der Git-Schaltfläche der Text Git-Verbindung testen angezeigt, in dem Sie aufgefordert werden, das Problem mit der Verbindung zu beheben.

Sie können auch auf das Git-Verbindungstesttool zugreifen, indem Sie im Bereich Git-Aktionen die Option Git-Verbindung testen auswählen:

Das Tool für den Git-Verbindungstest zeigt dann die Schritte zum Testen der Git-Verbindung an:

  1. Git-Remote-Prüftool untersuchen
  2. Hostname für Git-Dienst wird aufgelöst
  3. Netzwerk für den Git-Dienst funktioniert
  4. Anmeldedaten für die Autorisierung bestätigen
  5. Sicherstellen, dass Anmeldedaten den Schreibzugriff zulassen

Wenn ein Schritt erfolgreich war, wird in Looker links neben dem Schritt ein grünes Häkchen angezeigt. Wenn ein Schritt fehlschlägt, wird links neben dem Schritt ein rotes Häkchen angezeigt und es wird eine Fehlermeldung angezeigt.

Das folgende Beispiel zeigt einen erfolgreichen Test:

Dialogfeld mit Git-Verbindungstest und einer Liste mit Schritten, die mit grünen Häkchen gekennzeichnet sind, um anzuzeigen, dass alle Schritte erfolgreich waren.

Im folgenden Beispiel ist für das Git-Repository kein Bereitstellungsschlüssel für die Looker-Verbindung konfiguriert. Die grünen Häkchen links neben den ersten drei Schritten geben an, dass die Schritte erfolgreich waren:

  • Examine git remote
  • Host name for git service will resolve
  • Networking to the git service is operational

Die roten Häkchen links neben den letzten beiden Schritten weisen darauf hin, dass die folgenden Schritte fehlgeschlagen sind:

  • Verify authorization credentials
  • Ensure credentials allow write access

Dialogfeld mit Git-Verbindungstest, das eine Liste erfolgreicher und fehlgeschlagener Schritte anzeigt. Ein Fehler im Schritt „Anmeldedaten für die Autorisierung bestätigen“ lautet „Kann nicht für Remote-Zugriff authentifiziert werden (Looker-Bereitstellungsschlüssel).