Con l'integrazione di Git di Looker predefinita, gli sviluppatori di Looker eseguono il commit delle modifiche nel ramo di sviluppo, quindi uniscono il ramo di sviluppo al ramo di produzione. Poi, quando esegui il deployment nell'ambiente Looker, Looker utilizza l'ultimo commit sul ramo di produzione. Consulta la pagina della documentazione Utilizzo del controllo della versione e del deployment per il flusso di lavoro Git predefinito e altre opzioni per le implementazioni avanzate di Git.
Per le implementazioni di Git avanzate in cui non vuoi che venga utilizzato l'ultimo commit sul ramo di produzione per il tuo ambiente Looker, un amministratore di Looker può attivare la modalità di deployment avanzata. Se attivata, la modalità di deployment avanzata consente a uno sviluppatore con autorizzazione deploy di specificare un tag o un SHA commit diverso da eseguire nel tuo ambiente di produzione di Looker, anziché utilizzare l'ultimo commit nel ramo di produzione. Se vuoi eseguire il deployment di un commit da un ramo diverso, puoi utilizzare la modalità di deployment avanzata webhook o endpoint API.
La modalità di deployment avanzata consente di consolidare i repository nei flussi di lavoro degli sviluppatori multi-ambiente, in cui ogni ambiente punta a una versione diversa di una base di codice. Inoltre, offre a uno o più sviluppatori o amministratori un maggiore controllo sulle modifiche implementate in produzione.
Quando la modalità di deployment avanzata è attivata, Looker non chiede agli sviluppatori di eseguire il deployment delle modifiche in produzione. Al contrario, Looker chiede agli sviluppatori di unire le modifiche al branch di produzione. Da qui, le modifiche possono essere implementate solo nei seguenti modi:
- Utilizzo del deployment manager
- Attivazione di un webhook
- Utilizzo di un endpoint API
Attivazione della modalità di deployment avanzata
Per attivare la modalità di deployment avanzata:
- Nell'IDE di Looker, vai alla pagina Configurazione progetto selezionando l'icona Impostazioni dal menu delle icone e poi la scheda Configurazione.
- Nella pagina Configurazione progetto, seleziona la casella di controllo accanto ad Attiva modalità di deployment avanzata nella sezione Deployment.
- Seleziona il pulsante Salva configurazione progetto per salvare la modifica.
Controllo della versione con la modalità di deployment avanzata
Quando la modalità di deployment avanzata è attivata, il deployment in produzione da Looker non è più un'opzione per gli sviluppatori. Quando lo sviluppatore esegue un commit, il pulsante Git gli chiede di unire le modifiche al ramo principale anziché eseguire il deployment in produzione.
Le modifiche vengono implementate in produzione utilizzando un webhook, l'API o il gestore del deployment.
Deployment Manager
Per i progetti con la modalità di deployment avanzata abilitata, gli sviluppatori di Looker che dispongono dell'autorizzazione deploy possono utilizzare il deployment manager per eseguire il deployment di un commit o di un tag nell'ambiente di produzione di Looker.
Puoi accedere a Deployment Manager selezionando l'icona Esegui il deployment dal menu delle icone.
Deployment Manager mostra tutti i commit e i tag di cui è stato eseguito il deployment in precedenza utilizzando la modalità di deployment avanzata.
Se non hai ancora utilizzato la modalità di deployment avanzata per eseguire il deployment di un commit, fai clic sul pulsante Seleziona commit per visualizzare la cronologia dei commit con i commit che gli sviluppatori di Looker hanno unito al ramo di produzione.
Per i progetti che hanno utilizzato la modalità di deployment avanzata per eseguire il deployment di un commit, la cronologia dei commit mostrerà anche gli eventuali tag associati a un commit e indicherà quale commit è la versione corrente utilizzata per la produzione.
Se il ramo di produzione contiene commit più recenti rispetto al commit di cui è stato eseguito il deployment, il gestore del deployment mostra queste informazioni e il commit più recente che gli sviluppatori di Looker hanno unito al ramo di produzione.
Eseguire il deployment di un commit dal deployment manager
Esistono diversi modi per eseguire il deployment di un commit dal deployment manager:
- Per eseguire il deployment di un commit che non è stato ancora eseguito, fai clic sul pulsante Seleziona commit per scegliere tra tutti i commit che sono stati uniti al ramo di produzione remoto. Se vuoi eseguire il deployment di un commit da un ramo diverso, utilizza la modalità di deployment avanzata webhook o endpoint API.
- Per eseguire il deployment dell'ultimo commit unito nel ramo di produzione remoto, fai clic sul pulsante Esegui il deployment dell'ultima versione.
- Per eseguire il deployment di un commit o di un tag di cui è stato eseguito il deployment in precedenza, fai clic sul menu con tre puntini Opzioni nel deployment manager e poi su Esegui il deployment in produzione.
Se scegli un commit che non è stato di cui non è stato eseguito il deployment in precedenza, il gestore del deployment mostrerà il menu Esegui il deployment del commit. Per eseguire il deployment di un commit dal menu Esegui il deployment del commit:
- Per eseguire il deployment del commit senza assegnargli un tag, seleziona Esegui il deployment senza tagging e Esegui il deployment nell'ambiente. In caso contrario, mantieni selezionata l'opzione Etichetta e implementa.
Specifica un tag per il commit. Un tag Git indica l'importanza del commit nella cronologia del repository, ad esempio un numero di release o il nome della versione. Tieni presente quanto segue sui tag Git:
- I tag Git devono essere univoci all'interno del repository Git. Non puoi utilizzare lo stesso tag per due commit diversi nel tuo repository.
- I tag Git non possono contenere spazi o determinati caratteri speciali. Consulta la documentazione di riferimento di Git per le regole di denominazione dei riferimenti in Git.
Se vuoi, puoi aggiungere una descrizione al tag per fornire ulteriori dettagli sul commit.
Seleziona Esegui il deployment nell'ambiente per eseguire il deployment del commit nella versione di produzione dell'istanza di Looker.
Una volta eseguito il deployment di un commit, Deployment Manager lo contrassegnerà come versione corrente nell'ambiente di produzione di Looker.
Eseguire il deployment con webhook
Per i progetti con modalità di deployment avanzata, puoi utilizzare il webhook di deployment per eseguire il deployment delle modifiche in produzione.
Per configurare l'webhook di deployment, devi prima aggiungere un segreto webhook per il tuo progetto Looker dalla pagina Configurazione progetto. L'aggiunta di un secret webhook garantisce che solo le parti autorizzate possano attivare il webhook di deployment.
Sono disponibili due webhook per eseguire il deployment delle modifiche in produzione con la modalità di deployment avanzata abilitata. Un webhook è per il deployment del commit iniziale di un ramo, mentre l'altro è per il deployment di un tag o di un SHA Git specifico.
Il webhook per il deployment del commit iniziale di un ramo utilizza questo formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>
L'webhook per il deployment di un tag o di un SHA commit utilizza questo formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>
Sostituisci le informazioni tra parentesi angolari < >v1.0 per il progetto e_faa nell'istanza Looker docsexamples.dev.looker.com:
https://docsexamples.dev.looker.com/webhooks/projects/e_faa/deploy/ref/v1.0
Deployment con l'API
Per i progetti con modalità di deployment avanzata, puoi utilizzare l'API Looker per eseguire il deployment delle modifiche in produzione.
Per eseguire il deployment con l'API, l'utente dell'API che effettua la chiamata deve disporre dell'autorizzazione deploy. Per ulteriori informazioni sull'autenticazione e sull'utilizzo dell'API Looker, consulta le pagine di documentazione Autenticazione API Looker e Introduzione all'API.
Per eseguire il deployment con l'API, utilizza l'endpoint deploy_ref_to_production. Questo endpoint può essere chiamato in diversi modi. Gli esempi riportati di seguito si riferiscono ai metodi HTTPS e SDK.
HTTPS
Per eseguire il deployment manualmente utilizzando l'endpoint API deploy_ref_to_production, consulta gli esempi riportati di seguito, che utilizzano il metodo HTTPS. Per ulteriori informazioni ed esempi di chiamata manuale dell'API utilizzando le richieste CURL, consulta il file readme di GitHub Come autenticarsi nell'API o utilizza API Explorer. Puoi installare API Explorer nella tua istanza Looker dal Looker Marketplace.
Utilizza i seguenti esempi in una richiesta HTTPS per eseguire il deployment del commit HEAD di un ramo o di un tag o SHA commit specifico tramite l'endpoint API deploy_ref_to_production:
Esegui il deployment del commit iniziale di un ramo:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>
Esegui il deployment di un tag o di un'SHA del commit:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>
SDK
In alternativa, utilizza uno degli SDK di Looker anziché inviare richieste manuali all'API. Gli SDK gestiscono i dettagli dell'autenticazione, della serializzazione dei parametri e delle risposte e altri aspetti.
Il deployment con deploy_ref_to_production con il metodo SDK ha il seguente aspetto:
Esegui il deployment del commit iniziale di un ramo:
deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})
Esegui il deployment di un tag o di un'SHA del commit:
deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})