Self-Service-Migration von Looker (Original) zu Looker (Google Cloud Core)

In diesem Dokument werden die technischen Schritte für die Migration Ihrer vorhandenen Looker-Instanz von der Looker-Umgebung (Original) zu Looker (Google Cloud Core) beschrieben.

Looker (Google Cloud Core) ist eine Bereitstellungsumgebung, die tief in die Google Cloud Platform eingebunden ist. Looker (Google Cloud Core) wird in der Google Cloud-Infrastruktur gehostet. Sie kann direkt über die Google Cloud Console verwaltet werden und ist umfassend in viele andere Produkte, Dienste und Funktionen von Google Cloud eingebunden.

Hinweise

  1. Machen Sie sich in der folgenden Dokumentation mit den Prinzipien und Tools von Google Cloud vertraut:
  2. Sprechen Sie mit Ihrem Kundenbetreuer über die Migration und darüber, ob Ihre Looker-Instanz (Original) infrage kommt. Wenn Ihre Instanz berechtigt ist und Sie Ihren vorhandenen Looker (Original)-Vertrag auf Looker (Google Cloud Core) aktualisiert haben, können Sie die Schritte in diesem Dokument ausführen, um Ihre Instanz zu migrieren.

  3. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Google Cloud-Projekt zu gewähren, in dem sich die Instanz von Looker (Google Cloud Core) befindet, um die Berechtigungen zu erhalten, die Sie zur Vorbereitung der Migration benötigen:

    • Erstellen Sie eine Looker-Instanz (Google Cloud Core): Looker-Administrator (roles/looker.admin).
    • Weisen Sie IAM-Rollen in Ihrem Google Cloud-Projekt zu: Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin).
    • Cloud Storage-Bucket erstellen: Storage-Administrator (roles/storage.admin)

    Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

    Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

  4. Wenn Sie die Looker-Instanz (Original) zur Vorbereitung auf die Migration verwalten möchten, müssen Sie in dieser Instanz die Looker-Rolle Administrator haben.

  5. Erstellen Sie eine neue „leere“ Looker (Google Cloud Core)-Instanz.

    Achten Sie darauf, die richtige Edition, den Typ der Netzwerkverbindung (öffentliche IP-Adresse oder private IP-Adresse) und andere Konfigurationsattribute (CMEK, VPC-SC) für Ihre neue Looker (Google Cloud Core)-Instanz auszuwählen, damit sie über die erforderlichen Funktionen verfügt. Einige Funktionen in Looker (Google Cloud Core) hängen von der ausgewählten Version oder dem ausgewählten Netzwerktyp ab.

    Lassen Sie die Instanz „leer“ und füllen Sie sie nicht mit Daten wie Modelldateien, Benutzern, Verbindungen, Explores, Dashboards oder Ordnern aus. Während des Imports werden alle Einstellungen oder Inhalte gelöscht und durch Daten aus der Migration ersetzt.

    Konfigurationsattribute von Looker (Google Cloud Core), die über die Google Cloud Console angegeben werden oder nur während der Instanzerstellung angegeben werden können, werden bei der Migration jedoch nicht überschrieben.

Überblick

Der Migrationsprozess besteht im Wesentlichen aus den folgenden Schritten.

  1. Prüfen Sie, ob Ihre Looker-Instanz (Original) für die Migration bereit ist.
  2. Exportieren Sie die Daten aus der Looker-Instanz (Original).
  3. Importieren Sie die Daten in die neue „leere“ Looker (Google Cloud Core)-Instanz.
  4. Einrichtung der Looker (Google Cloud Core)-Instanz abschließen
  5. Setzen Sie die Looker-Instanz (Original) außer Betrieb.

Die folgenden Abschnitte enthalten Details zu den einzelnen Schritten.

Achten Sie darauf, dass Ihre Looker-Instanz (Original) für die Migration bereit ist

Ihre Looker-Instanz (Original) muss die folgenden Voraussetzungen erfüllen, um für die Migration infrage zu kommen:

  • Ihre Looker-Instanz (Original) muss von Google verwaltet (also nicht vom Kunden gehostet) und in Google Cloud oder Amazon Web Services gehostet werden.

  • Ihre Looker-Instanz (Original) muss eine Version innerhalb eines monatlichen Release der aktuellen Looker (Google Cloud Core)-Version verwenden. Die aktuelle Version von Looker (Google Cloud Core) finden Sie in den Looker-Versionshinweisen. Sie finden dort auch die neueste Bereitstellungsankündigung.

