Declarative Automation Bundles (DABs)
Use this skill for any bundle-related request including creating, configuring, validating, deploying, running, and managing Databricks resources through DABs.
Reference Documentation
The following reference files provide detailed guidance for specific bundle tasks:
- Bundle Structure - Bundle structure, databricks.yml configuration, resource definitions, path resolution, variables, and multi-environment targets
- SDP Pipelines - Spark Declarative Pipeline configurations for DABs
- SQL Alerts - SQL Alert schemas and configuration (critical - API differs from other resources)
- Deploy and Run - Validation, deployment, running resources, monitoring logs, and troubleshooting common issues
- Resource Permissions - Permission levels and access control for bundle resources, per-resource-type levels, grants vs permissions
When to Use This Skill
Load this skill for any request involving:
- Creating new bundle projects or resources
- Configuring databricks.yml or resource YAML files
- Setting up multi-environment deployments (dev/prod targets)
- Deploying or running bundle resources
- Managing permissions for bundle resources
- Troubleshooting bundle validation or deployment errors
- Working with specific resource types (dashboards, jobs, pipelines, alerts, volumes, apps)
General Guidelines
- Always validate after configuration changes - Use
bundle validate --strict --target <target> after any change
- Use reference documentation - Consult the appropriate reference file for detailed patterns and examples
- Follow naming conventions - Resource files should use
<name>.<resource_type>.yml format
- Path resolution is critical - Paths differ based on file location (see Bundle Structure reference)
- Preserve existing structure - Keep user comments and structure when editing YAML files
- Use variables - Parameterize catalog, schema, and warehouse for multi-environment support
Documentation
1---2name: databricks-dabs3description: Create, configure, validate, deploy, run, and manage Declarative Automation Bundles (DABs, formerly Databricks Asset Bundles). Use when working with Databricks resources via DABs including dashboards, jobs, pipelines, alerts, volumes, and apps.4---5
6# Declarative Automation Bundles (DABs)
7
8Use this skill for any bundle-related request including creating, configuring, validating, deploying, running, and managing Databricks resources through DABs.
9
10## Reference Documentation
11
12The following reference files provide detailed guidance for specific bundle tasks:
13
14- **[Bundle Structure](references/bundle-structure.md)** - Bundle structure, databricks.yml configuration, resource definitions, path resolution, variables, and multi-environment targets
15- **[SDP Pipelines](references/sdp-pipelines.md)** - Spark Declarative Pipeline configurations for DABs
16- **[SQL Alerts](references/alerts.md)** - SQL Alert schemas and configuration (critical - API differs from other resources)
17- **[Deploy and Run](references/deploy-and-run.md)** - Validation, deployment, running resources, monitoring logs, and troubleshooting common issues
18- **[Resource Permissions](references/resource-permissions.md)** - Permission levels and access control for bundle resources, per-resource-type levels, grants vs permissions
19
20## When to Use This Skill
21
22Load this skill for any request involving:
23
24- Creating new bundle projects or resources
25- Configuring databricks.yml or resource YAML files
26- Setting up multi-environment deployments (dev/prod targets)
27- Deploying or running bundle resources
28- Managing permissions for bundle resources
29- Troubleshooting bundle validation or deployment errors
30- Working with specific resource types (dashboards, jobs, pipelines, alerts, volumes, apps)
31
32## General Guidelines
33
341. **Always validate after configuration changes** - Use `bundle validate --strict --target <target>` after any change
352. **Use reference documentation** - Consult the appropriate reference file for detailed patterns and examples
363. **Follow naming conventions** - Resource files should use `<name>.<resource_type>.yml` format
374. **Path resolution is critical** - Paths differ based on file location (see Bundle Structure reference)
385. **Preserve existing structure** - Keep user comments and structure when editing YAML files
396. **Use variables** - Parameterize catalog, schema, and warehouse for multi-environment support
40
41## Documentation
42
43- [Declarative Automation Bundles](https://docs.databricks.com/dev-tools/bundles/)
44- [Bundle Examples Repository](https://github.com/databricks/bundle-examples) - official end-to-end example bundles (jobs, pipelines, dashboards, apps, and more); use as working references for patterns not covered by the reference files above
gabrielmoreira