Configurazione e test di una connessione Git

Quando crei un nuovo progetto, questo è disponibile solo in modalità di sviluppo per consentirti di sviluppare il modello in un ambiente sicuro senza conseguenze per altri utenti. Quando è tutto pronto per pubblicare il progetto, il passaggio successivo è configurare una connessione Git.

La configurazione di una connessione Git per il tuo progetto ti consente di eseguire il deployment del tuo LookML in modalità di produzione, che consente ad altri utenti di esplorare il tuo modello dei dati, creare dashboard e aggiungere LookML al tuo modello. Per una configurazione più rapida, utilizza un repository semplice. Per un'integrazione Git più efficace, crea il tuo repository Git e segui le istruzioni in questa pagina per connetterlo alla tua 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. Ogni volta che un utente si trova in modalità di sviluppo, si trova nel proprio ramo Git.

Per la gestione dei file di origine LookML, Looker può essere configurato con qualsiasi provider Git che utilizzi una chiave SSH o HTTPS per l'autenticazione. I passaggi generali sono gli stessi indipendentemente dalla piattaforma utilizzata. Questa pagina utilizza GitHub come esempio per connettere un progetto Looker a Git dopo che hai 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 un token di accesso) da te forniti, come descritto in Connessione a Git con HTTPS.
  • SSH: Secure Shell. Con SSH, Looker accede al tuo repository Git utilizzando una chiave di deployment generata da te mediante il sito web del tuo provider Git, come descritto in Connessione a Git mediante SSH.

