Document +modifier syntax inbundle run --only help by afberg · Pull Request #5842 · databricks/cli

afberg · 2026-07-07T12:02:56Z

Changes

The bundle run --only command takes a comma-separated list of task keys to run a subset of a job's tasks. Its help text did not mention that a task key can be prefixed or suffixed with + to also pull in upstream/downstream tasks (the value is forwarded to the run-now only API field, which interprets the modifiers). This documents that syntax in the flag's help:

+my_task: run my_task and everything upstream of it
my_task+: run my_task and everything downstream of it
+my_task+: both

Supercedes #5760, addresses #4244

Why

Documentation was out of date so agents & users were not able to use the new functionality

Tests

Yes, new tests assert that the data is passed through unchanged

`bundle run --only` accepts task keys to run a subset of a job's tasks. A task key may be prefixed with `+` (also run upstream tasks) or suffixed with `+` (also run downstream tasks); document that in the flag's help text. Co-authored-by: Isaac

Add a partial_run case asserting `--only +task_1,task_2+` forwards unchanged to the run-now `only` field, proving the CLI does not mangle or reject the upstream/downstream modifier syntax documented on the flag. Co-authored-by: Isaac

eng-dev-ecosystem-bot · 2026-07-07T12:23:54Z

Integration test report

Commit: 2091e7f

Run: 28864668413

	Env	🟨KNOWN	🔄flaky	💚RECOVERED	🙈SKIP	✅pass	🙈skip	Time
💚	aws linux			4	4	230	1064	5:07
💚	aws windows			4	4	232	1062	5:56
💚	aws-ucws linux			4	4	314	982	6:30
💚	aws-ucws windows			4	4	316	980	6:26
💚	azure linux			4	4	230	1063	5:09
💚	azure windows			4	4	232	1061	6:07
🔄	azure-ucws linux		2	2	4	316	979	8:19
🟨	azure-ucws windows	2	1	1	4	318	977	8:52
💚	gcp linux			4	4	229	1065	4:59
💚	gcp windows			4	4	231	1063	5:54

8 interesting tests: 4 SKIP, 2 KNOWN, 1 RECOVERED, 1 flaky

	Test Name	aws linux	aws windows	aws-ucws linux	aws-ucws windows	azure linux	azure windows	azure-ucws linux	azure-ucws windows	gcp linux	gcp windows
💚	TestAccept	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R
🙈	TestAccept/bundle/invariant/no_drift	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🙈	TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🙈	TestAccept/bundle/resources/vector_search_indexes/recreate/embedding_dimension	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🙈	TestAccept/ssh/connection	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🟨	TestFetchRepositoryInfoAPI_FromRepo	💚R	💚R	💚R	💚R	💚R	💚R	💚R	🟨K	💚R	💚R
🔄	TestFetchRepositoryInfoAPI_FromRepo/root	💚R	💚R	💚R	💚R	💚R	💚R	🔄f	🔄f	💚R	💚R
🟨	TestFetchRepositoryInfoAPI_FromRepo/subdir	💚R	💚R	💚R	💚R	💚R	💚R	🔄f	🟨K	💚R	💚R

Top 10 slowest tests (at least 2 minutes):

duration	env	testname
5:28	aws-ucws windows	TestAccept
5:16	azure windows	TestAccept
5:03	azure-ucws windows	TestAccept
5:03	gcp windows	TestAccept
5:00	aws windows	TestAccept
2:57	gcp linux	TestAccept
2:56	azure linux	TestAccept
2:52	azure-ucws linux	TestAccept
2:52	aws linux	TestAccept
2:48	aws-ucws linux	TestAccept

eng-dev-ecosystem-bot · 2026-07-08T18:34:15Z

Integration test report

Commit: 3454e06

Run: 28952128809

	Env	❌FAIL	🟨KNOWN	🔄flaky	💚RECOVERED	🙈SKIP	✅pass	🙈skip	Time
