Histórico de implantações de pacotes
Visualização
Esse recurso está em Prévia privada. Para experimentar, fale com o seu contato no Databricks.
O histórico de implantações fornece um registro estruturado e auditável de cada implantação de Declarative Automation Bundles no seu Workspace. Uma implantação é um pacote implantado em um destino específico. Cada vez que você realiza uma implantação, uma nova versão é registrada.
Para cada deploy, você pode revisar:
- Metadados de implantação : a identidade de quem realizou a implantação, o timestamp, o destino e o status resultante.
- Contexto de controle de origem : o repositório Git, a branch, o SHA do commit e qualquer tag de release associada à versão.
- Alterações de recursos : os recursos criados, atualizados, excluídos ou recriados em cada versão, juntamente com as diferenças de configuração.
- Estado pós-implantação : o inventário completo de recursos gerenciados pela implantação, como jobs, Lakeflow pipelines, painéis e tabelas do Unity Catalog.
O histórico de deploys é um local único para validar deploys, investigar regressões e responder a perguntas como quem modificou um job ou pipeline pela última vez. É a base para deploys governados para equipes que gerenciam recursos do Databricks como código.
Para obter uma visão geral dos pacotes, consulte O que são os Pacotes de Automação Declarativa?. Para saber como implantar um pacote, consulte Implantar pacotes e executar fluxos de trabalho a partir do workspace e Modos de implantação dos Pacotes de Automação Declarativa.
Ativar histórico de implantações
Para registrar o histórico de implantação de um pacote, defina record_deployment_history como true na configuração do pacote. Consulte Referência de configuração.
Ver implantações
Para visualizar implantações, siga um destes procedimentos:
- No painel Deployments de um pacote, abra o histórico de implantação desse pacote. Consulte Implantar pacotes e executar fluxos de trabalho a partir do workspace.
- Para um job, pipeline ou dashboard gerenciado por um bundle, use o indicador Managed by para saltar para a implantação que o possui.
- Pesquise um pacote pelo nome para abrir seu histórico de implantações diretamente.
A lista de implantações exibe todas as implantações (e as versões e recursos correspondentes) às quais você tem acesso de CAN_READ.
Você pode filtrar e classificar a lista pelas seguintes colunas:
Coluna | Descrição |
|---|---|
Nome | O pacote e o destino, ou o nome de exibição da implantação. |
Destino | O destino de implantação, como |
Status | O status da última implantação. |
Última implantação em / por | Quando a implantação foi executada pela última vez e a identidade que a executou. |
Contagem de recursos | O número de recursos que a implantação gerencia. |
Ver detalhes da versão da implantação
Selecione uma implantação no histórico de implantações para abrir seus detalhes e, em seguida, selecione uma versão para descobrir informações como quando a implantação foi iniciada e por quem, o repositório Git de origem e a branch, o SHA do commit (vinculado ao diff no seu provedor Git) e a tag de lançamento, se aplicável.
Use o dropdown de histórico de versões no cabeçalho para alternar entre as versões.
Alterações de recursos
A tab Changes lista as alterações feitas nos recursos na versão selecionada. Isso inclui:
- Alterações de recurso : uma tabela das ações realizadas por recurso, mostrando a key do recurso (como
jobs.ETL_Main), a ação (Create, Update, Delete ou Recreate), o status e o Timestamp. - Diferença de configuração : Uma comparação lado a lado que destaca quais configurações foram alteradas, como o tamanho do cluster ou o programar.
- Snapshots de Notebook : para recursos de notebook, um link para a revisão do notebook que foi implantada.
- Erros : atualizações com falha mostram uma mensagem de erro em linha.
Estado pós-implantação
A tab Post-deploy state mostra o inventário de recursos ativos que a implantação gerencia após a versão ter sido aplicada:
- Key e tipo de recurso : O nome lógico e o tipo de recurso.
- ID do Databricks : O ID de recurso físico, vinculado ao recurso no workspace.
- Última alteração : a versão que modificou o recurso pela última vez, como
Changed in v42.
Histórico de implantações da CLI
Para fluxos de trabalho automatizados, você pode acessar o histórico de implantação com os comandos bundle-deployments da CLI do Databricks. Consulte databricks bundle-deployments.
Limitações
- O histórico de implantações só está disponível para novos destinos de implantação de pacotes. Ainda não há um caminho de migração para pacotes ou destinos existentes.
- As entidades subjacentes de implantações (como execuções de job) podem ter políticas de retenção.
- Apenas implantações que usam o mecanismo direto são compatíveis. Consulte Migrar para o mecanismo de implantação direta.