Erweiterter Bereitstellungsmodus

Bei der standardmäßigen Looker-Git-Integration führen Looker-Entwickler ihre Änderungen per Commit in ihren Entwicklungszweig ein und führen diesen dann mit dem Produktionszweig zusammen. Wenn Sie dann in der Looker-Umgebung bereitstellen, verwendet Looker den neuesten Commit im Produktions-Branch. Informationen zum standardmäßigen Git-Workflow und zu anderen Optionen für erweiterte Git-Implementierungen finden Sie auf der Dokumentationsseite Versionsverwaltung verwenden und bereitstellen.

Bei erweiterten Git-Implementierungen, bei denen der letzte Commit in Ihrem Produktionszweig nicht für Ihre Looker-Umgebung verwendet werden soll, kann ein Looker-Administrator den erweiterten Bereitstellungsmodus aktivieren. Wenn der erweiterte Bereitstellungsmodus aktiviert ist, kann ein Entwickler mit der Berechtigung deploy einen anderen Commit-SHA oder ein anderes Tag für die Bereitstellung in Ihrer Looker-Produktionsumgebung angeben, anstatt den neuesten Commit im Produktionszweig zu verwenden. Wenn Sie einen Commit aus einem anderen Branch bereitstellen möchten, können Sie den erweiterten Bereitstellungsmodus Webhook oder API-Endpunkt verwenden.

Der erweiterte Bereitstellungsmodus hilft, Repositorys in Entwickler-Workflows mit mehreren Umgebungen zu konsolidieren, in denen jede Umgebung auf eine andere Version einer Codebasis verweist. Außerdem erhalten ein oder mehrere Entwickler oder Administratoren mehr Kontrolle über die Änderungen, die in der Produktion bereitgestellt werden.

Wenn der erweiterte Bereitstellungsmodus aktiviert ist, werden Entwickler in Looker nicht aufgefordert, ihre Änderungen in der Produktion bereitzustellen. Stattdessen werden Entwickler in Looker aufgefordert, ihre Änderungen mit dem Produktionszweig zusammenzuführen. Änderungen können nur auf folgende Weise bereitgestellt werden:

• Deployment Manager verwenden
• Webhook auslösen
• API-Endpunkt verwenden

Hinweis: Bei Projekten, für die der erweiterte Bereitstellungsmodus aktiviert ist, muss die erste Bereitstellung in der Produktion mit dem Bereitstellungsmanager erfolgen, wenn das Projekt noch nie in der Produktion bereitgestellt wurde. Sie können die API oder den Webhook nicht für die Erstbereitstellung eines Projekts verwenden, für das der erweiterte Bereitstellungsmodus aktiviert ist. Nach der ersten Bereitstellung in der Produktionsumgebung (auch wenn sie ursprünglich ohne den erweiterten Bereitstellungsmodus bereitgestellt wurde) können Sie den Webhook oder die API verwenden, um nachfolgende Änderungen mit dem erweiterten Bereitstellungsmodus in der Produktionsumgebung bereitzustellen.

Erweiterten Bereitstellungsmodus aktivieren

So aktivieren Sie den erweiterten Bereitstellungsmodus:

1. Rufen Sie in der Looker-IDE die Seite Projektkonfiguration auf. Klicken Sie dazu im Symbolmenü auf das Symbol Einstellungen und wählen Sie dann den Tab Konfiguration aus.
2. Setzen Sie auf der Seite Projektkonfiguration im Bereich Bereitstellung ein Häkchen neben Erweiterten Bereitstellungsmodus aktivieren.
3. Klicken Sie auf die Schaltfläche Projektkonfiguration speichern, um die Änderung zu speichern.

Versionsverwaltung mit dem erweiterten Bereitstellungsmodus

Wenn der erweiterte Bereitstellungsmodus aktiviert ist, können Entwickler nicht mehr über Looker in der Produktionsumgebung bereitstellen. Stattdessen werden Entwickler beim Ausführen eines Commits über die Git-Schaltfläche aufgefordert, ihre Änderungen mit dem primären Branch zusammenzuführen, anstatt sie für die Produktion bereitzustellen.

Änderungen werden über einen Webhook, die API oder den Deployment Manager in der Produktion bereitgestellt.

Deployment Manager

Bei Projekten mit aktiviertem erweiterten Bereitstellungsmodus können Looker-Entwickler mit der Berechtigung deploy den Bereitstellungsmanager verwenden, um einen Commit oder ein Tag in ihrer Looker-Produktionsumgebung bereitzustellen.

Sie können auf den Deployment Manager zugreifen, indem Sie im Symbolmenü das Symbol Bereitstellen auswählen.

Im Deployment Manager werden alle Commits und Tags angezeigt, die zuvor im erweiterten Bereitstellungsmodus bereitgestellt wurden.