💚	aws linux				4	4	529	998	43:16
🔄	aws windows			4	4	4	482	1011	56:13
❌	aws-ucws linux	9	1	4	5	2	975	813	215:31
❌	aws-ucws windows	20	3		3	2	910	831	188:20
💚	azure linux				4	4	523	999	50:31
🔄	azure windows			6	4	4	474	1012	67:10
🔄	azure-ucws linux			10	6	2	884	844	216:38
🔄	azure-ucws windows			6	5	2	831	862	193:37
💚	gcp linux				4	4	514	1004	50:56
💚	gcp windows				4	4	471	1017	50:44

47 interesting tests: 20 FAIL, 19 flaky, 3 KNOWN, 3 RECOVERED, 2 SKIP

	Test Name	aws linux	aws windows	aws-ucws linux	aws-ucws windows	azure linux	azure windows	azure-ucws linux	azure-ucws windows	gcp linux	gcp windows
🟨	TestAccept	💚R	💚R	🟨K	🟨K	💚R	💚R	💚R	🔄f	💚R	💚R
🔄	TestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=direct			✅p				🔄f
🔄	TestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=terraform			✅p				🔄f
❌	TestAccept/bundle/generate/pipeline_and_deploy	✅p	🔄f	✅p	❌F	✅p	✅p	🔄f	🔄f	✅p	✅p
❌	TestAccept/bundle/generate/pipeline_and_deploy/DATABRICKS_BUNDLE_ENGINE=direct	✅p	🔄f	✅p	❌F	✅p	✅p	✅p	🔄f	✅p	✅p
🔄	TestAccept/bundle/generate/pipeline_and_deploy/DATABRICKS_BUNDLE_ENGINE=terraform	✅p	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p	✅p
🔄	TestAccept/bundle/generate/python_job_and_deploy	✅p	🔄f	✅p	✅p	✅p	🔄f	✅p	✅p	✅p	✅p
🔄	TestAccept/bundle/generate/python_job_and_deploy/DATABRICKS_BUNDLE_ENGINE=direct	✅p	🔄f	✅p	✅p	✅p	🔄f	✅p	🔄f	✅p	✅p
🔄	TestAccept/bundle/generate/python_job_and_deploy/DATABRICKS_BUNDLE_ENGINE=terraform	✅p	✅p	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p
🟨	TestAccept/bundle/invariant/no_drift	🙈S	🙈S	💚R	🟨K	🙈S	🙈S	💚R	💚R	🙈S	🙈S
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster.yml.tmpl/READPLAN=			✅p	❌F			✅p	✅p
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster.yml.tmpl/READPLAN=1			✅p	❌F			✅p	✅p
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster_apply_policy_default_values.yml.tmpl/READPLAN=			✅p	❌F			✅p	✅p
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster_apply_policy_default_values.yml.tmpl/READPLAN=1			✅p	❌F			✅p	✅p
🔄	TestAccept/bundle/resources/apps/inline_config	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/apps/lifecycle-started	✅p	✅p	✅p	✅p	✅p	🔄f	🔄f	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct	✅p	✅p	✅p	✅p	✅p	🔄f	🔄f	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/clusters/deploy/simple	✅p	✅p	🔄f	✅p	✅p	✅p	✅p	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/clusters/deploy/simple/DATABRICKS_BUNDLE_ENGINE=direct	✅p	✅p	🔄f	✅p	✅p	✅p	✅p	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/clusters/deploy/update-after-create	✅p	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform	✅p	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/pipelines/allow-duplicate-names	✅p	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/pipelines/allow-duplicate-names/DATABRICKS_BUNDLE_ENGINE=direct	✅p	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p	✅p
🔄	TestAccept/bundle/resources/postgres_branches/update_protected	🙈s	🙈s	🔄f	✅p	🙈s	🙈s	🙈s	🙈s	🙈s	🙈s
🔄	TestAccept/bundle/resources/postgres_branches/update_protected/DATABRICKS_BUNDLE_ENGINE=direct			🔄f	✅p
❌	TestAccept/bundle/resources/postgres_endpoints/basic	🙈s	🙈s	❌F	❌F	🙈s	🙈s	🙈s	🙈s	🙈s	🙈s
❌	TestAccept/bundle/resources/postgres_endpoints/basic/DATABRICKS_BUNDLE_ENGINE=direct			❌F	❌F
❌	TestAccept/bundle/resources/postgres_endpoints/basic/DATABRICKS_BUNDLE_ENGINE=terraform			❌F	❌F
❌	TestAccept/bundle/resources/postgres_endpoints/replace_existing	🙈s	🙈s	❌F	❌F	🙈s	🙈s	🙈s	🙈s	🙈s	🙈s
❌	TestAccept/bundle/resources/postgres_endpoints/replace_existing/DATABRICKS_BUNDLE_ENGINE=direct			❌F	❌F
❌	TestAccept/bundle/resources/postgres_endpoints/replace_existing/DATABRICKS_BUNDLE_ENGINE=terraform			❌F	❌F
❌	TestAccept/bundle/resources/postgres_endpoints/update_autoscaling	🙈s	🙈s	❌F	❌F	🙈s	🙈s	🙈s	🙈s	🙈s	🙈s
❌	TestAccept/bundle/resources/postgres_endpoints/update_autoscaling/DATABRICKS_BUNDLE_ENGINE=direct			❌F	❌F
❌	TestAccept/bundle/resources/postgres_endpoints/update_autoscaling/DATABRICKS_BUNDLE_ENGINE=terraform			❌F	❌F
❌	TestAccept/bundle/resources/synced_database_tables/basic	🙈s	🙈s	✅p	❌F	🙈s	🙈s	✅p	✅p	🙈s	🙈s
❌	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform			✅p	❌F			✅p	✅p
🟨	TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name	🙈S	🙈S	💚R	🟨K	🙈S	🙈S	💚R	💚R	🙈S	🙈S
❌	TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name/DATABRICKS_BUNDLE_ENGINE=direct			✅p	❌F			✅p	✅p
🙈	TestAccept/bundle/resources/vector_search_indexes/recreate/embedding_dimension	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
❌	TestAccept/bundle/select/basic	✅p	✅p	✅p	❌F	✅p	✅p	✅p	✅p	✅p	✅p
❌	TestAccept/bundle/select/basic/DATABRICKS_BUNDLE_ENGINE=direct/READPLAN=	✅p	✅p	✅p	❌F	✅p	✅p	✅p	✅p	✅p	✅p
🙈	TestAccept/ssh/connection	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🔄	TestSyncIncrementalSyncPythonNotebookDelete	✅p	✅p	✅p	✅p	✅p	✅p	✅p	🔄f	✅p	✅p
💚	TestFetchRepositoryInfoAPI_FromRepo	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R
💚	TestFetchRepositoryInfoAPI_FromRepo/root	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R
💚	TestFetchRepositoryInfoAPI_FromRepo/subdir	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R

