Histórico de implantações de pacotes
Beta
Este recurso está na Beta.
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 recurso : os recursos criados, atualizados, excluídos ou recriados em cada versão.
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
A história de implantação está disponível no Databricks CLI versão 1.23.0 e acima.
A história de deploy está ativada por default para bundles que você implanta do Workspace. Você pode alternar essa configuração para todos os Workspace em sua account ou defini-la para um bundle específico na configuração do bundle.
Configuração da account de história de implantação
A configuração História de implantação controla se os bundles implantados por você a partir do Workspace registram a história de implantação. A configuração se aplica a todos os Workspace em sua conta.
Para alterar a configuração, faça o seguinte:
- No editor de pacote, clique em história de implantação na parte superior do painel Implantações e alterne a configuração. Para obter informações sobre implantações de pacotes, consulte Implantar pacotes e executar fluxos de trabalho do workspace.
- Clique no seu nome de usuário no canto superior direito do seu workspace e clique em Configurações . Na barra lateral Configurações , selecione Desenvolvedor . Em Recursos experimentais , ative História de implantação .
A configuração de usuário história de implantação aplica-se apenas a implantações do Workspace. Para registrar a história de implantação ao implantar com a CLI do Databricks, defina experimental.deployment_history como true. Veja experimental.
Substitua a configuração de um pacote
Para habilitar ou desabilitar a história de implantação para um bundle específico, defina experimental.deployment_history na configuração do bundle:
experimental:
deployment_history: true
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. |
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.
As alterações de recursos são listadas em uma tabela onde cada linha contém a key para o recurso alterado (como jobs.ETL_Main), a ação (Criar, Atualizar, Excluir ou Recriar) tomada no recurso, o status do recurso e o timestamp da alteração.
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ção é registrado com base de melhor esforço e ainda não é a fonte da verdade para o estado da implantação. Em casos raros, como durante problemas de infraestrutura do Databricks, as entradas da história podem estar ausentes mesmo quando uma implantação é bem-sucedida.
- 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.