Crea un'istanza di Looker (Google Cloud core) con connessioni sicure pubbliche

Questa pagina descrive come eseguire il provisioning di un'istanza di produzione o non di produzione di Looker (Google Cloud core) configurata per connessioni sicure pubbliche.

Se vuoi creare un'istanza di connessioni private, la configurazione deve essere assegnata al momento della creazione dell'istanza. Per istruzioni su come creare un'istanza di connessioni private, segui la procedura descritta nelle pagine della documentazione Crea un'istanza di Looker (Google Cloud core) con Private Service Connect o Crea un'istanza di Looker (Google Cloud core) con connessioni private (accesso ai servizi privati) anziché la procedura seguente.

Prima di iniziare

  1. Collabora con il team di vendita per assicurarti che il tuo contratto annuale sia completato e che la quota sia allocata nel tuo progetto.
  2. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .
  3. Nella console Google Cloud, nella pagina di selezione del progetto, crea un progetto Google Cloud o vai a un progetto esistente.

    Vai al selettore di progetti

  4. Abilita l'API Looker per il tuo progetto nella console Google Cloud. Quando abiliti l'API, potresti dover aggiornare la pagina della console per confermare che l'API è stata abilitata.

    Abilita l'API

  5. Se vuoi utilizzare i Controlli di servizio VPC, devi creare un'istanza di connessioni private (accesso privato ai servizi) anziché un'istanza di connessione sicura pubblica.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un'istanza di Looker (Google Cloud core), chiedi all'amministratore di concederti il ruolo IAM Looker Admin (roles/looker.admin) nel progetto in cui risiederà l'istanza. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Potresti anche aver bisogno di ruoli IAM aggiuntivi per configurare la federazione delle identità per la forza lavoro o le chiavi di crittografia gestite dal cliente (CMEK). Scopri di più, consulta le pagine della documentazione Utilizza la federazione delle identità per la forza lavoro per l'autenticazione degli utenti di Looker (Google Cloud core) o Abilita CMEK per Looker (Google Cloud core) per queste funzionalità.

Crea un'istanza di Looker (Google Cloud core)

Looker (Google Cloud core) richiede circa 60 minuti per generare una nuova istanza.

Per creare l'istanza di Looker (Google Cloud core), seleziona una delle seguenti opzioni:

console

  1. Vai alla pagina di prodotto di Looker (Google Cloud core) dal tuo progetto nella console Google Cloud. Se hai già creato un'istanza di Looker (Google Cloud core) in questo progetto, si aprirà la pagina Istanze.

    Vai a Looker (Google Cloud core)

  2. Fai clic su CREA ISTANZA.
  3. Nella sezione Nome istanza, fornisci un nome per l'istanza di Looker (Google Cloud core). Il nome dell'istanza non è associato all'URL dell'istanza di Looker (Google Cloud core) una volta creata. Il nome dell'istanza non può essere modificato dopo la creazione dell'istanza.
  4. Nella sezione Regione, seleziona l'opzione appropriata dal menu a discesa per ospitare l'istanza di Looker (Google Cloud core). Seleziona la regione corrispondente a quella nel contratto di abbonamento, ovvero dove viene allocata la quota per il tuo progetto. Le regioni disponibili sono elencate nella pagina della documentazione Località di Looker (Google Cloud core). Non puoi modificare la regione dopo aver creato l'istanza.
  5. Nella sezione Edizione, imposta la versione dell'istanza in base alle esigenze della tua organizzazione. Il tipo di versione influisce su alcune delle funzionalità disponibili per l'istanza. Assicurati di scegliere lo stesso tipo di versione indicato nel tuo contratto annuale e di avere una quota allocata per quel tipo di versione. Queste sono le opzioni di modifica:

    • Standard: piattaforma Looker (Google Cloud core) per piccole organizzazioni o team con meno di 50 utenti
    • Enterprise: piattaforma Looker (Google Cloud core) con funzionalità di sicurezza avanzate per un'ampia gamma di casi d'uso interni per BI e analisi
    • Embed: piattaforma Looker (Google Cloud core) per il deployment e la gestione di applicazioni esterne di analisi e personalizzate affidabili su larga scala
    • Versioni non di produzione: se vuoi un ambiente di gestione temporanea e test, seleziona una delle versioni non di produzione. Per saperne di più, consulta la documentazione relativa alle istanze non di produzione.
    • Versioni di prova: una versione di prova supporta le stesse funzionalità della versione di produzione corrispondente, con la differenza che le versioni di prova sono valide per 90 giorni.

    Le versioni non possono essere cambiate dopo la creazione di un'istanza. Se vuoi cambiare versione, puoi utilizzare l'importazione e l'esportazione per spostare i dati dell'istanza di Looker (Google Cloud core) in una nuova istanza configurata con una versione diversa.

  6. Nella sezione Personalizza la tua istanza, fai clic su Mostra opzioni di configurazione per visualizzare un gruppo di impostazioni aggiuntive che puoi personalizzare per l'istanza.

  7. Nella sezione Connessioni, seleziona Utilizza connessioni sicure pubbliche. Un'impostazione di connessione pubblica sicura assegna un indirizzo IP esterno accessibile da internet ed è disponibile per tutti i tipi di versioni.

  8. Nella sezione Autenticazione, seleziona il metodo di autenticazione principale per l'istanza. I metodi di autenticazione principali sono obbligatori per tutte le istanze di Looker (Google Cloud core). Sono disponibili le seguenti opzioni di autenticazione principale:
    • Google OAuth: utilizza questo metodo se i tuoi utenti eseguono l'autenticazione con Account Google (Google Workspace o Cloud Identity). Questa è l'opzione predefinita.
    • Federazione delle identità per la forza lavoro (SAML/OIDC): utilizza questo metodo se i tuoi utenti si autenticano con un provider di identità esterno (come Okta, Microsoft Entra ID o Ping Identity) e vuoi il Single Sign-On (SSO) con controllo dell'accesso IAM senza gestire singoli Account Google.
  9. Nella sezione Canale di rilascio, seleziona il canale di rilascio più adatto alle tue esigenze:

    • Rapido: accesso più rapido alle funzionalità. Impostazione predefinita consigliata per le istanze non di produzione.
    • Regolare: stabilità bilanciata. Consigliato per istanze di produzione.
    • Nessun canale: nessun canale di rilascio. Durante l'anteprima, l'impostazione predefinita è Nessun canale.
  10. Se stai creando un'istanza della versione Enterprise o Embed, vedrai la sezione Crittografia. Nella sezione Crittografia, puoi selezionare il tipo di crittografia da utilizzare per l'istanza. Sono disponibili le seguenti opzioni di crittografia:

  11. Nella sezione Periodo di manutenzione, puoi facoltativamente specificare il giorno della settimana e l'ora in cui Looker (Google Cloud core) pianifica la manutenzione.

  12. Nella sezione Periodo in cui evitare la manutenzione, puoi facoltativamente specificare un blocco di giorni in cui Looker (Google Cloud core) non pianifica la manutenzione. Non puoi impostare un periodo in cui evitare la manutenzione se registri l'istanza anche nel canale di rilascio rapido o se utilizzi il flag di configurazione di applicazione di patch di sicurezza accelerate (ASP) con il canale di rilascio regolare.

  13. Nella sezione Gemini in Looker, puoi facoltativamente rendere disponibili le funzionalità di Gemini in Looker per l'istanza di Looker (Google Cloud core). Per attivare Gemini in Looker, seleziona Gemini, quindi Funzionalità Trusted tester. Quando l'opzione Funzionalità Trusted Tester è attiva, gli utenti possono accedere alle funzionalità di Trusted Tester di Gemini in Looker. Puoi richiedere l'accesso alle funzionalità Trusted tester non pubbliche tramite il modulo di anteprima di Gemini in Looker per singoli utenti. Devi attivare questa impostazione per utilizzare Gemini durante l'anteprima pre-GA. Facoltativamente, seleziona Utilizzo dei dati di Trusted Tester. Quando questa impostazione è abilitata, acconsenti all'utilizzo dei tuoi dati da parte di Google come descritto nei termini del programma Trusted Tester di Gemini per Google Cloud Per disabilitare Gemini per un'istanza di Looker (Google Cloud core), deseleziona l'impostazione Gemini.

  14. Nella sezione Integrazione di Knowledge Catalog, puoi facoltativamente selezionare la casella di controllo Disattiva l'integrazione di Knowledge Catalog se non vuoi che Looker (Google Cloud core) si integri con Knowledge Catalog. Looker (Google Cloud core) e Knowledge Catalog sono integrati per impostazione predefinita.

  15. Fai clic su Crea.

gcloud

  1. Se utilizzi CMEK, crea il service account Looker e segui le istruzioni per configurare CMEK.
  2. Utilizza il comando gcloud looker instances create per creare l'istanza:

    gcloud looker instances create INSTANCE_NAME \
    --project=PROJECT_ID \
    [--oauth-client-id=OAUTH_CLIENT_ID \
    --oauth-client-secret=OAUTH_CLIENT_SECRET] \
    --region=REGION \
    --edition=EDITION \
    [--release-channel=RELEASE_CHANNEL]\
    --public-ip-enabled \
    --async
    

    Sostituisci quanto segue:

    • INSTANCE_NAME: un nome per l'istanza di Looker (Google Cloud core); non è associato all'URL dell'istanza.
    • PROJECT_ID: il nome del progetto Google Cloud in cui stai creando l'istanza di Looker (Google Cloud core).
    • OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET: l'ID client OAuth e il client secret che hai creato quando hai configurato il client OAuth. Google Cloud CLI richiede questi flag ogni volta che l'autenticazione Google è abilitata nell'istanza, anche per impostazione predefinita quando non specifichi alcun flag di autenticazione. Puoi omettere questi flag quando l'autenticazione Google è disattivata, ad esempio quando configuri solo la federazione delle identità per la forza lavoro. Se configuri Google OAuth, inserisci l'URL dell'istanza nella sezione URI di reindirizzamento autorizzati del client OAuth dopo aver creato l'istanza.
    • REGION: la regione in cui è ospitata l'istanza di Looker (Google Cloud core). Seleziona la regione corrispondente a quella del contratto di abbonamento. Le regioni disponibili sono elencate nella pagina della documentazione Località di Looker (Google Cloud core). Non puoi modificare la regione dopo aver creato l'istanza.
    • EDITION: la versione, il tipo di ambiente (produzione o non di produzione) e se si tratta di una versione di prova per l'istanza. I valori disponibili sono 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 e core-trial-embed. Le versioni non possono essere cambiate dopo la creazione di un'istanza. Se vuoi cambiare versione, puoi utilizzare l'importazione e l'esportazione per spostare i dati dell'istanza di Looker (Google Cloud core) in una nuova istanza configurata con una versione diversa.
    • RELEASE_CHANNEL: il canale di rilascio dell'istanza. I valori disponibili sono rapid, regular e no-channel. Il valore predefinito durante l'anteprima è no-channel. Se non includi questo flag nel comando create, l'istanza verrà creata con il canale predefinito. Questa funzionalità è in anteprima.

    Includi anche questi flag:

    • --public-ip-enabled viene utilizzato per abilitare la connessione sicura pubblica.
    • --async è consigliato quando crei un'istanza di Looker (Google Cloud core).
  3. Puoi aggiungere altri parametri per applicare altre impostazioni dell'istanza:

    [--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]
    [--workforce-auth-enabled]
    [--google-auth-enabled]
    [--no-google-auth-enabled]
    

    Sostituisci quanto segue:

    I seguenti flag attivano altre impostazioni:

    I metodi di autenticazione principali sono obbligatori per tutte le istanze di Looker (Google Cloud core). Utilizza i seguenti flag per configurare il metodo di autenticazione principale per l'istanza:

    • --google-auth-enabled e --no-google-auth-enabled: attiva o disattiva l'autenticazione Google OAuth. Utilizza questo metodo se i tuoi utenti eseguono l'autenticazione con Account Google (Google Workspace o Cloud Identity). L'autenticazione Google è abilitata per impostazione predefinita in gcloud CLI se non specifichi i flag di autenticazione. Ogni volta che l'autenticazione Google è abilitata, devi includere --oauth-client-id e --oauth-client-secret. Quando configuri la federazione delle identità per la forza lavoro, includi --google-auth-enabled insieme ai flag OAuth per supportare Google OAuth come metodo di autenticazione secondario o includi --no-google-auth-enabled per disattivare esplicitamente l'autenticazione Google.
    • --workforce-auth-enabled: configura la federazione delle identità per la forza lavoro (SAML/OIDC) come metodo di autenticazione principale. Utilizza questo metodo se i tuoi utenti eseguono l'autenticazione con un provider di identità esterno (come Okta, Microsoft Entra ID o Ping Identity) e vuoi il Single Sign-On (SSO) con controllo dell'accesso IAM senza gestire singoli Account Google. Se specifichi --workforce-auth-enabled senza --google-auth-enabled, l'autenticazione Google viene disattivata, quindi i flag --oauth-client-id e --oauth-client-secret non sono obbligatori.

Terraform

Utilizza la seguente risorsa Terraform per eseguire il provisioning di un'istanza di Looker (Google Cloud core) Standard con funzionalità di base:

# 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"
  }
}

Utilizza la seguente risorsa Terraform per eseguire il provisioning di un'istanza di Looker (Google Cloud core) Standard con impostazioni aggiuntive applicate:

# 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"
  }
}

Utilizza la seguente risorsa Terraform per eseguire il provisioning di un'istanza di Looker (Google Cloud core) Enterprise con una connessione di rete privata:

# 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"
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Una volta avviata, la creazione dell'istanza non può essere messa in pausa o terminata. Una volta eseguito il provisioning della risorsa Terraform, il terminale stamperà il seguente messaggio:

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.

Durante la creazione dell'istanza, puoi visualizzarne lo stato nella pagina Istanze della console. Puoi anche visualizzare l'attività di creazione dell'istanza facendo clic sull'icona delle notifiche nel menu della console Google Cloud .

Una volta creata l'istanza di connessione sicura pubblica, l'URL pubblico dell'istanza verrà visualizzato nella colonna URL istanza della pagina Istanze.

Dopo aver creato l'istanza, puoi visualizzarla accedendo all'URL dell'istanza, che verrà visualizzato nella pagina Istanze, e accedere con Google.

Puoi modificare le impostazioni dell'istanza, inclusa l'aggiunta di credenziali OAuth manuali, se vuoi, visitando la pagina dei dettagli dell'istanza e facendo clic su Modifica.

Risoluzione dei problemi relativi alla creazione delle istanze

Per assistenza sulla risoluzione dei problemi, consulta la pagina della documentazione Risoluzione dei problemi di creazione delle istanze di Looker (Google Cloud core).

Passaggi successivi