Connessione a Git mediante HTTPS

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 tuo provider Git. Looker utilizza un nome utente e una password (o un 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 dal tuo provider Git e creare token di accesso da utilizzare al posto delle password. Vai al post della scheda Community sulla configurazione di una connessione Git HTTPS con 2FA abilitata per conoscere le istruzioni per la creazione di token di accesso personali per i provider Git più comuni.

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

Tieni presente quanto segue per l'autenticazione HTTPS di GitHub:

  • 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 utilizzando HTTPS, utilizza le impostazioni sviluppatore in GitHub per creare un token di accesso personale.
  • Looker non supporta i token di accesso personale granulare di GitHub. Per connettere il tuo progetto Looker a GitHub tramite HTTPS, utilizza l'opzione Token (classico) di GitHub quando crei un token di accesso personale.

Autenticazione HTTPS per un singolo account

Se configuri il tuo progetto LookML con un singolo account Git, Looker utilizza questo account Git per accedere al tuo provider Git ed eseguire il commit delle modifiche per conto degli sviluppatori. Looker esegue questi impegni utilizzando il nome utente Looker dello sviluppatore, in modo da poter indicare quale sviluppatore ha eseguito ciascun commit. Puoi visualizzare la cronologia dei commit del progetto sull'interfaccia del tuo provider Git o selezionando l'opzione Cronologia dal menu Git dell'IDE di Looker. Per saperne di più sui menu Git in Looker, consulta Esecuzione di comandi Git in Looker.

Per l'autenticazione HTTPS a livello di singolo account, l'account utente Git specificato deve disporre dell'accesso in lettura e scrittura al repository Git. Gli sviluppatori LookML stessi non devono disporre di un proprio account utente Git.

Autenticazione HTTPS di più account con attributi utente

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

Per l'autenticazione Git con attributi utente sono necessari i seguenti requisiti e attività:

  • Ogni sviluppatore 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 degli account (o i token di accesso) Git devono essere nascosti. Quando crei la password o l'attributo del token di accesso, seleziona Sì sotto l'opzione Nascondi valori e inserisci l'URL del provider Git nel campo Lista consentita del dominio.
  • Gli attributi utente per il nome e la password Git (o il token di accesso) devono essere compilati per ogni sviluppatore di Looker. Gli attributi utente possono essere configurati da un amministratore di Looker o dall'utente di Looker.

L'esempio seguente mostra la pagina Amministrazione Attributi utente, in cui un amministratore di Looker ha configurato gli attributi utente per il nome utente Git e il token di accesso utente.

Tabella nella pagina Amministrazione attributi utente che mostra gli attributi utente di tipo stringa github_token e github_username.

L'esempio seguente mostra la 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, segui questi passaggi:

  1. Recupera l'URL HTTPS per il tuo repository Git. Nel caso di GitHub, per i nuovi repository (repository che non contengono ancora file), GitHub mostrerà l'URL come parte della configurazione iniziale. Assicurati di selezionare il pulsante HTTPS nella scheda Codice in modo da ottenere l'URL HTTPS, quindi seleziona l'icona Copia URL negli appunti per copiarlo negli appunti.

    Per i repository GitHub esistenti (repository che contengono già file), puoi vedere l'URL HTTPS andando alla scheda Codice del repository e selezionando il pulsante Codice. Assicurati di selezionare il link HTTPS. Puoi selezionare l'icona Copia URL negli appunti per copiare l'URL HTTPS negli appunti.

  2. Vai al progetto LookML e seleziona l'icona Impostazioni dalla barra di navigazione.

  3. Nella pagina Configurazione progetto, nella scheda Configurazione, vai al pulsante Configura Git (per i nuovi progetti) o al pulsante Reimposta connessione Git (per i progetti esistenti che sono stati già collegati a Git in precedenza).

  4. Seleziona il pulsante Configura Git o Reimposta connessione Git per aprire la pagina Configura Git.

    La reimpostazione della connessione Git conserverà la cronologia Git per il ramo principale. Verrà inoltre conservata la cronologia del ramo personale di ogni sviluppatore Looker dopo l'esecuzione del pull, dell'unione e del deployment. Per conservare la cronologia per tutti i rami, consulta la pagina delle best practice per la migrazione a un nuovo repository Git.

  5. Nella pagina Configura Git di Looker, incolla l'URL HTTPS per il tuo repository Git nel campo URL repository e seleziona 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.

  6. Seleziona l'opzione di accesso Git:

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

    • Se hai selezionato Utilizza una singola combinazione costante di nome utente e password/token di accesso personale, si tratta del nome utente e della password (o del token di accesso) Git che l'istanza di Looker utilizzerà per tutte le operazioni Git. Questo account utente Git deve disporre dell'accesso in lettura e scrittura al repository Git.
    • Se hai selezionato Utilizza attributi utente per nome utente e password/token di accesso personale, si tratta del nome utente e della password (o del token di accesso) Git che l'istanza di Looker utilizzerà per eseguire il pull della versione di produzione del repository. Questo account utente Git deve disporre almeno dell'accesso in lettura al repository Git.

    Se il tuo account Git utilizza l'autenticazione a due fattori o se usi GitHub (che richiede un token di accesso personale anziché una password), puoi visitare il tuo provider Git e creare token di accesso da utilizzare al posto delle password. Vai al post della scheda Community sulla configurazione di una connessione Git HTTPS con 2FA abilitata per vedere le istruzioni per la creazione di token di accesso personali per i provider Git più comuni.

  8. Se hai selezionato Utilizza attributi utente per nome utente e password/token di accesso personale, Looker visualizza i menu a discesa Username User Attribute (Attributo utente utente utente) e Personal Access Token User Attribute (Attributo utente token di accesso personale) nella sezione Credenziali modalità di sviluppo. Utilizza i menu a discesa per selezionare gli attributi utente per le credenziali Git di un singolo sviluppatore.

    Gli utenti di Looker possono modificare i valori dei campi degli attributi utente nella pagina Account oppure gli amministratori di Looker possono modificare i valori degli attributi utente per un utente nella pagina di amministrazione Utenti.

  9. Seleziona il pulsante Continua configurazione.

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

Connessione a Git mediante 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 nella UI, come illustrato nel passaggio 4. Looker utilizza questa chiave di deployment per accedere al tuo provider Git ed eseguire il commit delle modifiche per conto degli sviluppatori di Looker. Looker esegue i commit utilizzando il nome utente Looker di uno sviluppatore, in modo da poter indicare quale sviluppatore ha eseguito ciascun commit. Puoi visualizzare la cronologia dei commit del progetto sull'interfaccia del tuo provider Git o selezionando l'opzione Cronologia dal menu Git dell'IDE di Looker. Per saperne di più sui menu Git in Looker, consulta Esecuzione di comandi Git in Looker .

Per configurare un progetto LookML con l'autenticazione Git SSH, segui questi passaggi:

  1. Apri il progetto o crea un nuovo progetto LookML.
  2. Nel tuo progetto, seleziona l'icona Settings (Impostazioni) dal menu a sinistra per aprire la pagina Project Configuration (Configurazione progetto).

  3. Nella pagina Configurazione progetto, esegui una delle seguenti azioni per aprire la pagina Configura Git:

    • Per un progetto senza connessione Git, seleziona il pulsante Configura Git.
    • Per un progetto già configurato con una connessione Git, seleziona il pulsante Reset Git Connection (Reimposta connessione Git).

    La reimpostazione della connessione Git conserverà la cronologia Git per il ramo principale. Verrà inoltre conservata la cronologia del ramo personale di ogni sviluppatore Looker dopo l'esecuzione del pull, dell'unione e del deployment. Per conservare la cronologia per tutti i rami, consulta la pagina delle best practice per la migrazione a un nuovo repository Git.

    Diagramma che mostra l'avanzamento dalla pagina Impostazioni progetto alla pagina Configura Git. Per i nuovi progetti verrà visualizzato un pulsante Configura Git, mentre per quelli esistenti verrà visualizzato un pulsante Reimposta Git Connect, ma entrambi i pulsanti rimandano alla pagina Configura Git.

  4. Recupera l'URL SSH per il repository Git. Ecco i formati per i provider Git più 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
    • Fabrificatore: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    Nel caso di GitHub, per i nuovi repository (repository che non contengono ancora file), GitHub mostrerà l'URL SSH nella scheda Codice nell'ambito della configurazione iniziale. Assicurati di selezionare il pulsante SSH in modo da ottenere l'URL SSH, quindi seleziona l'icona degli appunti per copiarlo.

    Per i repository GitHub esistenti (repository che contengono già file), puoi visualizzare l'URL SSH andando alla scheda Codice del repository e selezionando il pulsante Codice. Assicurati di selezionare il link Utilizza SSH. Puoi selezionare l'icona degli appunti per copiarla.

  5. Nella pagina Configura Git di Looker, incolla l'URL SSH per il tuo repository Git nel campo URL repository e seleziona 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

    Affinché questa operazione funzioni correttamente, devi includere ssh://.

  6. Looker rileverà il tuo 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. Copia la chiave di deployment negli appunti, quindi seleziona il link Deploy Key settings for your repository (Esegui il deployment delle impostazioni della chiave per il tuo repository) per aprire la pagina di GitHub Deploy keys per il tuo repository GitHub.

  7. Nella scheda Impostazioni di GitHub, nella pagina Esegui il deployment delle chiavi, seleziona il pulsante Aggiungi chiave di deployment:

    GitHub visualizza la pagina Deploy keys / Add new (Esegui il deployment delle chiavi/Aggiungi nuova).

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

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

  10. Seleziona l'opzione Consenti accesso in scrittura.

  11. Seleziona il pulsante Aggiungi chiave. A questo punto, il tuo provider Git potrebbe chiederti di inserire la password. In questo caso, inserisci la password e seleziona Conferma password.)

  12. GitHub mostrerà tutte le chiavi di deployment che sono state aggiunte per il tuo repository.

  13. Torna alla finestra di Looker e, nella pagina Configura Git, seleziona Testa e finalizza la configurazione.

