Wenn Sie ein neues Projekt erstellen, ist es nur im Entwicklungsmodus vorhanden. 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 im nächsten Schritt eine Git-Verbindung.
Wenn Sie eine Git-Verbindung für Ihr Projekt konfigurieren, können Sie Ihre LookML im Produktionsmodus bereitstellen. So können andere Nutzer Ihr Datenmodell untersuchen, Dashboards erstellen und Ihrem Modell LookML hinzufügen. Für eine schnellere Einrichtung können Sie ein Bare Repository verwenden. Für eine robustere Git-Integration können Sie ein eigenes Git-Repository erstellen und der Anleitung auf dieser Seite folgen, um es mit Ihrer Looker-Instanz zu verbinden.
Looker in Git integrieren
Looker verwendet Git, um Änderungen aufzuzeichnen und Dateiversionen zu verwalten. Jedes LookML-Projekt entspricht einem Git-Repository. Jedes Mal, wenn sich ein Nutzer im Entwicklungsmodus befindet, befindet er sich in seinem eigenen Git-Zweig.
Für die LookML-Quelldateiverwaltung kann Looker mit jedem Git-Anbieter konfiguriert werden, der einen SSH-Schlüssel oder HTTPS für die Authentifizierung verwendet. Die allgemeinen Schritte sind unabhängig von der verwendeten Plattform gleich. 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 Git-Integrationsoptionen muss der Entwicklermodus aktiviert sein.
Sie können die Git-Integration mit einem der folgenden Protokolle konfigurieren:
- HTTPS: „HyperText Transfer Protocol Secure“. Bei HTTPS greift Looker mit einem von Ihnen angegebenen Nutzernamen und Passwort (oder Zugriffstoken) auf Ihr Git-Repository zu, wie unter Über HTTPS eine Verbindung zu Git herstellen beschrieben.
- SSH Secure Shell Bei SSH greift Looker mit einem Bereitstellungsschlüssel auf Ihr Git-Repository zu, den Sie über die Website Ihres Git-Anbieters generieren, wie unter Verbindung zu Git über SSH herstellen beschrieben.
HTTPS-Verbindung zu Git herstellen
Bei LookML-Projekten, die mit der HTTPS-Authentifizierung konfiguriert sind, stellt Looker über ein oder mehrere Nutzerkonten, die Sie bei Ihrem Git-Anbieter eingerichtet haben, eine Verbindung zu Ihrem Git-Anbieter her. 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 bei Ihrem Git-Anbieter Zugriffstokens erstellen, die anstelle von Passwörtern verwendet werden. Im Communitybeitrag HTTPS-Git-Verbindung mit aktivierter 2FA einrichten finden Sie eine Anleitung zum Erstellen persönlicher Zugriffstokens für gängige Git-Anbieter.
Mit der HTTPS-Authentifizierung können Sie Ihr LookML-Projekt so konfigurieren, dass ein einzelnes Git-Konto für das gesamte Projekt verwendet wird. Sie können das Projekt auch so konfigurieren, dass die einzelnen Git-Konten Ihrer Entwickler für die Ausführung von Git-Vorgängen verwendet werden.
Beachten Sie Folgendes für die HTTPS-Authentifizierung mit GitHub:
- 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 über HTTPS mit GitHub verbinden möchten, verwenden Sie die Entwicklereinstellungen in GitHub, um ein persönliches Zugriffstoken zu erstellen.
- Looker unterstützt keine detaillierten 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 (klassisch) von GitHub.
HTTPS-Authentifizierung für Einzelkonto
Wenn Sie Ihr LookML-Projekt mit einem einzelnen Git-Konto einrichten, meldet sich Looker mit diesem Git-Konto bei Ihrem Git-Anbieter an, um Änderungen im Namen der Entwickler zu committen. Looker führt diese Commits unter Verwendung des Looker-Nutzernamens des Entwicklers aus, damit Sie sehen können, welcher Entwickler welchen Commit vorgenommen hat. Sie können den Commit-Verlauf Ihres Projekts auf der Benutzeroberfläche Ihres Git-Anbieters oder durch Auswahl der Option Verlauf im Git-Menü der Looker IDE aufrufen. Weitere Informationen zu den Git-Menüs in Looker finden Sie unter Git-Befehle in Looker ausführen.
Für die HTTPS-Authentifizierung mit einem einzelnen Konto muss das von Ihnen angegebene Git-Nutzerkonto Lese- und Schreibzugriff auf Ihr Git-Repository haben. Ihre LookML-Entwickler selbst benötigen keine eigenen Git-Nutzerkonten.
HTTPS-Authentifizierung für mehrere Konten mit Nutzerattributen
Wenn Sie Ihr LookML-Projekt mit mehreren Konten einrichten, verwendet Ihr LookML-Projekt das individuelle Git-Konto jedes Looker-Entwicklers, um Git-Vorgänge auszuführen. Außerdem müssen Sie ein generisches Git-Nutzerkonto mit mindestens Lesezugriff konfigurieren, mit dem Looker die Produktionsversion der Dateien abrufen kann.
Die folgenden Aufgaben und Anforderungen sind für die Git-Authentifizierung mit Nutzerattributen erforderlich:
- Jeder Ihrer 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 eine 2-Faktor-Authentifizierung verwenden).
- Nutzerattribute für Passwörter von Git-Konten (oder Zugriffstokens) müssen ausgeblendet sein. Wählen Sie beim Erstellen des Passwort- oder Zugriffstokenattributs unter Werte ausblenden die Option Ja aus und geben Sie die URL des Git-Anbieters in das Feld Domain-Zulassungsliste ein.
- Die Benutzerattribute für den Git-Namen und das Passwort (oder Zugriffstoken) müssen für jeden Looker-Entwickler ausgefüllt werden. Nutzerattribute können von einem Looker-Administrator oder vom Looker-Nutzer konfiguriert werden.
Im folgenden Beispiel ist die Seite Nutzerattribute zu sehen, auf der ein Looker-Administrator Nutzerattribute für den Git-Nutzernamen und das Nutzerzugriffstoken eingerichtet hat.
Das folgende Beispiel zeigt die Seite Konto eines Looker-Nutzers, auf der der Nutzer seine Git-Anmeldedaten in die Felder für Benutzerattribute eingegeben hat.
HTTPS-Git-Authentifizierung konfigurieren
So konfigurieren Sie ein LookML-Projekt mit HTTPS-Git-Authentifizierung:
Rufen Sie die HTTPS-URL für Ihr Git-Repository ab. Im Fall von GitHub wird bei neuen Repositories (Repositories, die noch keine Dateien enthalten) die URL im Rahmen der Ersteinrichtung angezeigt. Wählen Sie auf dem Tab Code die Schaltfläche HTTPS aus, um die HTTPS-URL zu erhalten, und dann das Symbol URL in die Zwischenablage kopieren, um sie in die Zwischenablage zu kopieren.
Bei vorhandenen GitHub-Repositories (Repositories, die bereits Dateien enthalten) können Sie die HTTPS-URL aufrufen, indem Sie auf dem Tab Code des Repositorys auf die Schaltfläche Code klicken. Wählen Sie den Link HTTPS aus. Sie können das Symbol URL in die Zwischenablage kopieren auswählen, um die HTTPS-URL in die Zwischenablage zu kopieren.
Rufen Sie Ihr LookML-Projekt auf und wählen Sie in der Navigationsleiste das Symbol Einstellungen aus.
Klicken Sie auf der Seite Projektkonfiguration auf dem Tab Konfiguration auf die Schaltfläche Git konfigurieren (für neue Projekte) oder auf die Schaltfläche Git-Verbindung zurücksetzen (für bestehende Projekte, die bereits mit Git verbunden waren).
Wählen Sie Git konfigurieren oder Git-Verbindung zurücksetzen aus, um die Seite Git konfigurieren zu öffnen.
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 nach dem Pullen, Zusammenführen und Bereitstellen beibehalten. Informationen zum Erhalt des Verlaufs für alle Branches finden Sie auf der Seite mit Best Practices zur Migration zu einem neuen Git-Repository.
Fügen Sie auf der Looker-Seite Git konfigurieren die HTTPS-URL für Ihr Git-Repository in das Feld Repository-URL ein und wählen Sie Weiter aus.
Looker erkennt Ihren Git-Anbieter und aktualisiert das Fenster mit Informationen zu Ihrem Git-Repository.
Wenn Looker Ihren Git-Anbieter nicht erkennt, werden Sie aufgefordert, in einem Drop-down-Menü eine Auswahl zu treffen.
Wählen Sie Ihre Git-Anmeldeoption aus:
- Verwenden Sie eine einzelne, konstante Kombination aus Nutzername und Passwort/Token. Weitere Informationen finden Sie unter HTTPS-Authentifizierung für ein einzelnes Konto.
- Verwenden Sie Nutzerattribute für Nutzername und Passwort/Token (siehe HTTPS-Authentifizierung für Nutzerattribute).
Geben Sie in die Felder Nutzername und Passwort/Persönliches Zugriffstoken die Anmeldedaten ein, die Ihr LookML-Projekt für den Zugriff auf Git verwendet. Das ist unabhängig von Ihrer Git-Anmeldeeinstellung erforderlich:
- Wenn Sie Verwenden Sie eine einzelne, konstante Kombination aus Nutzername, Passwort und persönlichem Zugriffstoken, ist dies der Git-Nutzername und das Passwort (oder das Zugriffstoken), das Ihre Looker-Instanz für alle Git-Vorgänge verwendet. Dieses Git-Nutzerkonto muss Lese- und Schreibzugriff auf Ihr Git-Repository haben.
- Wenn Sie Nutzerattribute für Nutzernamen und Passwort/persönliches Zugriffstoken verwenden ausgewählt haben, sind dies der Git-Nutzername und das Git-Passwort (oder das Zugriffstoken), mit denen Ihre Looker-Instanz die Produktionsversion des Repositories abruft. Dieses Git-Nutzerkonto muss mindestens Lesezugriff auf Ihr Git-Repository haben.
Wenn Ihr Git-Konto die 2-Faktor-Authentifizierung verwendet oder wenn Sie GitHub verwenden, wofür ein persönliches Zugriffstoken statt eines Passworts erforderlich ist, können Sie zu Ihrem Git-Anbieter wechseln und Zugriffstokens erstellen, die anstelle von Passwörtern verwendet werden. Gehen Sie zu HTTPS-Git-Verbindung mit aktiviertem 2FA einrichten Communitybeitrag mit einer Anleitung zum Erstellen persönlicher Zugriffstokens für gängige Git-Anbieter.
Wenn Sie Nutzerattribute für Nutzernamen und Passwort/persönliches Zugriffstoken verwenden ausgewählt haben, werden im Bereich Anmeldedaten für den Entwicklungsmodus die Drop-down-Menüs Nutzerattribut für Nutzernamen und Nutzerattribut für persönliches Zugriffstoken angezeigt. Verwenden Sie die Drop-down-Menüs, um die Nutzerattribute für die Git-Anmeldedaten eines einzelnen Entwicklers auszuwählen.
Looker-Nutzer können die Werte für ihre Nutzerattributfelder auf der Seite Konto bearbeiten. Looker-Administratoren können die Nutzerattributwerte für einen Nutzer auf der Administratorseite Nutzer bearbeiten.
Wählen Sie die Schaltfläche Einrichtung fortsetzen aus.
Git ist jetzt für Ihr LookML-Projekt konfiguriert. Hier können Sie Ihre LookML validieren, dann Ihren ersten Commit erstellen und in der Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:
- Verwenden Sie das Git-Menü, um auf die Git-Befehle zuzugreifen.
- Verwenden Sie das Git-Menü, um Ihre Git-Verbindung zu testen.
- Wenn Sie Looker-Administrator sind, können Sie in den Projekteinstellungen die LookML-Validierung erzwingen und die Optionen für die Git-Integration konfigurieren.
Über SSH mit Git verbinden
Bei 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 in der Benutzeroberfläche an, wie in Schritt 4 zu sehen. Looker verwendet diesen Bereitstellungsschlüssel, um sich bei Ihrem Git-Anbieter anzumelden und Änderungen im Namen der Looker-Entwickler vorzunehmen. Looker führt Commits mithilfe des Looker-Nutzernamens eines Entwicklers durch, sodass Sie sehen können, welcher Entwickler die einzelnen Commits durchgeführt hat. Sie können den Commit-Verlauf Ihres Projekts auf der Benutzeroberfläche Ihres Git-Anbieters oder über die Option Verlauf im Git-Menü der Looker IDE aufrufen. 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:
- Öffnen Sie Ihr Projekt oder erstellen Sie ein neues LookML-Projekt.
- Wählen Sie in Ihrem Projekt im Menü mit den Symbolen links das Symbol Einstellungen aus, um die Seite Projektkonfiguration zu öffnen.
Führen Sie auf der Seite Project Configuration (Projektkonfiguration) eine der folgenden Aktionen aus, um die Seite Configure Git (Git konfigurieren) zu öffnen:
- Wählen Sie für ein Projekt ohne Git-Verbindung die Schaltfläche Git konfigurieren aus.
- Wählen Sie für ein Projekt, das bereits mit einer Git-Verbindung konfiguriert wurde, die Schaltfläche Reset Git Connection (Git-Verbindung zurücksetzen) aus.
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 nach dem Pullen, Zusammenführen und Bereitstellen beibehalten. Informationen zum Erhalt des Verlaufs für alle Branches finden Sie auf der Seite mit Best Practices zur Migration zu einem neuen Git-Repository.
Rufen Sie die SSH-URL für Ihr Git-Repository ab. Dies sind die Formate für gängige Git-Anbieter:
- 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
Bei GitHub wird für neue Repositories (Repositories, die noch keine Dateien enthalten) die SSH-URL im Rahmen der Ersteinrichtung auf dem Tab Code angezeigt. Klicken Sie auf die Schaltfläche SSH, um die SSH-URL abzurufen, und wählen Sie dann das Symbol für die Zwischenablage aus, um es in die Zwischenablage zu kopieren.
Sie können die SSH-URL bei vorhandenen GitHub-Repositories (Repositories, die bereits Dateien enthalten) aufrufen, indem Sie auf dem Tab Code des Repositorys auf die Schaltfläche Code klicken. Achten Sie darauf, den Link SSH verwenden auszuwählen. Du kannst das Zwischenablagesymbol auswählen, um den Code in die Zwischenablage zu kopieren.
- GitHub:
Fügen Sie auf der Seite Git konfigurieren in Looker die SSH-URL für Ihr Git-Repository in das Feld Repository-URL ein und wählen Sie dann Weiter aus.
URLs mit benutzerdefinierten oder nicht standardmäßigen Git-Ports können mit Looker verwendet werden, indem Sie der Git-URL die nicht standardmäßige Portnummer hinzufügen. Beispiel:
ssh://git@corporate.git.server.com:22/myorganization/myproject.git
Sie müssen die
ssh://
angeben, damit dies funktioniert.Looker erkennt Ihren Git-Anbieter und zeigt einen Bereitstellungsschlüssel für Ihr Repository an. (Wenn Looker Ihren Git-Anbieter nicht erfolgreich erkennt, werden Sie aufgefordert, aus einem Drop-down-Menü eine Auswahl zu treffen.) Kopieren Sie den Deploy Key in die Zwischenablage und wählen Sie dann den Link Deploy Key-Einstellungen für Ihr Repository aus, um die Seite Deploy Keys für Ihr GitHub-Repository zu öffnen.
Klicken Sie auf dem Tab Einstellungen von GitHub auf der Seite Bereitstellungsschlüssel auf die Schaltfläche Bereitstellungsschlüssel hinzufügen:
In GitHub wird die Seite Bereitstellungsschlüssel / Neu hinzufügen angezeigt.
Fügen Sie einen Titel für den Bereitstellungsschlüssel hinzu. Der Name ist nicht wichtig, aber Sie sollten „Looker“ und den Projekttitel hinzufügen, damit Sie ihn später wiederfinden.
Fügen Sie den Bereitstellungsschlüssel ein, den Sie aus Looker kopiert haben .
Wählen Sie die Option Schreibzugriff zulassen aus.
Wählen Sie die Schaltfläche Schlüssel hinzufügen aus. An dieser Stelle fordert Ihr Git-Anbieter Sie möglicherweise auf, Ihr Passwort einzugeben. Geben Sie in diesem Fall Ihr Passwort ein und wählen Sie Passwort bestätigen aus.
GitHub zeigt alle Bereitstellungsschlüssel an, die für Ihr Repository hinzugefügt wurden.
Kehren Sie zum Looker-Fenster zurück und wählen Sie auf der Seite Git konfigurieren die Option Einrichtung testen und abschließen aus.
Hier können Sie noch einmal versuchen, den Bereitstellungsschlüssel einzurichten, oder Tests überspringen und Einrichtung abschließen auswählen, um die aktuellen Einstellungen beizubehalten.
Git ist jetzt für Ihr LookML-Projekt konfiguriert. Hier können Sie Ihre LookML validieren, dann Ihren ersten Commit erstellen und in der Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:
- Über das Git-Menü können Sie auf die Git-Befehle zugreifen.
- Im Git-Menü können Sie Ihre Git-Verbindung testen.
- Wenn Sie Looker-Administrator sind, können Sie in den Projekteinstellungen die LookML-Validierung erzwingen und die Optionen für die Git-Integration konfigurieren.
Ein leeres Git-Repository konfigurieren
Wenn Sie noch kein Remote-Git-Repository erstellt haben oder die Einrichtung schnell vornehmen möchten, damit andere von Ihrer LookML profitieren können, können Sie ein Bare-Git-Repository konfigurieren. Wenn Sie ein Bare-Git-Repository konfigurieren, wird ein lokales Git-Repository in Ihrer Looker-Instanz erstellt, anstatt eine Verbindung zu einem Remote-Repository herzustellen.
Wenn Sie die Option zum Erstellen eines Bare-Repositorys auswählen, erstellt Looker das Repository auf Ihrem Looker-Server und startet den Git-Verlauf für das Repository.
So konfigurieren Sie ein LookML-Projekt mit einem Bare-Git-Repository:
- Öffnen Sie Ihr Projekt oder erstellen Sie ein neues LookML-Projekt.
- Wählen Sie in Ihrem Projekt im Menü mit den Symbolen links das Symbol Einstellungen aus, um die Seite Projektkonfiguration zu öffnen.
Führen Sie auf der Seite Project Configuration (Projektkonfiguration) eine der folgenden Aktionen aus, um die Seite Configure Git (Git konfigurieren) zu öffnen:
- Wählen Sie für ein Projekt ohne Git-Verbindung die Schaltfläche Git konfigurieren aus.
- Wählen Sie für ein Projekt, das bereits mit einer Git-Verbindung konfiguriert wurde, die Schaltfläche Reset Git Connection (Git-Verbindung zurücksetzen) aus.
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 den Code abgerufen, zusammengeführt und dann bereitgestellt hat. Informationen zum Erhalt des Verlaufs für alle Branches finden Sie auf der Seite mit Best Practices zur Migration zu einem neuen Git-Repository.
Wählen Sie unten auf der Seite Git konfigurieren die Option Bare Repository stattdessen einrichten aus.
Wählen Sie im Dialogfeld Bares Git-Repository konfigurieren die Option Repository erstellen aus.
Nachdem das Git-Repository erstellt wurde, wird in Looker das Dialogfeld Bare Repository Created (Bares Repository erstellt) angezeigt.
Git ist jetzt für Ihr LookML-Projekt konfiguriert. Hier können Sie Ihre LookML validieren, dann Ihren ersten Commit erstellen und in der Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:
- Über das Git-Menü können Sie auf die Git-Befehle zugreifen.
- Im Git-Menü können Sie Ihre Git-Verbindung testen.
- Wenn Sie Looker-Administrator sind, rufen Sie die Projekteinstellungen auf, um eine LookML-Validierung anzufordern und die Git-Integrationsoptionen zu konfigurieren.
Bei Projekten, die mit einem einfachen Repository konfiguriert sind, können Sie anschließend die Git-Verbindung zurücksetzen, wenn Sie das Projekt mit einem Git-Anbieter verbinden möchten. Weitere Informationen finden Sie unter HTTPS oder SSH. Stellen Sie jedoch keine Verbindung zu einem Git-Repository her, das bereits über einen Git-Verlauf verfügt. Wenn Sie Ihr LookML-Projekt mit einem Bare-Repository eingerichtet haben, erstellt Looker ein Repository auf Ihrem Looker-Server und startet den Git-Verlauf für das Repository. Wenn Sie anschließend Ihr LookML-Projekt mit einem Git-Repository mit einem Git-Verlauf verbinden, kann Looker die beiden Git-Verläufe nicht abgleichen und Sie können keine Git-Aktionen ausführen.
Neues LookML-Projekt mit einem nicht leeren Git-Repository verbinden
Die Konfiguration von Git für die Versionskontrolle ist ein wichtiger Schritt beim Erstellen eines neuen LookML-Projekts. In der Regel sollte jedes Projekt ein eigenes Repository haben. Möglicherweise müssen Sie jedoch ein Projekt mit einem Git-Repository konfigurieren, das vorhandene LookML-Dateien enthält. Das ist beispielsweise in den folgenden Fällen der Fall:
- Wenn Sie ein vorhandenes LookML-Projekt zwischen Instanzen verschieben
- Wenn Sie den Code aus einem fehlerhaften oder inaktiven LookML-Projekt zur Verwendung in einem neuen Projekt wiederherstellen
In diesem Abschnitt werden Best Practices für die Konfiguration eines neuen LookML-Projekts mit einem vorhandenen, nicht leeren Git-Repository für die weitere LookML-Entwicklung beschrieben.
- 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 gefüllt wird.
- Konfigurieren Sie Git für Ihr Projekt entweder mit HTTPS oder SSH. Verwenden Sie dazu die URL für das nicht leere Projekt im Bereich Repository-URL der Seite Git konfigurieren.
- Nachdem Sie Git für Ihr Projekt konfiguriert haben, holen Sie die Änderungen aus der Produktion ab. Klicken Sie dazu im Bereich Git-Aktionen auf die entsprechende Option.
- Wählen Sie nach dem Abrufen aus der Produktion Für die Produktion bereitstellen aus.
Änderungen, die Sie an der LookML in Ihrem Projekt vornehmen, wirken sich nicht auf das ursprüngliche Repository aus. Die Änderungen werden in Ihrer lokalen Version des Repositorys gespeichert.
Wenn Sie ein bestimmtes öffentliches Repository als Grundlage für ein leeres LookML-Projekt verwenden möchten, aber keinen Schreibzugriff auf dieses Repository haben, folgen Sie der Anleitung im Abschnitt Öffentliches Git-Repository klonen auf der Dokumentationsseite Neues LookML-Projekt erstellen.
Wenn Sie einen Git-Workflow mit einem Repository für mehrere Instanzen einrichten, finden Sie weitere Informationen im Communitybeitrag Git-Workflow mit einem Repository für mehrere Instanzen – Entwicklung, Staging und Produktion.
Git-Verbindung testen
Looker bietet einen Git-Verbindungstest zur Überprüfung Ihrer Git-Verbindung an. Der Git-Verbindungstest verifiziert, dass Sie die korrekte Git-URL eingerichtet haben und der Git-Host für Looker erreichbar ist . Mit dem Git-Verbindungstest wird außerdem überprüft, ob Sie einen gültigen Git-Bereitstellungsschlüssel angegeben 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 Schaltfläche Git der Text Git-Verbindung testen angezeigt. Sie werden dann aufgefordert, die Verbindung zu beheben.
Sie können auch über das Steuerfeld Git-Aktionen auf das Tool zum Testen der Git-Verbindung zugreifen:
Das Tool zum Testen der Git-Verbindung zeigt dann die Schritte an, die zum Testen der Git-Verbindung ausgeführt werden:
- git remote prüfen
- Hostname für Git-Dienst wird aufgelöst
- Die Netzwerkverbindung zum Git-Dienst ist aktiv.
- Anmeldedaten für die Autorisierung überprüfen
- Prüfen, ob die Anmeldedaten Schreibzugriff zulassen
Wenn ein Schritt erfolgreich war, zeigt Looker links neben dem Schritt ein grünes Häkchen an. Wenn ein Schritt fehlschlägt, wird in Looker links neben dem Schritt ein rotes Häkchen und eine Fehlermeldung angezeigt.
Das folgende Beispiel zeigt einen erfolgreichen Test:
Im folgenden Beispiel ist im Git-Repository kein Bereitstellungsschlüssel für die Looker-Verbindung konfiguriert. Die grünen Häkchen links neben den ersten drei Schritten zeigen an, dass diese 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 geben an, dass diese Schritte fehlgeschlagen sind:
Verify authorization credentials
Ensure credentials allow write access