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 abbia ripercussioni sugli 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 consente di eseguire il deployment di LookML in modalità di produzione, che consente ad altri utenti di esplorare il modello dei dati, creare dashboard e aggiungere LookML al modello. Per una configurazione più rapida, utilizza un repository semplice. Per un'integrazione Git più solida, 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 è in modalità di sviluppo si trova sul suo ramo Git.

Per la gestione dei file di origine di 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. In questa pagina viene utilizzato GitHub come esempio per la connessione di 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 di Git utilizzando uno dei seguenti protocolli:

  • HTTPS: HyperText Transfer Protocol Secure. Con HTTPS, Looker accede al tuo repository Git con il nome utente e la password (o il token di accesso) da te forniti, come descritto in Connessione a Git mediante HTTPS.
  • SSH: Secure Shell. Con SSH, Looker accede al tuo repository Git utilizzando una chiave di deployment generata tramite il sito web del tuo provider Git, come descritto in Connessione a Git mediante SSH.

Connessione a Git tramite 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 degli sviluppatori LookML.

Se il tuo account Git utilizza l'autenticazione a due fattori, puoi visitare il tuo provider Git e creare token di accesso da utilizzare al posto delle password. Vai al post della scheda Community Configurazione della connessione HTTPS HTTPS con l'autenticazione a due fattori abilitata per leggere le istruzioni per la creazione di token di accesso personale per i provider Git più comuni.

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

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

  • GitHub non accetta password di account per l'autenticazione delle operazioni Git su github.com. Per maggiori informazioni, vedi il post del blog di GitHub. Per connettere un progetto Looker a GitHub tramite HTTPS, utilizza le impostazioni sviluppatore in GitHub per creare un token di accesso personale.
  • Looker non supporta i token di accesso personale granulari di GitHub. Per connettere il tuo progetto Looker a GitHub utilizzando HTTPS, utilizza l'opzione Token (classica) di GitHub quando crei un token di accesso personale.

Autenticazione HTTPS per singolo account

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

Per l'autenticazione HTTPS per un singolo account, l'account utente Git specificato deve avere accesso in lettura e scrittura al repository Git. Gli sviluppatori LookML non hanno bisogno di disporre di account utente Git.

Autenticazione HTTPS di più account con attributi utente

Se configuri il progetto LookML con più account, il progetto LookML utilizzerà il singolo account Git di ogni sviluppatore Looker per eseguire le operazioni Git. Devi anche 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 le attività e i requisiti seguenti:

  • Ogni sviluppatore LookML deve disporre del proprio account utente presso il provider Git. Ogni account utente Git deve disporre dell'accesso in lettura e scrittura al repository del progetto.
  • L'amministratore di Looker deve configurare gli account utente di Looker con attributi utente corrispondenti al nome utente e alla password Git (o token di accesso se gli account utente Git hanno l'autenticazione a due fattori).
  • Gli attributi utente delle password degli account Git (o dei token di accesso) devono essere nascosti. Quando crei la password o l'attributo del token di accesso, seleziona Sì nell'opzione Nascondi valori e inserisci l'URL del provider Git nel campo Lista consentita del dominio.
  • Gli attributi utente per il nome Git e la password (o il token di accesso) devono essere compilati per ogni sviluppatore 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 dell'utente.

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

L'esempio seguente mostra la pagina Account di un utente Looker, in cui ha inserito le proprie credenziali Git nei campi degli attributi utente.

Configurazione dell'autenticazione Git su 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 (repositori che non contengono ancora file), GitHub mostrerà l'URL come parte della configurazione iniziale. Assicurati di selezionare il pulsante HTTPS nella scheda Codice per ottenere l'URL HTTPS, quindi seleziona l'icona Copia URL negli appunti per copiarlo negli appunti.

    Per i repository GitHub esistenti (repository che già contengono file), puoi visualizzare 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 tuo 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 Reimposta connessione Git (per i progetti esistenti che sono stati connessi 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. Inoltre, conserverà la cronologia del ramo personale di ogni sviluppatore Looker dopo il pull, l'unione e il deployment. Per conservare la cronologia di tutti i rami, consulta la pagina delle best practice sulla 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, quindi seleziona Continua.

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

    Se Looker non riesce a rilevare correttamente il 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 accesso personale), inserisci le credenziali che il tuo progetto LookML utilizzerà per accedere a Git. Questo passaggio è obbligatorio indipendentemente dall'impostazione di accesso 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 Git (o del 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 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 avere almeno l'accesso in lettura al tuo repository Git.

    Se il tuo account Git usa l'autenticazione a due fattori o se stai usando GitHub (che richiede un token di accesso personale invece di una password), puoi rivolgerti al tuo provider Git e creare token di accesso da usare al posto delle password. Vai al post della scheda Community Configurazione della connessione HTTPS HTTPS con l'autenticazione a due fattori abilitata per leggere le istruzioni per la creazione di token di accesso personale 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 Attributo utente nome utente e Attributo utente token 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 Continue setup (Continua la configurazione).