Top 50 slowest tests (at least 2 minutes):

duration	env	testname
16:11	aws-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
14:39	gcp linux	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
12:33	gcp windows	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
12:04	gcp linux	TestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
11:32	gcp linux	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
11:02	azure linux	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
10:54	aws windows	TestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
10:34	azure-ucws linux	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
10:33	aws windows	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
10:29	azure-ucws windows	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
10:03	aws-ucws windows	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
9:39	azure windows	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
9:04	aws-ucws linux	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
8:50	azure-ucws linux	TestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=terraform
8:43	gcp linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
8:31	aws-ucws linux	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster_apply_policy_default_values.yml.tmpl/READPLAN=1
8:28	aws-ucws linux	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
8:26	azure linux	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
8:04	gcp linux	TestAccept/bundle/resources/clusters/resize-terminated-fallback/DATABRICKS_BUNDLE_ENGINE=direct
7:55	aws-ucws linux	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster.yml.tmpl/READPLAN=1
7:55	aws windows	TestAccept/bundle/resources/clusters/resize-terminated-fallback/DATABRICKS_BUNDLE_ENGINE=direct
7:46	azure windows	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:41	aws-ucws linux	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster.yml.tmpl/READPLAN=
7:38	aws-ucws linux	TestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
7:36	aws-ucws windows	TestAccept/bundle/deploy/spark-jar-task/DATABRICKS_BUNDLE_ENGINE=terraform
7:30	aws linux	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:27	aws-ucws linux	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster_apply_policy_default_values.yml.tmpl/READPLAN=
7:22	aws linux	TestAccept/bundle/resources/clusters/resize-terminated-fallback/DATABRICKS_BUNDLE_ENGINE=direct
7:21	azure-ucws windows	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:21	aws-ucws windows	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:18	gcp windows	TestAccept/bundle/resources/clusters/deploy/local_ssd_count/DATABRICKS_BUNDLE_ENGINE=direct
7:13	aws windows	TestAccept/bundle/resources/apps/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
7:05	aws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
7:02	aws-ucws windows	TestAccept/bundle/resources/apps/lifecycle-started-omitted/DATABRICKS_BUNDLE_ENGINE=direct
6:59	aws-ucws linux	TestAccept/bundle/resources/clusters/deploy/data_security_mode/DATABRICKS_BUNDLE_ENGINE=direct
6:45	gcp linux	TestAccept/bundle/resources/clusters/deploy/local_ssd_count/DATABRICKS_BUNDLE_ENGINE=direct
6:44	gcp windows	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
6:42	azure linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
6:37	aws-ucws linux	TestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=terraform
6:31	azure linux	TestAccept/bundle/resources/clusters/deploy/simple/DATABRICKS_BUNDLE_ENGINE=direct
6:29	azure-ucws linux	TestAccept/bundle/resources/apps/lifecycle-started-omitted/DATABRICKS_BUNDLE_ENGINE=direct
6:28	azure linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
6:27	aws-ucws windows	TestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
6:25	azure-ucws windows	TestAccept/bundle/resources/clusters/lifecycle-started-toggle/DATABRICKS_BUNDLE_ENGINE=direct
6:16	aws-ucws linux	TestAccept/bundle/config-remote-sync/multiple_resources/DATABRICKS_BUNDLE_ENGINE=direct
6:15	azure-ucws linux	TestAccept/bundle/resources/clusters/lifecycle-started/DATABRICKS_BUNDLE_ENGINE=direct
6:01	azure-ucws windows	TestAccept/bundle/resources/registered_models/basic/DATABRICKS_BUNDLE_ENGINE=terraform
5:58	azure-ucws windows	TestAccept/bundle/resources/apps/lifecycle-started-omitted/DATABRICKS_BUNDLE_ENGINE=direct
5:49	azure-ucws windows	TestAccept/bundle/templates/default-python/combinations/serverless/DATABRICKS_BUNDLE_ENGINE=terraform/DLT=yes/NBOOK=yes/PY=yes/READPLAN=
5:49	aws-ucws linux	TestAccept/bundle/deploy/spark-jar-task/DATABRICKS_BUNDLE_ENGINE=direct