Da qui, puoi riprovare a configurare la chiave di deployment oppure puoi selezionare Ignora i test e finalizza la configurazione per mantenere le impostazioni attuali.

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

Configurazione di un repository Git semplice

Se non hai ancora creato un repository Git remoto o se vuoi semplicemente configurarlo rapidamente in modo che 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.

Quando selezioni l'opzione per creare un repository semplice, Looker crea il repository sul tuo server Looker e avvia la cronologia Git per il repository.

Per configurare un progetto LookML con un repository Git semplice:

  1. Apri il progetto o crea un nuovo progetto LookML.
  2. Nel tuo progetto, seleziona l'icona Settings (Impostazioni) dal menu a sinistra per aprire la pagina Project Configuration (Configurazione progetto).

  3. Nella pagina Configurazione progetto, esegui una delle seguenti azioni per aprire la pagina Configura Git:

    • Per un progetto senza connessione Git, seleziona il pulsante Configura Git.
    • Per un progetto già configurato con una connessione Git, seleziona il pulsante Reset Git Connection (Reimposta connessione Git).

    La reimpostazione della connessione Git conserverà la cronologia Git per il ramo principale. Verrà inoltre conservata la cronologia del ramo personale di ogni sviluppatore Looker dopo il pull, l'unione e il deployment. Per conservare la cronologia per tutti i rami, consulta la pagina delle best practice per la migrazione a un nuovo repository Git.

  4. Seleziona Configura un repository semplice nella parte inferiore della pagina Configura Git.

  5. Nella finestra di dialogo Configura repository Git Bare, seleziona Crea repository.

    Una volta creato il repository Git, Looker mostrerà una finestra di dialogo Repository semplice creato.

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

