Cronologia della distribuzione del bundle

Importante

Questa funzionalità è in versione beta.

La cronologia delle implementazioni fornisce un registro strutturato e auditabile di ogni implementazione dei Declarative Automation Bundles nel tuo spazio di lavoro. Un deployment è un bundle dispiegato su un obiettivo specifico. Ogni volta che si effettua una distribuzione, viene registrata una nuova versione.

Per ogni implementazione, puoi rivedere:

  • Metadati di deployment: l'identità di chi ha distribuito, il timestamp, il target e lo stato risultante.
  • Contesto del controllo del codice sorgente: il repository Git, il ramo, il commit SHA ed eventuali tag di release associati alla versione.
  • Modifiche alle risorse: le risorse create, aggiornate, eliminate o ricreate in ogni versione.

La cronologia delle implementazioni è un unico luogo dove validare le implementazioni, indagare sulle regressioni e rispondere a domande come chi ha modificato per ultima volta un lavoro o una pipeline. È la base per le implementazioni governate per team che gestiscono le risorse di Databrick come codice.

Per una panoramica dei bundle, vedere Che cosa sono i bundle di automazione dichiarativa?. Per scoprire come distribuire un bundle, consulta Distribuire bundle ed eseguire flussi di lavoro dall’area di lavoro e Modalità di distribuzione di Declarative Automation Bundles.

Abilita la cronologia delle distribuzioni

Note

La cronologia del deployment è disponibile nella versione 1.23.0 della CLI di Databricks e successive.

La cronologia di distribuzione è attiva di default per i bundle che distribuisci dallo spazio di lavoro. Puoi attivare questa impostazione per tutti gli spazi di lavoro del tuo account, oppure impostarla per un bundle specifico nella configurazione del bundle.

Impostazione account della cronologia di distribuzione

L'impostazione Cronologia del deployment controlla se i bundle che distribuisci dallo workspace registrano la cronologia del deployment. L'impostazione si applica a ogni spazio di lavoro del tuo account.

Per cambiare l'impostazione, fai una delle seguenti azioni:

Interruttore della cronologia delle implementazioni nel pannello Implementazioni

  • Clicca sul tuo nome utente in alto a destra del tuo spazio di lavoro, poi clicca su Impostazioni. Nella barra laterale Impostazioni selezionare Developer. Sotto Funzionalità sperimentali, attiva/disattiva la cronologia della distribuzione.

Note

L'impostazione Cronologia distribuzione si applica solo alle distribuzioni dall'area di lavoro. Per registrare la cronologia di distribuzione quando si implementa con la CLI Databricks, imposta experimental.deployment_history su true. Vedi la funzionalità sperimentale.

Modifica l'impostazione per un pacchetto

Per abilitare o disabilitare la cronologia di distribuzione di un bundle specifico, impostare experimental.deployment_history nella configurazione del bundle:

experimental:
  deployment_history: true

Visualizza le implementazioni

Per visualizzare le distribuzioni, fai una delle seguenti procedure:

  • Dal pannello Deployment di un bundle, apri la cronologia di deployment di quel bundle. Vedere Distribuire bundle ed eseguire flussi di lavoro dall'area di lavoro.
  • Per un job, una pipeline o una dashboard gestiti da un bundle, usa l'indicatore Managed by per passare direttamente al deployment che ne è proprietario.
  • Cerca un bundle per nome per aprire direttamente la cronologia di implementazione.

La lista delle implementazioni mostra tutte le implementazioni (e le relative versioni e risorse) a cui hai accesso CAN_READ.

Elenco della storia delle missioni

Puoi filtrare e ordinare la lista per le seguenti colonne:

Column Descrizione
Name Il bundle e il target, oppure il nome visualizzato della distribuzione.
Target L'obiettivo di dispiegamento, come dev o prod.
Condizione Lo stato dell'ultimo dispiegamento.

Visualizza dettagli sulla versione di distribuzione

Seleziona una distribuzione dalla cronologia per aprirne i dettagli, poi seleziona una versione per scoprire informazioni come quando è stata avviata la distribuzione e da chi, il repository Git sorgente e il branch, il commit SHA (collegato al diff nel tuo provider Git) e il release tag, se si applica.

Dettagli del dispiegamento

Usa il menu a tendina della cronologia delle versioni nell'intestazione per passare tra le versioni.

Le modifiche alle risorse sono elencate in una tabella dove ogni riga contiene la chiave per la risorsa modificata (come jobs.ETL_Main), l'azione (Crea, Aggiorna, Elimina o Ricrea) effettuata sulla risorsa, lo stato della risorsa e il timestamp della modifica.

Storia del dispiegamento dal CLI

Per i flussi di lavoro automatizzati, puoi accedere alla cronologia di distribuzione con i comandi della CLI bundle-deployments di Databricks. Vedi databricks bundle-deployments.

Limitations

  • La cronologia della distribuzione viene registrata nei limiti del possibile e non è ancora il riferimento autorevole per lo stato della distribuzione. In rari casi, come durante problemi di infrastruttura Databricks, le voci della cronologia possono mancare anche quando una distribuzione ha esito positivo.
  • Le entità sottostanti alle implementazioni (come le run di lavoro) possono avere politiche di retention.
  • Sono supportate solo le implementazioni che utilizzano il motore diretto. Vedere Eseguire la migrazione al motore di distribuzione diretta.

Risorse aggiuntive