Configurazione e test di una connessione Git

Quando crei un nuovo progetto, questo esiste solo in modalità di sviluppo per consentirti di sviluppare il modello in un ambiente sicuro che non influisca sugli altri utenti. Quando tutto è pronto per pubblicare il progetto, il passaggio successivo consiste nel configurare una connessione Git.

La configurazione di una connessione Git per il tuo progetto ti consente di eseguire il deployment di LookML in modalità Produzione, che consente ad altri utenti di esplorare il modello dei dati, creare dashboard e aggiungere LookML al tuo modello. Per una configurazione più rapida, utilizza un repository bare. Per un'integrazione Git più solida, crea il tuo repository Git e segui le istruzioni riportate in questa pagina per collegarlo all'istanza Looker.

Integrazione di Looker con Git

Looker utilizza Git per registrare le modifiche e gestire le versioni dei file. Ogni progetto LookML corrisponde a un repository Git e ogni volta che un utente si trova in modalità di sviluppo sul proprio ramo Git. I repository Git sono spesso chiamati repos.

Per la gestione dei file di origine LookML, Looker può essere configurato con qualsiasi provider Git che utilizza una chiave SSH o HTTPS per l'autenticazione. I passaggi generali sono gli stessi indipendentemente dalla piattaforma in uso. Questa pagina utilizza GitHub come esempio per la connessione di un progetto Looker a Git dopo aver creato un repository Git.

Per accedere alle opzioni di integrazione di Git, devi attivare la Modalità di Sviluppo.

Puoi configurare l'integrazione Git utilizzando uno dei seguenti protocolli:

  • HTTPS: HyperText Transfer Protocol Secure. Con HTTPS, Looker accede al tuo repository Git con un nome utente e una password (o token di accesso) che fornisci, come descritto più avanti nella sezione Connessione a Git tramite HTTPS.
  • SSH: Secure Shell. Con SSH, Looker accede al tuo repository Git utilizzando una chiave di deployment che hai generato tramite il sito web del tuo provider Git, come descritto in Connessione a Git utilizzando SSH qui sotto.

Connessione a Git tramite HTTPS

GitHub non accetta password di account per l'autenticazione delle operazioni Git su github.com. Consulta il post del blog di GitHub per ulteriori informazioni. Per connettere un progetto Looker a GitHub tramite HTTPS, utilizza le impostazioni sviluppatore in GitHub per creare un token di accesso personale. Per i progetti Looker esistenti che si connettono a GitHub tramite HTTPS, reimposta la connessione Git utilizzando un token di accesso personale da GitHub.

Per i progetti LookML configurati con l'autenticazione HTTPS, Looker si connette al tuo provider Git con uno o più account utente che hai configurato con il provider Git. Looker utilizza un nome utente e la password (o il token di accesso) per accedere al tuo provider Git ed eseguire operazioni Git per conto dei tuoi sviluppatori LookML.

Se il tuo account Git utilizza l'autenticazione a due fattori, puoi andare al tuo provider Git e creare token di accesso da utilizzare al posto delle password. Vai a questo argomento della community per avere istruzioni per la creazione di token di accesso personali per i provider Git comuni.

Con l'autenticazione HTTPS, puoi configurare il progetto LookML in modo che utilizzi un singolo account Git per l'intero progetto oppure puoi configurare il progetto in modo che utilizzi i singoli account Git degli sviluppatori per eseguire le loro operazioni Git.

Autenticazione HTTPS per account singolo

Se configuri il progetto LookML con un singolo account Git, Looker utilizza quell'account Git per accedere al tuo provider Git al fine di eseguire il commit delle modifiche per conto degli sviluppatori. Looker esegue questi commit utilizzando il nome utente Looker dello sviluppatore, quindi puoi sapere quale sviluppatore ha effettuato ciascun commit. Puoi visualizzare la cronologia dei commit del tuo progetto sull'interfaccia del tuo provider Git o selezionando l'opzione Cronologia dal menu Git dell'IDE di Looker. Per ulteriori informazioni sui menu Git in Looker, consulta la sezione Esecuzione di comandi Git in Looker.

