Modalità di deployment avanzata

Con l'integrazione Git predefinita di Looker, gli sviluppatori di Looker eseguono il commit delle modifiche al branch di sviluppo, quindi uniscono il branch di sviluppo al branch di produzione. Successivamente, quando esegui il deployment nell'ambiente Looker, Looker utilizza l'ultimo commit nel branch di produzione. (Per il flusso di lavoro Git predefinito e altre opzioni per le implementazioni Git avanzate, consulta la pagina della documentazione Utilizzo del controllo della versione ed esecuzione del deployment.)

Per le implementazioni Git avanzate in cui non vuoi che l'ultimo commit nel branch di produzione venga utilizzato per l'ambiente Looker, un amministratore di Looker può attivare la modalità di deployment avanzata. Quando è attivata, la modalità di deployment avanzata consente a uno sviluppatore con l'autorizzazione deploy di specificare una SHA di commit o un tag diverso da eseguire il deployment nell'ambiente di produzione di Looker, anziché utilizzare l'ultimo commit nel branch di produzione. Se vuoi eseguire il deployment di un commit da un branch diverso, puoi utilizzare la modalità di deployment avanzata webhook o l'endpoint API.

La modalità di deployment avanzata consente di consolidare i repository nei flussi di lavoro degli sviluppatori multiambiente, in cui ogni ambiente rimanda a una versione diversa di una codebase. Inoltre, offre a uno o più sviluppatori o amministratori un maggiore controllo sulle modifiche di cui viene eseguito il deployment in produzione.

Quando la modalità di deployment avanzata è attivata, Looker non chiede agli sviluppatori di eseguire il deployment delle modifiche in produzione. Looker chiede invece agli sviluppatori di unire le modifiche nel branch di produzione. Da qui, le modifiche possono essere eseguite solo nei seguenti modi:

• Utilizzando il deployment manager
• Attivando un webhook
• Utilizzando un endpoint API

Nota: per i progetti in cui è attivata la modalità di deployment avanzata, se il progetto non è mai stato eseguito in produzione, il deployment iniziale in produzione deve essere eseguito con Deployment Manager. Non puoi utilizzare l'API o il webhook per il deployment iniziale di un progetto in cui è attivata la modalità di deployment avanzata. Dopo il deployment iniziale in produzione (anche se inizialmente è stato eseguito senza la modalità di deployment avanzata), puoi utilizzare il webhook o l'API per eseguire il deployment delle modifiche successive in produzione con la modalità di deployment avanzata.

Attivare la modalità di deployment avanzata

Per attivare la modalità di deployment avanzata:

1. Nell'IDE di Looker, vai alla pagina Configurazione progetto selezionando l'icona Impostazioni dal menu delle icone e poi selezionando la scheda Configurazione.
2. Nella pagina Configurazione progetto, seleziona la casella di controllo accanto a Attiva modalità di deployment avanzata nella sezione Deployment.
3. 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 branch principale anziché di eseguire il deployment in produzione.

Il deployment delle modifiche in produzione viene eseguito utilizzando un webhook, l'API o Deployment Manager.

Deployment Manager

Per i progetti in cui è attivata la modalità di deployment avanzata, gli sviluppatori di Looker che dispongono dell'autorizzazione deploy possono utilizzare 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.

Nota: come descritto nella sezione Eseguire il deployment di un commit da Deployment Manager in questa pagina, puoi eseguire il deployment di un commit con o senza un tag. Se esegui il deployment di un commit con un tag, Deployment Manager visualizza la SHA tag, che è diversa da una SHA commit. Puoi utilizzare la cronologia dei commit del progetto Looker per visualizzare la SHA di commit associata a un tag. In caso contrario, se esegui il deployment di un commit senza un tag, Deployment Manager visualizza la SHA di commit, che è la stessa SHA di commit che puoi visualizzare nell'interfaccia del tuo provider Git o nella cronologia dei commit del progetto Looker.

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 branch 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 i tag associati a un commit, se presenti, e indicherà quale commit è la versione corrente utilizzata per la produzione.

Se il branch di produzione ha commit più recenti rispetto al commit di cui è stato eseguito il deployment, Deployment Manager visualizza queste informazioni e mostra il commit più recente che gli sviluppatori di Looker hanno unito al branch di produzione.

Eseguire il deployment di un commit da Deployment Manager

Esistono diversi modi per eseguire il deployment di un commit da Deployment Manager:

1. Per eseguire il deployment di un commit di cui non è ancora stato eseguito il deployment, fai clic sul pulsante Seleziona commit per selezionare tutti i commit che sono stati uniti al branch di produzione remoto. (Se vuoi eseguire il deployment di un commit da un branch diverso, utilizza la modalità di deployment avanzata webhook o endpoint API.)
2. Per eseguire il deployment del commit unito più di recente nel branch di produzione remoto, fai clic sul pulsante Esegui il deployment dell'ultimo.
3. 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 da Deployment Manager e poi su Esegui il deployment in produzione.

