Historique de déploiement du bundle
Aperçu
Cette fonctionnalité est en aperçu privé. Pour l'essayer, veuillez contacter votre conseiller Databricks.
L'historique du déploiement fournit un enregistrement structuré et auditable de chaque déploiement de Declarative Automation Bundles dans votre workspace. Un déploiement est un bundle déployé sur une cible spécifique. À chaque déploiement, une nouvelle version est enregistrée.
Pour chaque déploiement, vous pouvez examiner :
- Métadonnées de déploiement : l’identité de la personne ayant effectué le déploiement, le Timestamp, la cible et le statut résultant.
- Contexte de contrôle de source : le repository Git, la branch, le commit SHA et tout tag de version associé à la version.
- Modifications des ressources : les ressources créées, mises à jour, supprimées ou recréées dans chaque version, ainsi que les différences de configuration.
- État post-déploiement : l'inventaire complet des ressources gérées par le déploiement, telles que les jobs, les LakeFlow Pipelines, les tableaux de bord et les Unity Catalog tables.
L'historique du déploiement est un emplacement unique pour valider les déploiements, étudier les régressions et répondre à des questions telles que : qui a modifié un Job ou un pipeline en dernier ? Il s'agit de la base des déploiements gouvernés pour les équipes qui gèrent les ressources Databricks en tant que code.
Pour une vue d’ensemble des bundles, consultez What are Declarative Automation Bundles?. Pour savoir comment déployer un bundle, consultez Deploy bundles and run workflows from the workspace et Declarative Automation Bundles deployment modes.
Activer l’historique de déploiement
Pour enregistrer l’historique de déploiement d’un bundle, définissez record_deployment_history sur true dans la configuration du bundle. Voir la référence de configuration.
Afficher les déploiements
Pour afficher les déploiements, effectuez l'une des actions suivantes :
- Depuis le volet Deployments d'un bundle, ouvrez l'historique de déploiement de ce bundle. Voir Déployer des bundles et exécuter des workflows depuis le workspace.
- Pour un job, un pipeline ou un tableau de bord géré par un bundle, utilisez l’indicateur Managed by pour accéder au déploiement qui le possède.
- Recherchez un bundle par son nom pour ouvrir directement son historique de déploiement.
La liste des déploiements affiche tous les déploiements (ainsi que les versions et ressources correspondantes) auxquels vous avez un accès CAN_READ.
Vous pouvez filtrer et trier la liste selon les colonnes suivantes :
Colonne | Description |
|---|---|
Nom | Le bundle et la cible, ou le nom d’affichage du déploiement. |
Cible | La cible de déploiement, telle que |
Statut | L’état du dernier déploiement. |
Dernier déploiement le / par | Date de la dernière exécution du déploiement et identité de l'utilisateur l'ayant exécuté. |
Nombre de ressources | Le nombre de ressources que le déploiement gère. |
Afficher les détails de la version du déploiement
Sélectionnez un déploiement dans l'historique des déploiements pour ouvrir ses détails, puis sélectionnez une version pour découvrir des informations telles que la date et l'auteur du déploiement, le repository Git source et la branch, le commit SHA (lié au diff dans votre fournisseur Git) et le tag de release, le cas échéant.
Utilisez le menu déroulant de l'historique des versions dans l'en-tête pour naviguer entre les versions.
Modifications des ressources
L’onglet Changes répertorie les modifications apportées aux ressources dans la version sélectionnée. Il inclut :
- Modifications des ressources : un tableau des actions effectuées par ressource, indiquant la clé de ressource (telle que
jobs.ETL_Main), l'action (Create, Update, Delete ou Recreate), le statut et le Timestamp. - Différences de configuration : une comparaison côte à côte qui met en évidence les paramètres modifiés, tels que la taille des clusters ou la planification.
- Snapshots de notebook : pour les ressources de type notebook, un Link vers la révision du notebook qui a été déployée.
- Erreurs : les mises à jour ayant échoué affichent un message d’erreur en ligne.
État post-déploiement
L'onglet Post-deploy state tab affiche l'inventaire des ressources actives gérées par le déploiement après l'application de la version :
- Clé et type de ressource : Le nom logique et le type de ressource.
- ID Databricks : l'ID de ressource physique, lié à la ressource dans le workspace.
- Dernière modification : la version qui a modifié la ressource en dernier, telle que
Changed in v42.
Historique du déploiement depuis la CLI
Pour les workflows automatisés, vous pouvez accéder à l'historique des déploiements avec les commandes bundle-deployments de la CLI Databricks. Voir databricks bundle-deployments.
Limitations
- L'historique de déploiement n'est disponible que pour les nouvelles cibles de déploiement de bundles. Il n'existe pas encore de chemin de migration pour les bundles ou les cibles existants.
- Les entités sous-jacentes des déploiements (telles que les exécutions de job) peuvent être soumises à des politiques de rétention.
- Seuls les déploiements utilisant le moteur direct sont pris en charge. Voir Migrer vers le moteur de déploiement direct.