Per l'autenticazione HTTPS di un singolo account, l'account utente Git specificato deve disporre dell'accesso in lettura e scrittura al tuo repository Git. Gli sviluppatori LookML non devono avere i propri account utente Git.

Autenticazione HTTPS a più account con attributi utente

Se configuri il progetto LookML con più account, quest'ultimo utilizzerà l'account Git individuale di ogni sviluppatore Looker per eseguire le operazioni Git. Devi inoltre configurare un account utente Git generico, con almeno l'accesso in lettura, che Looker utilizzerà per estrarre la versione di produzione dei file.

I requisiti e le attività seguenti sono necessari per l'autenticazione Git con gli attributi utente:

  • Ciascuno degli sviluppatori LookML deve avere il proprio account utente con il provider Git. Ogni account utente Git deve avere accesso in lettura e scrittura al repository del progetto.
  • L'amministratore di Looker deve configurare gli account utente Looker con attributi utente corrispondenti al nome utente e alla password Git (o al token di accesso se gli account utente Git hanno l'autenticazione a due fattori).
  • Gli attributi utente per le password (o token di accesso) dell'account Git devono essere nascosti. Quando crei l'attributo password o token di accesso, seleziona Sì nell'opzione Nascondi valori e inserisci l'URL del fornitore Git nel campo Lista consentita dominio.
  • Gli attributi utente per nome Git e password (o token di accesso) devono essere compilati per ogni sviluppatore Looker. Gli attributi utente possono essere configurati da un amministratore Looker o dall'utente Looker.

Ecco un esempio della pagina per gli amministratori di attributi utente in cui un amministratore di Looker ha configurato gli attributi utente per il nome utente e il token di accesso utente di Git:

Ecco un esempio di pagina Account di un utente Looker in cui l'utente ha inserito le proprie credenziali Git nei campi degli attributi utente:

Configurazione dell'autenticazione Git HTTPS

Per configurare un progetto LookML con l'autenticazione Git HTTPS:

  1. Recupera l'URL HTTPS per il repository Git. Nel caso di GitHub, per i nuovi repository (i repository che non contengono ancora alcun file), GitHub mostrerà l'URL come parte della configurazione iniziale. Assicurati di fare clic sul pulsante HTTPS per ottenere l'URL HTTPS, quindi fai clic sul pulsante Copia per copiarlo negli appunti:

    Per i repository GitHub esistenti (repository che già contengono file), puoi vedere l'URL HTTPS andando alla scheda Codice del repository e facendo clic sul pulsante Codice. Assicurati di fare clic sul link HTTPS. Puoi fare clic sull'icona degli appunti per copiarli negli appunti:

  2. Vai al tuo progetto LookML, fai clic sull'icona Settings (Impostazioni) nella barra di navigazione e scorri verso il basso fino alla sezione Configure Git (Configura Git) per i nuovi progetti o alla sezione Reset Git Connection (Reimposta connessione Git) (per i progetti esistenti che sono stati collegati in precedenza a Git):

    Il ripristino della connessione Git consentirà di conservare la cronologia Git per il ramo master. Inoltre, conserverà la cronologia di ogni ramo personale di ogni sviluppatore Looker dopo aver eseguito il pull, l'unione e il deployment. Per conservare la cronologia di tutti i rami, consulta l'articolo del Centro assistenza Migrazione a un nuovo repository Git.

  3. Nella sezione Configura Git di Looker, incolla l'URL HTTPS per il tuo repository Git nel campo Repository URL (URL repository) e fai clic su Continua.

    Looker rileverà il tuo provider Git e aggiornerà la finestra con le informazioni sul tuo repository Git:

    Se Looker non rileva correttamente il tuo provider Git, ti chiederà di scegliere da un menu a discesa.

  4. Seleziona l'opzione di accesso Git:

  5. Nei campi Username (Nome utente) e Password/Token di accesso personale, inserisci le credenziali che il progetto LookML utilizzerà per accedere a Git. Questa operazione è obbligatoria indipendentemente dalle impostazioni di accesso di Git:

    • Se hai selezionato Utilizza una singola combinazione costante di nome utente e password/token di accesso personale, questo è il nome utente e la password Git (o token di accesso) che l'istanza di Looker utilizzerà per tutte le operazioni Git. Questo account utente Git deve avere accesso in lettura e scrittura al tuo repository Git.
    • Se hai selezionato Use user attributes for username and password/personal access token (Utilizza attributi utente per nome utente e password/token di accesso personale), questo sarà il nome utente e la password Git (o token di accesso) che l'istanza di Looker utilizzerà per estrarre la versione di produzione del repository. Questo account utente Git deve avere almeno l'accesso in lettura al tuo repository Git.

    Se il tuo account Git utilizza l'autenticazione a due fattori o se utilizzi GitHub (che richiede un token di accesso personale anziché una password), puoi andare al tuo provider Git e creare i token di accesso da utilizzare al posto delle password. Vai a questo argomento della community per avere istruzioni per la creazione di token di accesso personali per i provider Git comuni.

  6. Se hai selezionato Utilizza attributi utente per nome utente e password/token di accesso personale, vedrai le impostazioni degli attributi utente. Utilizza i menu a discesa per selezionare gli attributi utente per le credenziali Git del singolo sviluppatore:

    Gli utenti di Looker possono modificare i valori dei campi degli attributi utente nella pagina Account (Account) o gli amministratori di Looker possono modificare i valori degli attributi utente nella pagina Users (Utenti).

  7. Fai clic su Continua con la configurazione.