Se scegli un commit di cui non è stato eseguito il deployment in precedenza, Deployment Manager visualizzerà il menu Esegui il deployment del commit. Per eseguire il deployment di un commit dal menu Esegui il deployment del commit, segui questi passaggi:

1. Per eseguire il deployment del commit senza assegnargli un tag, seleziona Esegui il deployment senza tag e poi Esegui il deployment nell'ambiente. In caso contrario, mantieni selezionata l'opzione Tagga ed esegui il deployment.

2. Specifica un tag per il commit. Un tag Git contrassegna il significato del commit nella cronologia del repository, ad esempio un numero di release o un nome di 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 repository.
   • I tag Git non possono contenere spazi o determinati caratteri speciali. Per le regole per la denominazione dei riferimenti in Git, consulta la documentazione di riferimento di Git.

3. Se vuoi, puoi aggiungere una descrizione per il tag per fornire ulteriori dettagli sul commit.

4. Seleziona Esegui il deployment nell'ambiente per eseguire il deployment del commit nella versione di produzione dell'istanza 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 i webhook

Per i progetti con la modalità di deployment avanzata, puoi utilizzare il webhook di deployment per eseguire il deployment delle modifiche in produzione.

Nota: quando la modalità di deployment avanzata è attivata per un nuovo progetto, devi utilizzare Deployment Manager per il deployment iniziale del progetto in produzione. Una volta eseguito il deployment del progetto in produzione (anche se inizialmente è stato eseguito senza la modalità di deployment avanzata), puoi utilizzare il webhook di deployment per eseguire il deployment delle modifiche successive in produzione utilizzando la modalità di deployment avanzata.

Per configurare il webhook di deployment, devi prima aggiungere un secret webhook per il 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 attivata. Un webhook serve per eseguire il deployment dell'intestazione di un branch, mentre l'altro serve per eseguire il deployment di una SHA o di un tag Git specifici.

Il webhook per eseguire il deployment dell'intestazione di un branch utilizza questo formato:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>

Il webhook per eseguire il deployment di una SHA o di un tag di commit utilizza questo formato:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>

Sostituisci le informazioni tra parentesi angolari < > con le informazioni specifiche dell'indirizzo dell'istanza, del progetto LookML e del nome del branch o della SHA/del tag di commit. Ecco un webhook di esempio per eseguire il deployment del nome del tag 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

Eseguire il deployment con l'API

Per i progetti con la modalità di deployment avanzata, puoi utilizzare l'API Looker per eseguire il deployment delle modifiche in produzione.

Nota: quando la modalità di deployment avanzata è attivata per un nuovo progetto, devi utilizzare Deployment Manager per il deployment iniziale del progetto in produzione. Una volta eseguito il deployment del progetto in produzione (anche se inizialmente è stato eseguito senza la modalità di deployment avanzata), puoi utilizzare l'API per eseguire il deployment delle modifiche successive in produzione utilizzando la modalità di deployment avanzata.

Per eseguire il deployment con l'API, l'utente API che effettua la chiamata deve disporre dell'autorizzazione deploy. Per ulteriori informazioni sull'autenticazione e sull'utilizzo dell'API Looker, consulta le pagine della documentazione Autenticazione dell'API Looker e Inizia a utilizzare l'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 seguenti riguardano i metodi HTTPS e SDK.

HTTPS

Nota: quando utilizzi gli esempi seguenti, assicurati di sostituire le informazioni tra parentesi angolari < > con le informazioni specifiche dell'indirizzo dell'istanza, del progetto LookML, del nome del branch, della SHA o del tag.

Per eseguire il deployment manualmente utilizzando l'endpoint API deploy_ref_to_production, consulta gli esempi seguenti, che utilizzano il metodo HTTPS. Per ulteriori informazioni ed esempi di chiamate manuali all'API utilizzando le richieste CURL, consulta il file README di GitHub su come eseguire l'autenticazione all'API o utilizza l'Explorer API. Puoi installare l'Explorer API nella tua istanza Looker da Looker Marketplace.

Utilizza gli esempi seguenti in una richiesta HTTPS per eseguire il deployment dell'intestazione di un branch o di una SHA o di un tag di commit specifici tramite l'endpoint API deploy_ref_to_production:

Esegui il deployment dell'intestazione di un branch: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>

Esegui il deployment di una SHA o di un tag di commit: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>

SDK

Nota: quando utilizzi gli esempi seguenti, assicurati di sostituire le informazioni tra parentesi angolari < > con le informazioni specifiche del progetto LookML, del nome del branch, della SHA o del tag.

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 di altri aspetti.

Il deployment con deploy_ref_to_production con il metodo SDK è simile al seguente:

Esegui il deployment dell'intestazione di un branch: deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})

Esegui il deployment di una SHA o di un tag di commit: deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})