Git è ora configurato per il tuo progetto LookML. Da qui puoi convalidare il tuo LookML, quindi creare il commit iniziale ed eseguire il deployment in produzione per rendere il tuo progetto disponibile in modalità di 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 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 Looker. Looker esegue i commit utilizzando il nome utente Looker di uno sviluppatore in modo da poter distinguere lo sviluppatore che ha eseguito ciascun commit. Puoi visualizzare la cronologia dei commit del tuo progetto nell'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 dei 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 Impostazioni dal menu dell'icona a sinistra per aprire la pagina 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 Reimposta connessione Git.

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

    Diagramma che mostra l'avanzamento dalla pagina Impostazioni progetto alla pagina Configura Git. Nei nuovi progetti verrà visualizzato un pulsante Configura Git, mentre per i progetti esistenti verrà visualizzato un pulsante Reimposta Git Connect, ma entrambi i pulsanti portano 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 (repositori 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 negli appunti.

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

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

    Devi includere l'ssh:// affinché questa operazione funzioni correttamente.

  6. Looker rileverà il tuo provider Git e mostrerà una chiave di deployment per il tuo repository. Se Looker non riesce a rilevare correttamente il provider Git, ti chiederà di scegliere da un menu a discesa. Copia la chiave di deployment negli appunti, quindi seleziona il link Esegui il deployment delle impostazioni della chiave per il repository per aprire la pagina Esegui il deployment delle chiavi di GitHub 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 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 al 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 Salta 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 eseguire il deployment in produzione per rendere il tuo progetto disponibile in modalità di produzione. Inoltre puoi:

Configurazione di un repository Git semplice

Se non hai ancora creato un repository Git remoto o se vuoi configurarlo rapidamente in modo che altri utenti possano trarre vantaggio dal tuo LookML, puoi configurare un repository Git semplice. Se configuri un repository Git semplice, viene creato un repository Git locale sull'istanza di Looker, anziché la connessione a un repository remoto.

Quando selezioni l'opzione per creare un repository semplice, Looker crea il repository sul 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 Impostazioni dal menu dell'icona a sinistra per aprire la pagina 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 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 di tutti i rami, consulta la pagina delle best practice sulla migrazione a un nuovo repository Git.

  4. Seleziona Configura invece un repository semplice nella parte inferiore della pagina Configura Git, sopra il pulsante Continua.

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

    Una volta creato il repository Git, Looker visualizza la finestra di dialogo Repository Bare creato.

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

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

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

La configurazione di Git per il controllo della versione è un passaggio fondamentale nella creazione di un nuovo progetto LookML. In genere, ogni progetto dovrebbe 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 istanze
  • Quando recuperi il codice da un progetto LookML non funzionante o defunto per utilizzarlo in un nuovo progetto

Questa sezione descrive le best practice per configurare un nuovo progetto LookML con un repository Git esistente e 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à completato con oggetti LookML provenienti da un repository esistente, anziché da uno schema di database o da una query SQL.
  2. Configura Git per il tuo progetto utilizzando HTTPS o SSH, utilizzando l'URL del 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 a LookML nel progetto non avranno effetto sul repository originale, ma verranno salvate nella versione locale del repository.

Se vuoi utilizzare un repository pubblico specifico come base di un progetto LookML vuoto, ma non hai accesso in scrittura a quel repository, segui le istruzioni descritte nella sezione Clonazione di 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 Community su Flusso di lavoro Git utilizzando un repository su più istanze (sviluppo, gestione temporanea e produzione per ulteriori informazioni).

Test della connessione Git in corso...

Looker fornisce un test della connessione Git per verificare la tua connessione Git. Il test di connessione di Git verifica che sia stato configurato l'URL Git corretto e che l'host Git sia raggiungibile da Looker . Il test di connessione Git verifica anche che tu abbia 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 tuo repository Git, il pulsante Git mostra il testo Test Git Connection per chiederti di risolvere i problemi di connessione.

Puoi anche accedere allo strumento di test della connessione Git selezionando Test Git Connection nel riquadro Git actions (Azioni Git):

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

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

Se un passaggio ha esito positivo, Looker mostra un segno di spunta verde a sinistra del passaggio. Se un passaggio non va a buon fine, Looker mostra un segno di spunta rosso a sinistra del passaggio e un messaggio di errore.

L'esempio seguente mostra un test riuscito:

Finestra di dialogo Test di connessione di Git che mostra un elenco di passaggi con segni di spunta verdi accanto per indicare che tutti i passaggi sono andati a buon fine.

Nell'esempio seguente, il repository Git non dispone di una chiave di deployment configurata per la connessione Looker. I segni di spunta verdi a sinistra dei primi tre passaggi indicano che questi passaggi sono andati a buon fine:

  • 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 i seguenti passaggi non sono riusciti:

  • Verify authorization credentials
  • Ensure credentials allow write access

Finestra di dialogo Test di connessione di Git che mostra un elenco dei passaggi riusciti e non riusciti. Un errore nel passaggio Verifica credenziali di autorizzazione indica Impossibile eseguire l&#39;autenticazione su remoto (chiave di deployment di Looker).