Git è ora configurato per il tuo progetto LookML. Da qui puoi convalidare il tuo LookML, quindi creare il tuo commit iniziale ed eseguire il deployment in produzione per rendere il tuo progetto disponibile in modalità Produzione. Inoltre puoi:

Connessione a Git tramite SSH

Con l'autenticazione SSH, crei una chiave di deployment per il tuo provider Git. Looker genera la coppia di chiavi SSH e visualizza la chiave pubblica nell'interfaccia utente, come descritto nel passaggio 4 qui sotto. Looker utilizza la chiave di deployment per accedere al provider Git al fine di eseguire il commit delle modifiche per conto degli sviluppatori Looker. Looker utilizza i nomi utente Looker di uno sviluppatore per consentirti di stabilire quale sviluppatore ha eseguito ciascun commit. Puoi visualizzare la cronologia dei commit del tuo progetto sull'interfaccia del tuo provider Git o selezionando l'opzione Cronologia dal menu Git dell'IDE di Looker. Per ulteriori informazioni sui menu Git in Looker, consulta la sezione Esecuzione di comandi Git in Looker.

Per configurare un progetto LookML con l'autenticazione Git SSH:

  1. Apri il progetto e seleziona Configurazione nel riquadro delle impostazioni del progetto per visualizzare la configurazione del progetto. Dopodiché esegui una delle seguenti operazioni:

    • Per un nuovo progetto, seleziona il pulsante Configura Git nella sezione di configurazione del progetto.
    • Per modificare la configurazione Git di un progetto esistente, seleziona Reimposta connessione Git nella sezione di configurazione del progetto.

    Il ripristino della connessione Git consentirà di conservare la cronologia Git per il ramo master. Inoltre, conserverà la cronologia di ogni ramo personale di ogni sviluppatore Looker dopo aver eseguito il pull, l'unione e il deployment. Per conservare la cronologia di tutti i rami, consulta l'articolo del Centro assistenza Migrazione a un nuovo repository Git.

  2. Recupera l'URL SSH per il repository Git. Ecco i formati per i provider Git comuni:

    • 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
    • Fabricatore: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    Nel caso di GitHub, per i nuovi repository (i repository che non contengono ancora alcun file), GitHub mostrerà l'URL SSH come parte della configurazione iniziale. Assicurati di fare clic sul pulsante SSH in modo da ottenere l'URL SSH, quindi fai clic sull'icona degli appunti per copiarlo negli appunti:

    Per i repository GitHub esistenti (repository che già contengono file), puoi vedere l'URL SSH andando alla scheda Codice del repository e facendo clic sul pulsante Codice. Assicurati di fare clic sul link Utilizza SSH. Puoi fare clic sull'icona degli appunti per copiarli negli appunti:

  3. Nella sezione Configura Git di Looker, incolla l'URL SSH per il tuo repository Git nel campo Repository URL (URL repository) e fai clic su Continua.

    Gli URL con porte Git personalizzate o non standard possono essere utilizzati con Looker aggiungendo il numero di porta non standard all'URL Git. Ad esempio: ssh://git@corporate.git.server.com:22/myorganization/myproject.git
    Per funzionare correttamente, devi includere ssh://.

  4. Looker rileverà il provider Git e mostrerà una chiave di deployment per il tuo repository. Se Looker non rileva correttamente il tuo provider Git, ti chiederà di scegliere da un menu a discesa. Seleziona l'intera chiave di deployment e copiala negli appunti, quindi fai clic sul link Esegui il deployment delle impostazioni della chiave per il repository per aprire la pagina delle chiavi di deployment GitHub per il tuo repository GitHub.

  5. Nella pagina Deploy key di GitHub, fai clic sul pulsante Add deployment key (Aggiungi chiave di deployment):

    GitHub mostra la pagina Deploy Keys / Add new (Esegui il deployment delle chiavi/Aggiungi nuovo):

  6. Aggiungi un titolo per la chiave di deployment. Il nome non è importante, ma potresti voler includere "Looker" e il titolo del progetto per tenerne traccia in futuro.

  7. Incolla la chiave di deployment che hai copiato da Looker.

  8. Seleziona l'opzione Consenti accesso in scrittura.
    Si tratta di un passaggio importante, perché Looker richiede questa impostazione per poter apportare ed eseguire il deployment delle modifiche al modello LookML.

  9. Fai clic sul pulsante Aggiungi chiave. A questo punto, il tuo provider Git potrebbe chiederti di inserire la password. In tal caso, inserisci la password e fai clic su Conferma password.)

  10. GitHub mostra tutte le chiavi di deployment che sono state aggiunte per il tuo repository.

  11. Torna alla finestra di Looker e fai clic su Test and Finalize Configuration (Prova e finalizza la configurazione) nella sezione Configure Git (Configura Git). Se si verifica un problema con la configurazione di Git, vedrai un errore simile al seguente:

Da qui puoi riprovare a configurare la chiave di deployment oppure puoi fare clic su Ignora test e finalizzare la configurazione per mantenere le impostazioni correnti.

Git è ora configurato per il tuo progetto LookML. Da qui puoi convalidare il tuo LookML, quindi creare il tuo commit iniziale ed eseguire il deployment in produzione per rendere il tuo progetto disponibile in modalità Produzione. Inoltre puoi:

Configurazione di un repository Git semplice

Se non hai ancora creato un repository Git remoto o vuoi semplicemente configurarlo rapidamente in modo che gli altri possano trarre vantaggio dal tuo LookML, puoi configurare un repository Git semplice. La configurazione di un repository Git semplice crea un repository Git locale sull'istanza di Looker anziché connettersi a un repository remoto.

Per configurare un progetto LookML con un repository Git semplice:

  1. Apri il progetto e seleziona Configurazione nel riquadro delle impostazioni del progetto per visualizzare la configurazione del progetto. Dopodiché esegui una delle seguenti operazioni:

    • Per un nuovo progetto, seleziona il pulsante Configura Git nella sezione di configurazione del progetto.
    • Per modificare la configurazione Git di un progetto esistente, seleziona Reimposta connessione Git nella sezione di configurazione del progetto.

    Il ripristino della connessione Git consentirà di conservare la cronologia Git per il ramo master. Inoltre, conserverà la cronologia di ogni ramo personale di ogni sviluppatore Looker dopo che questi avrà eseguito il pull e l'unione per poi eseguire il deployment. Per conservare la cronologia di tutti i rami, consulta l'articolo del Centro assistenza Migrazione a un nuovo repository Git.

  2. Nella finestra di dialogo Configura Git di Looker, fai clic su Configura un repository semplice.

  3. Nella finestra di dialogo Configura un repository Git bare, fai clic su Crea repository.

    Dopo aver creato il repository Git, Looker visualizza una finestra di dialogo che mostra il percorso del nuovo repository Git:

Git è ora configurato per il tuo progetto LookML. Da qui puoi convalidare il tuo LookML, quindi creare il tuo commit iniziale ed eseguire il deployment in produzione per rendere il tuo progetto disponibile in modalità Produzione. Inoltre puoi:

Connessione di un nuovo progetto LookML a un repository Git non vuoto

La configurazione di Git per il controllo delle versioni è un passaggio chiave per la creazione di un nuovo progetto LookML. In genere, ogni progetto deve avere il proprio repository. Tuttavia, potrebbe essere necessario configurare un progetto con un repository Git che contiene LookML esistente, come nelle seguenti situazioni:

  • Quando sposti un progetto LookML esistente tra le istanze
  • Quando riprendi il codice di un progetto LookML inaccessibile o deprecato per utilizzarlo in un nuovo progetto.

In questa sezione vengono descritte le best practice per configurare un nuovo progetto LookML con un repository Git esistente non vuoto per un ulteriore sviluppo LookML.

Questo flusso di lavoro è destinato esclusivamente ai repository a cui hai accesso in scrittura.

  1. Crea un nuovo progetto LookML selezionando Progetto vuoto come punto di partenza. Un progetto vuoto è il punto di partenza perché verrà completato con gli oggetti LookML di un repository esistente e non di uno schema di database o di una query SQL.
  2. Configura Git per il tuo progetto utilizzando HTTPS o SSH, utilizzando l'URL per il progetto non vuoto nella sezione URL del repository della sezione Configura Git.
  3. Dopo aver configurato Git per il tuo progetto, esegui il pull dalla produzione dal riquadro Git Actions.
  4. Dopo aver avviato la produzione, seleziona Deploy to Production (Esegui il deployment in produzione).

Le modifiche apportate al LookML nel tuo progetto non avranno effetto sul repository originale, ma verranno salvate nella tua versione locale del repository.

Se esiste un repository pubblico che vuoi utilizzare come base di un progetto LookML vuoto, ma non disponi dell'accesso in scrittura al repository, segui le istruzioni descritte nella sezione Clonazione di un repository Git pubblico della pagina della documentazione relativa alla creazione di un nuovo progetto LookML.

Se stai configurando un flusso di lavoro Git utilizzando un repository in più istanze, consulta l'argomento della community sul flusso di lavoro Git utilizzando un repository in più istanze: sviluppo, gestione temporanea e produzione per ulteriori informazioni.

Test della connessione Git

Looker fornisce un test di connessione Git per verificare la tua connessione Git. Il test della connessione Git verifica di aver configurato l'URL Git corretto e che l'host Git sia raggiungibile da Looker. Il test della connessione Git verifica inoltre di aver fornito una chiave di deployment Git valida e che la chiave di deployment abbia accesso in scrittura al tuo repository Git.

Se Looker non riesce a connettersi al repository Git, viene visualizzato il pulsante Test Git Connection (Prova connessione Git):

Puoi accedere allo strumento di test della connessione Git anche selezionando Test Git Connection (Prova connessione Git) nel riquadro delle azioni Git:

Lo strumento di test della connessione Git mostra quindi i passaggi necessari per verificare la connessione Git. Di seguito è riportato un esempio di test riuscito:

In questo esempio, nel repository Git non è configurata una chiave di deployment per la connessione di Looker: