Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Feature request: allow bundle init --config-file to read from Unity Catalog Volumes

Open
#6,786 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
68/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
go
Domain
cli

Research direction

Start at the bundle init command's --config-file handling and compare its local-file path with the existing Databricks-authenticated filesystem access used for Volume files. Verify that exact dbfs:/Volumes/ paths use the selected profile, preserve local-file behavior, avoid a local copy, and report authentication, permission, path, and JSON validation failures clearly.

Written by the indexing model from the issue text.

Description

Summary

Allow databricks bundle init to read its --config-file directly from an exact Unity Catalog Volume path.

For example:

databricks bundle init https://github.com/my-org/my-template \
  --config-file dbfs:/Volumes/customer_shared/config/bootstrap/customer-context.json \
  --output-dir ./my-solution

Motivation

Unity Catalog Volumes are a suitable governed location for non-secret operational configuration shared across customer workspaces.

Today, bundle init --config-file requires a local JSON file. A customer-owned bootstrap workflow must therefore:

  1. authenticate to the workspace;
  2. copy the exact file from the Volume to a temporary local file;
  3. invoke bundle init;
  4. remove the temporary file.

Direct Volume support would remove this wrapper and make governed, customer-owned bootstrap flows simpler while retaining Unity Catalog permissions and auditability.

Databricks already documents Unity Catalog Volumes as an appropriate location for configuration required across workspaces:

https://learn.microsoft.com/en-us/azure/databricks/files/files-recommendations

Proposed behavior

When --config-file receives an exact path beginning with dbfs:/Volumes/:

  • read that single file using the existing Databricks authentication and selected profile;
  • apply the same JSON parsing and template validation used for local files;
  • do not scan the Volume or persist a local copy;
  • fail clearly when authentication, permissions, the file path, or JSON validation fails.

Existing local-file behavior should remain unchanged.

Supporting /Volumes/... as a normalized alias would also be useful, although one canonical CLI form is sufficient.

Current workaround

databricks fs cp \
  dbfs:/Volumes/customer_shared/config/bootstrap/customer-context.json \
  /tmp/customer-context.json

databricks bundle init https://github.com/my-org/my-template \
  --config-file /tmp/customer-context.json \
  --output-dir ./my-solution

rm /tmp/customer-context.json

Alternative

If direct Unity Catalog file support is outside the intended scope of bundle init, supporting stdin would remove the temporary-file lifecycle:

databricks fs cat dbfs:/Volumes/.../customer-context.json \
  | databricks bundle init <template> --config-file -

Environment

Databricks CLI v1.11.0

Dominant language
Go
Stars
396
Forks
233
Avg merge
2d 52m
Merged PRs (30d)
276

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from databricks/cli

All issues in databricks/cli

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.