Führen Sie außerdem vor der Migration die folgenden Aktivitäten aus:

  • Zwischen Looker (Original) und Looker (Google Cloud Core) gibt es einige Funktionsunterschiede. Überprüfen Sie diese Unterschiede, um sicherzustellen, dass die Features in Looker (Google Cloud Core) Ihren laufenden Anforderungen entsprechen.

  • Bei der Migration werden alle Projekte im Produktionsmodus und die darin enthaltenen Modelldateien kopiert, jedoch nicht die Projekte im Entwicklungsmodus, die einzelnen Nutzern gehören. Damit Dateien im Entwicklungsmodus während der Migration übertragen werden, müssen Sie vor Beginn der Migration alle Dateien in allen Projekten im Entwicklungsmodus an Git-Repositories übertragen.

  • Looker (Google Cloud Core) unterstützt nur die Authentifizierungsmethoden Google OAuth, SAML und OpenID Connect.

    • Wenn Ihre Looker-Instanz (Original) eine andere Authentifizierungsmethode verwendet (z. B. E-Mail-Adresse und Passwort, LDAP usw.), müssen Sie alle Nutzer in eine von Looker (Google Cloud Core) unterstützte Authentifizierungsmethode konvertieren.
    • Wenn Ihre Looker-Instanz (Original) bereits Google OAuth verwendet, werden alle Nutzerdatensätze übertragen. Sie müssen aber trotzdem IAM-Berechtigungen für die Nutzer im Projekt Ihrer Looker (Google Cloud Core)-Instanz manuell erstellen.
    • Wenn Ihre Looker-Instanz (Original) SAML verwendet, muss die Einstellung Nutzer zusammenführen auf der Seite SAML-Authentifizierung im Admin-Steuerfeld auf Google oder OIDC festgelegt sein, um Fehler beim Testen der SAML-Authentifizierung zu vermeiden.
    • Wenn Ihre Looker-Instanz (Original) OIDC verwendet, muss die Einstellung Nutzer zusammenführen mit auf der Seite OpenID Connect-Authentifizierung im Admin-Steuerfeld auf Google oder SAML festgelegt sein, um einen Fehler beim Testen der OpenID Connect-Authentifizierung zu vermeiden.
    • Wenn Sie einen externen Identitätsanbieter verwenden, müssen Sie die Callback-URL in Ihrem Identitätsanbieter auf die Looker-URL (Google Cloud Core) aktualisieren, um die Authentifizierung bei der neuen Looker (Google Cloud Core)-Instanz zu ermöglichen.
    • Wenn Ihre Instanz von Looker (Google Cloud Core) SAML oder OpenID Connect als Authentifizierungsmethode verwendet, wird empfohlen, auch Google OAuth einzurichten, das als Sicherungsauthentifizierungsmethode für Looker (Google Cloud Core) dient.
    • Wenn Sie eine benutzerdefinierte Domain mit Ihrer Looker (Google Cloud Core)-Instanz verwenden, richten Sie SAML oder OpenID Connect für die Instanz erst ein, wenn die benutzerdefinierte Domain aktiviert ist.

  • Während der Migration werden zwei Looker-Instanzen – eine Looker (Original) und eine Looker (Google Cloud Core) – für einen bestimmten Zeitraum parallel ausgeführt. Alle automatischen Aktivitäten, wie z. B. Benachrichtigungen und geplante Berichte, sowie Hintergrundaktivitäten, die auf Backend-Datenbanken zugreifen, können dupliziert werden. Löschen Sie automatische Benachrichtigungen und Zeitpläne in der Looker-Instanz (Original) oder der Looker-Instanz (Google Cloud Core), um doppelte Aktivitäten zu vermeiden.

Daten aus Ihrer Looker-Instanz (Original) exportieren

Für den Export der Daten aus Ihren Looker-Instanzen (Original) sind zwei Schritte erforderlich:

  1. Erstellen Sie einen Ort zum Speichern der Migrationsdaten.
  2. Starten Sie den Export.

Ort zum Speichern der Migrationsdaten erstellen