afberg added 2 commits July 7, 2026 11:56

afberg temporarily deployed to test-trigger-is July 7, 2026 12:03 — with GitHub Actions Inactive

afberg requested a review from pietern July 7, 2026 12:03

pietern approved these changes Jul 8, 2026
View reviewed changes

pietern enabled auto-merge July 8, 2026 14:36

pietern added this pull request to the merge queue Jul 8, 2026

Merged via the queue into main with commit 3454e06Jul 8, 2026
25 checks passed

pietern deleted the jobs-run-now-only-flag branch July 8, 2026 14:51

afberg mentioned this pull request Jul 8, 2026
Add option to include upstream tasks for bundle run --only#4244
Closed

Navigation Menu

Uh oh!

Document +modifier syntax inbundle run --only help - #5842

Document +modifier syntax inbundle run --only help#5842
pietern merged 2 commits into
mainfrom
jobs-run-now-only-flag

afberg commented Jul 7, 2026•
edited by pietern
Loading

Uh oh!

eng-dev-ecosystem-bot commented Jul 7, 2026

Uh oh!

Uh oh!

eng-dev-ecosystem-bot commented Jul 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

afberg commented Jul 7, 2026• edited by pietern Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Why

Tests

Uh oh!

eng-dev-ecosystem-bot commented Jul 7, 2026

Integration test report

Uh oh!

Uh oh!

eng-dev-ecosystem-bot commented Jul 8, 2026

Integration test report

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

afberg commented Jul 7, 2026•
edited by pietern
Loading