Hinweis :Wie im Abschnitt Commit über den Deployment Manager bereitstellen auf dieser Seite beschrieben, können Sie ein Commit mit oder ohne Tag bereitstellen. Wenn Sie einen Commit mit einem Tag bereitstellen, wird im Deployment Manager die Tag-SHA angezeigt, die sich von einer Commit-SHA unterscheidet. Im Commit-Verlauf Ihres Looker-Projekts können Sie die Commit-SHA sehen, die einem Tag zugeordnet ist. Wenn Sie einen Commit ohne Tag bereitstellen, wird im Deployment Manager der Commit-SHA angezeigt. Dieser ist derselbe wie der Commit-SHA, den Sie in der Benutzeroberfläche Ihres Git-Anbieters oder im Commit-Verlauf Ihres Looker-Projekts sehen.

Wenn Sie den erweiterten Bereitstellungsmodus noch nicht zum Bereitstellen eines Commits verwendet haben, klicken Sie auf die Schaltfläche Commit auswählen, um den Commit-Verlauf mit den Commits aufzurufen, die Ihre Looker-Entwickler in den Produktionszweig zusammengeführt haben.

Bei Projekten, bei denen ein Commit im erweiterten Bereitstellungsmodus bereitgestellt wurde, werden im Commit-Verlauf auch die zugehörigen Tags eines Commits (falls vorhanden) angezeigt. Außerdem wird angegeben, welcher Commit die aktuelle Version ist, die für die Produktion verwendet wird.

Wenn der Produktionszweig neuere Commits als der bereitgestellte Commit enthält, werden diese Informationen vom Deployment Manager angezeigt. Außerdem wird der neueste Commit angezeigt, den Ihre Looker-Entwickler in den Produktionszweig zusammengeführt haben.

Commit über den Deployment Manager bereitstellen

Es gibt mehrere Möglichkeiten, einen Commit über den Bereitstellungsmanager bereitzustellen:

1. Wenn Sie einen Commit bereitstellen möchten, der noch nicht bereitgestellt wurde, klicken Sie auf die Schaltfläche Commit auswählen, um einen der Commits auszuwählen, die in den Remote-Produktionszweig zusammengeführt wurden. Wenn Sie einen Commit aus einem anderen Branch bereitstellen möchten, verwenden Sie den erweiterten Bereitstellungsmodus Webhook oder API-Endpunkt.
2. Wenn Sie den zuletzt zusammengeführten Commit im Remote-Produktionszweig bereitstellen möchten, klicken Sie auf die Schaltfläche Deploy Latest (Neueste Version bereitstellen).
3. Wenn Sie einen Commit oder ein Tag bereitstellen möchten, der bzw. das bereits bereitgestellt wurde, klicken Sie im Bereitstellungsmanager auf das Dreipunkt-Menü Optionen  und dann auf In der Produktion bereitstellen.

Wenn Sie einen Commit auswählen, der noch nicht bereitgestellt wurde, wird im Deployment Manager das Menü Commit bereitstellen angezeigt. So stellen Sie einen Commit über das Menü Deploy Commit (Commit bereitstellen) bereit:

1. Wenn Sie den Commit bereitstellen möchten, ohne ihm ein Tag zuzuweisen, wählen Sie Deploy without tagging (Ohne Tagging bereitstellen) und dann Deploy to Environment (In Umgebung bereitstellen) aus. Lassen Sie andernfalls die Option Tag and deploy (Taggen und bereitstellen) ausgewählt.

2. Geben Sie ein Tag für den Commit an. Ein Git-Tag kennzeichnet die Bedeutung des Commits im Verlauf des Repositorys, z. B. eine Release-Nummer oder einen Versionsnamen. Beachten Sie Folgendes zu Git-Tags:

   • Git-Tags müssen innerhalb des Git-Repositorys eindeutig sein. Sie können nicht dasselbe Tag für zwei verschiedene Commits in Ihrem Repository verwenden.
   • Git-Tags dürfen keine Leerzeichen oder bestimmte Sonderzeichen enthalten. Informationen zu den Regeln für die Benennung von Referenzen in Git finden Sie in der Git-Referenz.

3. Optional können Sie eine Beschreibung für das Tag hinzufügen, um weitere Details zum Commit anzugeben.

4. Wählen Sie In Umgebung bereitstellen aus, um den Commit in der Produktionsversion Ihrer Looker-Instanz bereitzustellen.

Wenn Sie einen Commit bereitstellen, markiert der Bereitstellungsmanager den Commit als aktuelle Version in Ihrer Looker-Produktionsumgebung.

Mit Webhooks bereitstellen

Bei Projekten mit dem erweiterten Bereitstellungsmodus können Sie den Bereitstellungs-Webhook verwenden, um Änderungen in der Produktion bereitzustellen.

Hinweis :Wenn der erweiterte Bereitstellungsmodus für ein neues Projekt aktiviert ist, müssen Sie für die erste Bereitstellung des Projekts in der Produktion den Deployment Manager verwenden. Nachdem Ihr Projekt in der Produktionsumgebung bereitgestellt wurde (auch wenn es anfangs ohne den erweiterten Bereitstellungsmodus bereitgestellt wurde), können Sie den Bereitstellungs-Webhook verwenden, um nachfolgende Änderungen mithilfe des erweiterten Bereitstellungsmodus in der Produktionsumgebung bereitzustellen.

Wenn Sie den Bereitstellungs-Webhook einrichten möchten, müssen Sie zuerst ein Webhook-Secret für Ihr Looker-Projekt auf der Seite Projektkonfiguration hinzufügen. Wenn Sie ein Webhook-Secret hinzufügen, können nur autorisierte Parteien den Bereitstellungs-Webhook auslösen.

Es sind zwei Webhooks verfügbar, um Änderungen in der Produktion bereitzustellen, wenn der erweiterte Bereitstellungsmodus aktiviert ist. Ein Webhook dient zum Bereitstellen des Kopfes einer Verzweigung und der andere zum Bereitstellen eines bestimmten Git-SHA oder ‑Tags.

Der Webhook zum Bereitstellen des Head eines Branch hat folgendes Format:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>

Der Webhook zum Bereitstellen eines Commit-SHA oder -Tags hat folgendes Format:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>

Ersetzen Sie die Informationen in den spitzen Klammern < > durch die Informationen, die für Ihre Instanzadresse, Ihr LookML-Projekt und Ihren Branch-Namen oder Commit-SHA/Tag spezifisch sind. Hier ist ein Beispiel-Webhook zum Bereitstellen des v1.0-Tag-Namens für das e_faa-Projekt in der docsexamples.dev.looker.com-Looker-Instanz:

https://docsexamples.dev.looker.com/webhooks/projects/e_faa/deploy/ref/v1.0

Mit der API bereitstellen

Bei Projekten mit dem erweiterten Bereitstellungsmodus können Sie die Looker API verwenden, um Änderungen in der Produktion bereitzustellen.

Hinweis :Wenn der erweiterte Bereitstellungsmodus für ein neues Projekt aktiviert ist, müssen Sie für die erste Bereitstellung des Projekts in der Produktion den Deployment Manager verwenden. Sobald Ihr Projekt in der Produktionsumgebung bereitgestellt wurde (auch wenn es anfangs ohne den erweiterten Bereitstellungsmodus bereitgestellt wurde), können Sie die API verwenden, um nachfolgende Änderungen mithilfe des erweiterten Bereitstellungsmodus in der Produktionsumgebung bereitzustellen.

Für die Bereitstellung mit der API muss der API-Nutzer, der den Aufruf ausführt, die Berechtigung deploy haben. Weitere Informationen zur Authentifizierung und Verwendung der Looker API finden Sie in den Dokumentationsseiten Looker API-Authentifizierung und Erste Schritte mit der API.

Verwenden Sie den Endpunkt deploy_ref_to_production, um die Bereitstellung mit der API vorzunehmen. Dieser Endpunkt kann auf verschiedene Arten aufgerufen werden. Die folgenden Beispiele beziehen sich auf die Methoden HTTPS und SDK.

HTTPS

Hinweis :Wenn Sie die folgenden Beispiele verwenden, müssen Sie die Informationen in den spitzen Klammern < > durch die Informationen ersetzen, die für Ihre Instanzadresse, Ihr LookML-Projekt, Ihren Zweignamen, Ihren SHA oder Ihr Tag spezifisch sind.

Wenn Sie die Bereitstellung manuell über den API-Endpunkt deploy_ref_to_production vornehmen möchten, sehen Sie sich die folgenden Beispiele an, in denen die HTTPS-Methode verwendet wird. Weitere Informationen und Beispiele für das manuelle Aufrufen der API mit CURL-Anfragen finden Sie in der GitHub-Readme-Datei zur Authentifizierung bei der API oder im API Explorer. Sie können den API Explorer über den Looker Marketplace in Ihrer Looker-Instanz installieren.

Verwenden Sie die folgenden Beispiele in einer HTTPS-Anfrage, um entweder den Head eines Branch oder einen bestimmten Commit-SHA oder ein bestimmtes Tag über den deploy_ref_to_production-API-Endpunkt bereitzustellen:

Head eines Branch bereitstellen: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>

Commit-SHA oder Tag bereitstellen: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>

SDK

Hinweis :Wenn Sie die folgenden Beispiele verwenden, müssen Sie die Informationen in den spitzen Klammern < > durch die Informationen ersetzen, die für Ihr LookML-Projekt und Ihren Branch-Namen, SHA oder Ihr Tag spezifisch sind.

Alternativ können Sie eines der SDKs von Looker verwenden, anstatt manuelle Anfragen an die API zu senden. SDKs kümmern sich um die Authentifizierung, die Serialisierung von Parametern und Antworten sowie andere Aspekte.

Die Bereitstellung mit dem deploy_ref_to_production mit der SDK-Methode sieht so aus:

Head eines Branch bereitstellen: deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})

Commit-SHA oder Tag bereitstellen: deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})