Führen Sie alle folgenden Vorgänge im selben Google Cloud-Projekt aus, in dem Sie die Looker (Google Cloud Core)-Instanz erstellt haben.

  1. Erstellen Sie einen neuen Cloud Storage-Bucket (z. B. <bucket-name>).
    • Dieser Bucket wird zum Speichern der Migrationsdaten verwendet.
    • Folgen Sie der Anleitung auf der Dokumentationsseite Buckets erstellen.
    • Die <bucket-name> muss in der gesamten Google Cloud eindeutig sein. Wir empfehlen, dem Bucket-Namen eine eindeutige Kennung wie etwa Ihre Projekt-ID als Präfix hinzuzufügen.
  2. Legen Sie einen Namen für einen Ordner im Cloud Storage-Bucket fest (z. B. <folder-name>). Erstellen Sie den Ordner jetzt nicht. Geben Sie den Ordnernamen während der Exportanfrage an. Es wird während des Exportvorgangs automatisch erstellt.
  3. Erstellen Sie einen Schlüsselbund und einen Schlüssel im Cloud KMS (z. B. <kms_keyring_id> und <kms-key-id>).
    • Dieser Schlüssel wird zum Verschlüsseln der Migrationsdaten verwendet. Da es sich um einen KMS-Schlüssel handelt, müssen Sie im Admin-Bereich von Looker (Original) auf der Seite Exportieren nur den Schlüsselnamen, nicht den Schlüssel selbst, offenlegen.
    • Folgen Sie der Anleitung auf den Dokumentationsseiten Schlüsselbund erstellen und Schlüssel erstellen.
  4. Erstellen Sie ein neues Dienstkonto speziell für die Migration (z. B. <export-service-account>).

  5. Weisen Sie <export-service-account> zwei spezifische IAM-Rollen zu:

  6. Erstellen Sie einen Dienstkontoschlüssel, der mit <export-service-account> verknüpft ist, und laden Sie die JSON-Schlüsseldatei herunter.

Export anfordern

Nachdem Sie sich vergewissert haben, dass Ihre Instanz für die Migration bereit ist, eine „leere“ Looker (Google Cloud Core)-Instanz erstellt und einen Ort zum Speichern von Migrationsdaten erstellt haben, geben Sie im Admin-Bereich Ihrer Looker-Instanz (Original) auf der Seite Exportieren die folgenden Informationen ein:

  • Der Name des von Ihnen erstellten Cloud Storage-Bucket.
  • Der Name des Cloud Storage-Ordners: Beim Exportieren wird automatisch ein Ordner mit diesem Namen erstellt. Wenn der Export abgeschlossen ist, werden die Exportdateien in diesem Ordner in einem von Ihnen erstellten Cloud Storage-Bucket in einem Unterordner mit Zeitstempel angezeigt.
  • Der KMS-Schlüsselname.
  • Der JSON-Text, der den Dienstkontoschlüssel enthält.

Wenn Sie die Informationen auf der Seite Exportieren eingegeben haben, klicken Sie auf Export anfordern, um den Export zu starten.

Der Export dauert Minuten bis Stunden. Sobald der Export abgeschlossen ist, sehen Sie in Ihrem Cloud Storage-Bucket und -Ordner mehrere Exportdateien (nicht für Menschen lesbar). Diese Dateien werden für den folgenden Importschritt eingegeben.

Daten in die neue „leere“ Looker (Google Cloud Core)-Instanz importieren

Nachdem die Instanzdaten exportiert wurden, können Sie sie in Ihre Looker (Google Cloud Core)-Instanz importieren.

Folgen Sie der Anleitung auf der Seite Daten aus Cloud Storage in eine Looker (Google Cloud Core)-Instanz importieren und verweisen Sie die Befehle auf den Bucket und den Ordner, in dem die Exportdateien gespeichert wurden.

Kurz gesagt bedeutet das Folgendes:

  1. Gewähren Sie dem Looker-Dienstkonto (nicht dem <export-service-account>) die folgenden Rollen für den Zugriff auf den Bucket und den KMS-Schlüssel:
  2. Import über die Google Cloud Console oder die gcloud CLI auslösen

Der Importvorgang dauert Minuten bis Stunden. Nach Abschluss des Vorgangs wird Ihre Looker (Google Cloud Core)-Instanz mit allen migrierten Daten neu gestartet.

Einrichtung der Looker (Google Cloud Core)-Instanz abschließen

Jetzt können Looker-Administratoren die Instanz-URL aufrufen und sich bei der Instanz anmelden, um die Einrichtung abzuschließen.

Bei der Migration wird so viel wie möglich von der Looker-Instanzkonfiguration (Original) kopiert. Einige Elemente können jedoch nicht migriert werden oder funktionieren etwas anders in Looker (Google Cloud Core) und müssen angepasst werden.

Zu den Punkten, die bekanntermaßen besondere Aufmerksamkeit erfordern, gehören:

Allgemeine Einstellungen (im **Admin**-Bereich von Looker)