Per i progetti configurati con un repository semplice, puoi successivamente utilizzare Reimposta connessione Git se vuoi connettere il progetto a un provider Git (vedi le procedure per l'utilizzo di HTTPS o SSH). Tuttavia, non connetterti a un repository Git che ha già una cronologia Git. Se hai configurato il progetto LookML con un repository semplice, Looker crea un repository sul tuo server Looker e avvia la cronologia Git per il repository. Se in seguito connetti il tuo progetto LookML a un repository Git che ha una cronologia Git, Looker non sarà in grado di riconciliare le due cronologie Git e non sarai in grado di eseguire alcuna azione Git.

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

Configurare Git per il controllo della versione è un passaggio fondamentale per la creazione di un nuovo progetto LookML. In genere, ogni progetto dovrebbe avere il proprio repository. Tuttavia, potresti dover configurare un progetto con un repository Git che contiene il LookML esistente, ad esempio nelle seguenti situazioni:

  • Quando sposti un progetto LookML esistente tra le istanze
  • Quando recuperi il codice da un progetto LookML non funzionante o non attivo per l'utilizzo in un nuovo progetto

Questa sezione descrive le best practice per configurare un nuovo progetto LookML con un repository Git esistente non vuoto per un ulteriore sviluppo di LookML.

  1. Crea un nuovo progetto LookML selezionando Progetto vuoto come punto di partenza. Un progetto vuoto è il punto di partenza perché verrà compilato con oggetti LookML di un repository esistente, anziché con uno schema di database o 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 repository della pagina Configura Git.
  3. Dopo aver configurato Git per il tuo progetto, esegui il pull dalla produzione dal riquadro Azioni Git.
  4. Dopo aver eseguito il pull dalla produzione, seleziona Esegui il deployment in produzione.

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

Se vuoi utilizzare un repository pubblico specifico come base di un progetto LookML vuoto, ma non disponi dell'accesso in scrittura al repository, segui le istruzioni descritte nella sezione Clonare un repository Git pubblico della pagina della documentazione Creazione di un nuovo progetto LookML.

Se stai configurando un flusso di lavoro Git utilizzando un repository su più istanze, consulta il post della scheda Community sul flusso di lavoro Git utilizzando un solo repository su più istanze (sviluppo, gestione temporanea e produzione) per ulteriori informazioni.

Test della connessione Git

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

Se Looker non riesce a connettersi al tuo repository Git, il pulsante Git mostrerà il testo Verifica connessione Git per chiederti di risolvere i problemi della connessione.

Puoi anche accedere allo strumento di test della connessione Git selezionando Testa la connessione Git nel riquadro Azioni Git:

Lo strumento di test della connessione Git visualizza quindi i passaggi necessari per testare la connessione Git:

  1. Esamina git remote
  2. Il nome host per il servizio Git verrà risolto
  3. Il networking con il servizio Git è operativo
  4. Verificare le credenziali di autorizzazione
  5. Verifica che le credenziali consentano l'accesso in scrittura

Se un passaggio ha esito positivo, Looker visualizza un segno di spunta verde a sinistra del passaggio. Se un passaggio non riesce, Looker visualizza un segno di spunta rosso a sinistra del passaggio e anche un messaggio di errore.

L'esempio seguente mostra un test riuscito:

Finestra di dialogo Test di connessione Git che mostra un elenco di passaggi con accanto un segno di spunta verde che indica che tutti i passaggi sono stati eseguiti correttamente.

Nell'esempio seguente, nel repository Git non è configurata una chiave di deployment per la connessione Looker. I segni di spunta verdi a sinistra dei primi tre passaggi indicano che questi passaggi sono stati eseguiti correttamente:

  • Examine git remote
  • Host name for git service will resolve
  • Networking to the git service is operational

I segni di spunta rossi a sinistra degli ultimi due passaggi indicano che questi passaggi non sono riusciti:

  • Verify authorization credentials
  • Ensure credentials allow write access

Finestra di dialogo Test di connessione Git che mostra un elenco di passaggi riusciti e non riusciti. Nel passaggio Verifica le credenziali di autorizzazione viene visualizzato un errore che indica Impossibile eseguire l&#39;autenticazione remota (chiave di deployment di Looker).