Looker (Google Cloud Core)-Instanz mit öffentlichen verschlüsselten Verbindungen erstellen

Auf dieser Seite wird beschrieben, wie Sie eine Looker-Produktionsinstanz (Google Cloud Core) oder eine Looker-Instanz für Nicht-Produktionsumgebungen bereitstellen, die für öffentliche verschlüsselte Verbindungen konfiguriert ist.

Wenn Sie eine Instanz mit privaten Verbindungen erstellen möchten, muss die Konfiguration beim Erstellen der Instanz zugewiesen werden. Eine Anleitung zum Erstellen einer Instanz mit privaten Verbindungen finden Sie auf den Dokumentationsseiten Looker-Instanz (Google Cloud Core) mit Private Service Connect erstellen oder auf den Seiten Looker-Instanz (Google Cloud Core) mit privaten Verbindungen (Zugriff auf private Dienste) erstellen. Folgen Sie nicht der unten beschriebenen Vorgehensweise.

Hinweis

  1. Wenden Sie sich an den Vertrieb, um sicherzustellen, dass Ihr Jahresvertrag abgeschlossen ist und Sie in Ihrem Projekt ein Kontingent zugewiesen haben.
  2. Achten Sie darauf, dass die Abrechnung für Ihr Google Cloud Projekt inaktiviert ist.
  3. Erstellen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud Projekt oder rufen Sie ein vorhandenes Projekt auf.

    Zur Projektauswahl

  4. Aktivieren Sie die Looker API für Ihr Projekt in der Google Cloud Console. Wenn Sie die API aktivieren, müssen Sie die Seite der Console möglicherweise aktualisieren, um zu bestätigen, dass die API aktiviert wurde.

    API aktivieren

  5. Wenn Sie VPC Service Controls verwenden möchten, müssen Sie eine Instanz mit privaten Verbindungen (Zugriff auf private Dienste) anstelle einer Instanz mit öffentlichen verschlüsselten Verbindungen erstellen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Looker Admin (roles/looker.admin) IAM-Rolle für das Projekt zuzuweisen, in dem sich die Instanz befinden soll, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Looker-Instanz (Google Cloud Core) benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

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

Möglicherweise benötigen Sie auch zusätzliche IAM-Rollen, wenn Sie kundenverwaltete Verschlüsselungsschlüssel (Customer-managed Encryption Keys, CMEK) einrichten möchten. Weitere Informationen finden Sie auf der Seite Zugriffssteuerung mit IAM in der Cloud Key Management Service-Dokumentation.

Looker-Instanz (Google Cloud Core) erstellen

Looker (Google Cloud Core) erfordert etwa 60 Minuten, um eine neue Instanz zu generieren.

Wählen Sie eine der folgenden Optionen aus, um Ihre Looker-Instanz (Google Cloud Core) zu erstellen:

Console

  1. Rufen Sie in der Google Cloud Console in Ihrem Projekt die Looker-Produktseite (Google Cloud Core) auf. Wenn Sie in diesem Projekt bereits eine Looker-Instanz (Google Cloud Core) erstellt haben, wird die Seite Instanzen geöffnet.

    Looker (Google Cloud Core) aufrufen

  2. Klicken Sie auf INSTANZ ERSTELLEN.
  3. Geben Sie im Abschnitt Instanzname einen Namen für Ihre Looker-Instanz (Google Cloud Core) ein. Der Instanzname ist nach dem Erstellen nicht mit der URL der Looker-Instanz (Google Cloud Core) verknüpft. Der Instanzname kann nach dem Erstellen der Instanz nicht mehr geändert werden.
  4. Wählen Sie im Bereich Region die gewünschte Option aus dem Drop-down-Menü aus, um Ihre Looker-Instanz (Google Cloud Core) zu hosten. Wählen Sie die Region aus, die der Region im Abovertrag entspricht, da dort das Kontingent für Ihr Projekt zugewiesen wird. Die verfügbaren Regionen sind auf der Dokumentationsseite Looker-Standorte (Google Cloud Core) aufgeführt. Sie können die Region nicht mehr ändern, nachdem die Instanz erstellt wurde.

  5. Legen Sie im Bereich Version die Instanzversion entsprechend den Anforderungen Ihrer Organisation fest. Der Versionstyp wirkt sich auf einige der für die Instanz verfügbaren Funktionen aus. Achten Sie darauf, dass Sie denselben Versionstyp auswählen, der in Ihrem Jahresvertrag aufgeführt ist, und dass Sie ein Kontingent für diesen Versionstyp zugewiesen haben. Folgende Versionen sind verfügbar:

    • Standard: Looker-Plattform (Google Cloud Core) für kleine Organisationen oder Teams mit weniger als 50 Nutzern
    • Enterprise: Looker-Plattform (Google Cloud Core) mit erweiterten Sicherheitsfunktionen für eine Vielzahl interner BI- und Analyseanwendungsfälle
    • Embed: Looker-Plattform (Google Cloud Core) zum Bereitstellen und Verwalten vieler zuverlässiger externer Analysen und benutzerdefinierter Anwendungen
    • Nicht-Produktionsversionen: Wenn Sie eine Staging- und Testumgebung benötigen, wählen Sie eine der Nicht-Produktionsversionen aus. Weitere Informationen finden Sie in der Dokumentation zu Nicht-Produktionsinstanzen.
    • Testversionen: Eine Testversion bietet dieselbe Funktionsunterstützung wie die entsprechende Produktionsversion. Testversionen sind jedoch 90 Tage lang gültig.

    Nach dem Erstellen einer Instanz sind Änderungen an Versionen nicht mehr möglich. Wenn Sie eine Version ändern möchten, können Sie Ihre Looker-Instanzdaten (Google Cloud Core) mit Importieren und Exportieren in eine neue Instanz verschieben, die mit einer anderen Version konfiguriert ist.

  6. Klicken Sie im Abschnitt Instanz anpassen auf Konfigurationsoptionen einblenden , um eine Gruppe zusätzlicher Einstellungen aufzurufen, die Sie für die Instanz anpassen können.

  7. Wählen Sie im Abschnitt Verbindungen die Option Öffentliche verschlüsselte Verbindungen verwenden aus. Mit der Einstellung für öffentliche verschlüsselte Verbindungen wird eine externe, über das Internet zugängliche IP-Adresse zugewiesen. Sie ist für alle Versionstypen verfügbar.

  8. Wenn Sie eine Instanz der Version Enterprise oder Embed erstellen, wird der Abschnitt Verschlüsselung angezeigt. Im Abschnitt Verschlüsselung können Sie den Verschlüsselungstyp auswählen, der für Ihre Instanz verwendet werden soll. Folgende Verschlüsselungsoptionen sind verfügbar:

  9. Wählen Sie im Abschnitt Release-Version die Release-Version aus, die Ihren Anforderungen am besten entspricht:

    • Rapid: Frühester Zugriff auf Funktionen. Empfohlene Standardeinstellung für Nicht-Produktionsinstanzen.
    • Regular: Ausgewogene Stabilität. Wird für Produktionsinstanzen empfohlen.
    • Keine Version: Keine Release-Version. Während der Vorabversion ist „Keine Version“ die Standardeinstellung.

  10. Im Abschnitt Wartungsfenster können Sie optional den Wochentag und die Stunde angeben, zu der Looker (Google Cloud Core) die Wartung plant.

  11. Im Abschnitt Wartungszeitraum ablehnen können Sie optional einen Zeitraum angeben, in dem Looker (Google Cloud Core) keine Wartung plant. Sie können keinen Wartungszeitraum ablehnen, wenn Sie die Instanz auch in der Rapid-Release-Version registrieren oder das Konfigurationsflag für beschleunigte Sicherheitspatches (Accelerated Security Patching, ASP) mit der Regular-Release-Version verwenden.

  12. Im Abschnitt Gemini in Looker können Sie optional Gemini in Looker-Funktionen für die Looker-Instanz (Google Cloud Core) verfügbar machen. Wenn Sie Gemini in Looker aktivieren möchten, wählen Sie Gemini und dann Trusted Tester-Funktionen aus. Wenn Trusted Tester-Funktionen aktiviert ist, können Nutzer auf die Trusted Tester-Funktionen von Gemini in Looker zugreifen. Sie können den Zugriff auf nicht öffentliche Trusted Tester-Funktionen über das Formular für die Vorabversion von Gemini in Looker auf Nutzerbasis anfordern. Sie müssen diese Einstellung aktivieren, um Gemini während der pre-GA-Vorschau zu verwenden. Optional können Sie Trusted Tester-Datennutzung auswählen. Wenn diese Einstellung aktiviert ist, stimmen Sie zu, dass Ihre Daten von Google gemäß den Nutzungsbedingungen für das Gemini für Google Cloud Trusted Tester-Programm verwendet werden. Wenn Sie Gemini für eine Looker-Instanz (Google Cloud Core) deaktivieren möchten, deaktivieren Sie die Einstellung Gemini.

  13. Im Abschnitt Knowledge Catalog-Einbindung können Sie optional das Kästchen Knowledge Catalog-Einbindung deaktivieren auswählen, wenn Looker (Google Cloud Core) nicht in Knowledge Catalog eingebunden werden soll. Looker (Google Cloud Core) und Knowledge Catalog sind standardmäßig eingebunden.

  14. Klicken Sie auf Erstellen.