Die meisten allgemeinen Einstellungen (und andere Einstellungen im **Admin**-Bereich) werden nicht automatisch kopiert, da sie in der Regel unterschiedlich sind oder nicht in derselben Form in Looker (Google Cloud Core) vorhanden sind. Sie sollten alle Einstellungen im Kontext Ihrer gewählten Looker (Google Cloud Core)-Konfiguration sorgfältig prüfen und konfigurieren. Weitere Informationen zu den Einstellungen in Looker (Google Cloud Core) finden Sie auf den Dokumentationsseiten Looker (Google Cloud Core)-Instanz mit Looker verwalten und Looker (Google Cloud Core)-Instanz über die Google Cloud Console verwalten.

Nutzer

Looker (Google Cloud Core) unterstützt nur die Authentifizierungsmethoden Google OAuth, SAML und OpenID Connect.

Wenn die Looker-Instanz (Original) auch für Google OAuth konfiguriert wurde, werden die Nutzerdatensätze und ihre Attribute kopiert (sofern sie in beiden Instanzen mit derselben Google-ID und E-Mail-Adresse verknüpft sind). Ein Projekt-IAM-Administrator muss jedem Nutzer die IAM-Rolle Looker-Administrator oder Looker-Instanznutzer für das Google Cloud-Projekt gewähren, in dem sich die Instanz befindet.

Wenn die Looker-Instanz (Original) für SAML oder OpenID Connect konfiguriert wurde, müssen Sie im Feld Nutzer zusammenführen, das für die Authentifizierungsmethode nur Authentifizierungsmethoden angeben, die von Looker (Google Cloud Core) unterstützt werden.

Wenn sich einige Nutzer der Looker-Instanz (Original) über einen Mechanismus authentifizieren, der in Looker (Google Cloud Core) nicht unterstützt wird (z. B. LDAP oder E-Mail-Adresse/Passwort), müssen diese Nutzerkonten neu erstellt und in eine unterstützte Authentifizierungsmethode umgewandelt werden.

Datenbankverbindungen

Looker (Google Cloud Core) unterstützt etwas andere Datenbankdialekte als Looker (Original). Alle Konfigurationseigenschaften für Datenbankverbindungen (einschließlich Verbindungsstring und Passwort, falls zutreffend) werden kopiert. Die unterschiedliche Netzwerktopologie in Looker (Google Cloud Core) kann jedoch verhindern, dass die Datenbankverbindungen sofort funktionieren. Wenn beispielsweise der Zugriff auf die Datenbanken über Firewalls oder Tunnel erfolgt, die spezifisch für die Looker-Instanz (Original) sind, müssen Sie die Firewalls oder Tunnel möglicherweise neu konfigurieren. Testen Sie jede Verbindung und stellen Sie sie bei Bedarf wieder her.

Git-Repository-Verbindungen

Wenn die Instanz reine Git-Repositories verwendet, sollten sie ohne Änderung funktionieren (kopiert, aber nicht freigegeben). Wenn die Instanz jedoch eine Verbindung zu Remote-Repositories herstellt, müssen diese Verbindungen möglicherweise, ähnlich wie die Datenbankverbindungen, überprüft und wieder aktiviert werden.

Andere Netzwerkkonfiguration

Die Looker-Instanz kann andere Arten von Netzwerkverbindungen (eingehend und ausgehend) haben, z. B. im Zusammenhang mit privaten IP-Adressen, Action Hub, Marketplace, E-Mails usw. Diese Netzwerkverbindungen müssen ebenfalls verifiziert werden.

URL für den Zugriff auf die Looker (Google Cloud Core)-Instanz

Die Instanz von Looker (Google Cloud Core) hat eine primäre URL, die zufällig zugewiesen wird. Wenn der Zugriff auf die Instanz über eine bestimmte URL erforderlich ist, können Sie eine benutzerdefinierte Domain konfigurieren.

Zeitpläne und Benachrichtigungen

Wenn sowohl die Looker (Original)- als auch die Looker (Google Cloud Core)-Instanz gleichzeitig aktiv ist, können doppelte geplante Aktionen und Benachrichtigungen generiert sowie doppelte Hintergrundvorgänge ausgeführt werden, die auf verbundene Datenbanken zugreifen. Diese Aktivitäten sollten so bald wie möglich in einer der Fälle deaktiviert werden.

Wartungsfenster

Anders als in Looker (Original) kann für Looker (Google Cloud Core) eine Wartungsrichtlinie festgelegt werden.

Elite-Systemaktivität

Daten zur Elite-Systemaktivität werden bei der Migration nicht kopiert. Die Instanz von Looker (Google Cloud Core) beginnt mit einem neuen Verlauf.

Benutzerdefinierte Domain

Sie können eine benutzerdefinierte Domain für Ihre Looker (Google Cloud Core)-Instanz erstellen. Sie müssen die DNS-Einträge festlegen, um die Bereitstellung des SSL-Zertifikats sicherzustellen. Achten Sie außerdem darauf, die Callback-URL in Ihrem Authentifizierungsclient auf die benutzerdefinierte Domain zu aktualisieren, sobald Ihre benutzerdefinierte Domain aktiviert und Ihre Authentifizierungsmethode eingerichtet ist. Benutzerdefinierte Domains können mit einer looker.com-Domain nicht für Looker (Google Cloud Core) erstellt werden.

Wenn Sie eine benutzerdefinierte Domain für Ihre Looker (Google Cloud Core)-Instanz mithilfe der benutzerdefinierten URL Ihrer Looker (Original)-Instanz erstellen möchten, sollte die benutzerdefinierte Domain nach Abschluss der Migration und nachdem Sie bestätigt haben, dass die Looker (Google Cloud Core)-Instanz einsatzbereit ist, eingerichtet werden. Sobald die benutzerdefinierte Domain aktiviert ist, sehen Ihre Nutzer beim Aufrufen der Instanz-URL die Looker (Google Cloud Core)-Instanz und nicht die Looker-Instanz (Original).

Richten Sie SAML oder OpenID Connect für die Looker (Google Cloud Core)-Instanz erst dann ein, wenn die Instanz einsatzbereit ist, die DNS-Einträge aktualisiert und die benutzerdefinierte Domain aktiviert wurden.

Lesezeichen

Wenn Sie in Ihrer Looker-Instanz (Original) eine benutzerdefinierte URL verwenden (nicht die Domain looker.com), sollten bei dieser Migration die Lesezeichen der Nutzer beibehalten werden, wenn Sie eine benutzerdefinierte Domain für Ihre Looker (Google Cloud Core)-Instanz mit derselben URL wie Ihre Looker-Instanz (Original) erstellen.

Sobald die benutzerdefinierte Domain aktiviert wurde, verweisen Lesezeichen für Looker (Original)-Inhalte wie https://www.yourcustomdomain.com/dashboard/123 auf den Inhalt in der Looker (Google Cloud Core)-Instanz. Hinweis: Bei den Versionen Enterprise und Embed von Looker (Google Cloud Core) werden in den URLs alphanumerische Slugs anstelle von numerischen Content-IDs verwendet. Ein Lesezeichen mit einer Content-ID leitet jedoch weiterhin korrekt zu denselben Inhalten weiter.

Dieser Vorgang kann nicht mit Looker-URLs (Original) verwendet werden, die die Domain looker.com verwenden.

Diese Liste ist nicht vollständig. Testen Sie alle Aspekte der Instanz, die für Sie am wichtigsten sind, bevor Sie die Migration als abgeschlossen betrachten.

Sobald die Migration abgeschlossen ist und Sie sicher sind, dass Sie keinen weiteren Export benötigen, können Sie die zuvor erstellte <export-service-account> löschen. Dadurch wird der für sie freigegebene JSON-Schlüssel unbrauchbar.

Looker-Instanz (Original) außer Betrieb nehmen

Sobald die migrierte Looker (Google Cloud Core)-Instanz zufriedenstellend funktioniert, können Sie Ihren Nutzern die URL der Instanz senden. Weisen Sie sie dann an, auf die Looker-Instanz (Original) zuzugreifen.

Fehlerbehebung

Die folgenden Abschnitte helfen Ihnen möglicherweise dabei, Probleme beim Import oder Export zu beheben.

Probleme beim Export

Falls beim Export Ihrer Looker-Daten (Original) ein Problem auftritt, wird im Bereich Admin auf der Seite Exportieren der Status FEHLER angezeigt. Wenn Sie auf den Status FEHLER klicken, wird eine Fehlermeldung angezeigt.

Häufige Fehlerquellen sind:

  • Der Cloud Storage-Bucket, der KMS-Schlüssel oder <export-service-account> sind ungültig.
  • Dem <export-service-account> fehlen die erforderlichen Berechtigungen.

Es ist hilfreich, den Status dieser Objekte zu prüfen, bevor Sie die Exportanfrage senden.

Probleme beim Import

Wenn der Importvorgang nach vier Stunden noch nicht abgeschlossen ist (oder möglicherweise länger, wenn die Quellinstanz sehr groß war) oder er fälschlicherweise beendet wird, müssen Sie möglicherweise ein Ticket bei Cloud Customer Care erstellen, um das Problem zu beheben. Es gibt relativ wenige Diagnosen, die Kunden für diesen Vorgang direkt sichtbar sind.

Nächste Schritte