gcloud

  1. Wenn Sie CMEK verwenden, erstellen Sie zuerst das Looker-Dienstkonto und folgen Sie der Anleitung zum Einrichten von CMEK.

  2. Erstellen Sie die Instanz mit dem Befehl gcloud looker instances create:

    gcloud looker instances create INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION \
--edition=EDITION \
[--release-channel=RELEASE_CHANNEL]\
--public-ip-enabled \
--async

    Ersetzen Sie Folgendes:

    • INSTANCE_NAME: ein Name für Ihre Looker-Instanz (Google Cloud Core). Er ist nicht mit der Instanz-URL verknüpft.
    • PROJECT_ID: der Name des Google Cloud Projekts, in dem Sie die Looker-Instanz (Google Cloud Core) erstellen.
    • REGION: die Region, in der Ihre Looker-Instanz (Google Cloud Core) gehostet wird. Wählen Sie die Region aus, die der Region im Abovertrag entspricht. Die verfügbaren Regionen sind auf der Dokumentationsseite Looker-Standorte (Google Cloud Core) aufgeführt. Sie können die Region nicht mehr ändern, nachdem die Instanz erstellt wurde.
    • EDITION: die Version, der Umgebungstyp (Produktion oder Nicht-Produktion) und ob es sich um eine Testversion für die Instanz handelt. Die verfügbaren Werte sind core-standard-annual, core-enterprise-annual, core-embed-annual, nonprod-core-standard-annual, nonprod-core-enterprise-annual, nonprod-core-embed-annual, core-trial-standard, core-trial-enterprise und core-trial-embed. Nach dem Erstellen einer Instanz sind Änderungen an Versionen nicht mehr möglich. Wenn Sie eine Version ändern möchten, können Sie Ihre Looker-Instanzdaten (Google Cloud Core) mit Importieren und Exportieren in eine neue Instanz verschieben, die mit einer anderen Version konfiguriert ist.
    • RELEASE_CHANNEL: die Release-Version für die Instanz. Verfügbare Werte sind rapid, regular und no-channel. Während der Vorabversion ist no-channel die Standardeinstellung. Wenn Sie dieses Flag nicht in den Befehl create aufnehmen, wird die Instanz mit der Standardversion erstellt. Diese Funktion befindet sich in der Vorabversion.

    Fügen Sie auch diese Flags hinzu:

    • --public-ip-enabled wird verwendet, um die öffentliche verschlüsselte Verbindung zu aktivieren.
    • --async wird empfohlen, wenn Sie eine Looker-Instanz (Google Cloud Core) erstellen.

  3. Sie können weitere Parameter hinzufügen, um andere Instanzeinstellungen anzuwenden: 

    [--maintenance-window-day=MAINTENANCE_WINDOW_DAY
      --maintenance-window-time=MAINTENANCE_WINDOW_TIME]
[--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
      --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
      --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME]
[--kms-key=KMS_KEY_ID]
[--accelerated-security-patch-enabled]
[--no-accelerated-security-patch-enabled]
[--fips-enabled]
[--catalog-integration-enabled]
[--no-catalog-integration-enabled]

    Ersetzen Sie Folgendes:

    Die folgenden Flags aktivieren andere Einstellungen:

Terraform

Verwenden Sie die folgende Terraform Ressource, um eine Standard Looker-Instanz (Google Cloud Core) mit grundlegenden Funktionen bereitzustellen:

# Creates a Standard edition Looker (Google Cloud core) instance with basic functionality enabled.
resource "google_looker_instance" "main" {
  name             = "my-instance"
  platform_edition = "LOOKER_CORE_STANDARD"
  region           = "us-central1"
  oauth_config {
    client_id     = "my-client-id"
    client_secret = "my-client-secret"
  }
}

Verwenden Sie die folgende Terraform Ressource, um eine Standard Looker-Instanz (Google Cloud Core) mit zusätzlichen Einstellungen bereitzustellen:

# Creates a Standard edition Looker (Google Cloud core) instance with full functionality enabled.

resource "google_looker_instance" "main" {
  name              = "my-instance"
  platform_edition  = "LOOKER_CORE_STANDARD"
  region            = "us-central1"
  public_ip_enabled = true
  admin_settings {
    allowed_email_domains = ["google.com"]
  }
  // User metadata config is only available when platform edition is LOOKER_CORE_STANDARD.
  user_metadata {
    additional_developer_user_count = 10
    additional_standard_user_count  = 10
    additional_viewer_user_count    = 10
  }
  maintenance_window {
    day_of_week = "THURSDAY"
    start_time {
      hours   = 22
      minutes = 0
      seconds = 0
      nanos   = 0
    }
  }
  deny_maintenance_period {
    start_date {
      year  = 2050
      month = 1
      day   = 1
    }
    end_date {
      year  = 2050
      month = 2
      day   = 1
    }
    time {
      hours   = 10
      minutes = 0
      seconds = 0
      nanos   = 0
    }
  }
  oauth_config {
    client_id     = "my-client-id"
    client_secret = "my-client-secret"
  }
}

Verwenden Sie die folgende Terraform Ressource, um eine Enterprise Looker-Instanz (Google Cloud Core) mit einer privaten Netzwerkverbindung bereitzustellen:

# Creates an Enterprise edition Looker (Google Cloud core) instance with full, Private IP functionality.
resource "google_looker_instance" "main" {
  name               = "my-instance"
  platform_edition   = "LOOKER_CORE_ENTERPRISE_ANNUAL"
  region             = "us-central1"
  private_ip_enabled = true
  public_ip_enabled  = false
  reserved_range     = google_compute_global_address.main.name
  consumer_network   = data.google_compute_network.main.id
  admin_settings {
    allowed_email_domains = ["google.com"]
  }
  encryption_config {
    kms_key_name = google_kms_crypto_key.main.id
  }
  maintenance_window {
    day_of_week = "THURSDAY"
    start_time {
      hours   = 22
      minutes = 0
      seconds = 0
      nanos   = 0
    }
  }
  deny_maintenance_period {
    start_date {
      year  = 2050
      month = 1
      day   = 1
    }
    end_date {
      year  = 2050
      month = 2
      day   = 1
    }
    time {
      hours   = 10
      minutes = 0
      seconds = 0
      nanos   = 0
    }
  }
  oauth_config {
    client_id     = "my-client-id"
    client_secret = "my-client-secret"
  }
  depends_on = [
    google_service_networking_connection.main,
    google_kms_crypto_key.main
  ]
}

resource "google_kms_key_ring" "main" {
  name     = "keyring-example"
  location = "us-central1"
}

resource "google_kms_crypto_key" "main" {
  name     = "crypto-key-example"
  key_ring = google_kms_key_ring.main.id
}

resource "google_service_networking_connection" "main" {
  network                 = data.google_compute_network.main.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.main.name]
}

resource "google_compute_global_address" "main" {
  name          = "looker-range"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 20
  network       = data.google_compute_network.main.id
}

data "google_project" "main" {}

data "google_compute_network" "main" {
  name = "default"
}

resource "google_kms_crypto_key_iam_member" "main" {
  crypto_key_id = google_kms_crypto_key.main.id
  role          = "roles/cloudkms.cryptoKeyEncrypterDecrypter"
  member        = "serviceAccount:service-${data.google_project.main.number}@gcp-sa-looker.iam.gserviceaccount.com"
}

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Das Erstellen einer Instanz kann nach dem Start nicht mehr angehalten oder beendet werden. Wenn Ihre Terraform-Ressource erfolgreich bereitgestellt wurde, wird in Ihrem Terminal die folgende Meldung angezeigt:

Creation complete after XmXs [id=projects/PROJECT-ID/locations/REGION/instances/my-instance-randomly-generated-name]


Apply complete! Resources: X added, X changed, X destroyed.

Während die Instanz erstellt wird, können Sie ihren Status in der Console auf der Seite Instanzen aufrufen. Sie können Ihre Instanzerstellungsaktivität auch aufrufen, indem Sie im Google Cloud Console-Menü auf das Benachrichtigungssymbol klicken.

Nachdem die Instanz mit öffentlicher verschlüsselter Verbindung erstellt wurde, wird die öffentliche URL der Instanz in der Spalte Instanz-URL auf der Seite Instanzen angezeigt.

Nachdem die Instanz erstellt wurde, können Sie die Instanz aufrufen, indem Sie die Instanz-URL aufrufen, die auf der Instanzen Seite angezeigt wird, und sich über Google anmelden.

Sie können die Instanzeinstellungen bearbeiten, einschließlich des Hinzufügens manueller OAuth-Anmeldedaten, indem Sie die Seite mit den Instanzdetails aufrufen und auf Bearbeiten klicken.

Probleme beim Erstellen von Instanzen beheben

Informationen zur Fehlerbehebung finden Sie auf der Dokumentationsseite Fehler bei der Erstellung von Looker-Instanzen (Google Cloud Core) beheben.

Nächste Schritte