databricks · andrewnester · Apr 9, 2026 · Mar 6, 2026 · Mar 6, 2026 · Mar 6, 2026
diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md
@@ -8,6 +8,7 @@
 * Auth commands now accept a profile name as a positional argument ([#4840](https://github.com/databricks/cli/pull/4840))
 
 ### Bundles
+* Added support for lifecycle.started option for apps ([#4672](https://github.com/databricks/cli/pull/4672))
 
 ### Dependency updates
 

diff --git a/acceptance/apps/deploy/bundle-no-args/output.txt b/acceptance/apps/deploy/bundle-no-args/output.txt
@@ -7,7 +7,10 @@ Updating deployment state...
 Deployment complete!
 ✓ Getting the status of the app myapp
 ✓ App is in RUNNING state
-✓ App compute is in ACTIVE state
+✓ App compute is in STOPPED state
+✓ Starting the app myapp
+✓ App is starting...
+✓ App is started!
 ✓ Deployment succeeded
 You can access the app at myapp-123.cloud.databricksapps.com
 ✔ Deployment complete!

diff --git a/acceptance/bundle/apps/compute_size/out.update.direct.txt b/acceptance/bundle/apps/compute_size/out.update.direct.txt
@@ -7,5 +7,5 @@ Deployment complete!
 
 >>> [CLI] apps get app-[UNIQUE_NAME]
 {
- "compute_size": "MEDIUM"
+ "compute_size": "LARGE"
 }
diff --git a/acceptance/bundle/apps/git_source/output.txt b/acceptance/bundle/apps/git_source/output.txt
@@ -22,6 +22,16 @@ Deploying resources...
 Updating deployment state...
 Deployment complete!
 
+>>> [CLI] bundle run my_app
+✓ Getting the status of the app [APP_NAME]
+✓ App is in RUNNING state
+✓ App compute is in STOPPED state
+✓ Starting the app [APP_NAME]
+✓ App is starting...
+✓ App is started!
+✓ Deployment succeeded
+You can access the app at [APP_NAME]-123.cloud.databricksapps.com
+
 === Get app details and verify git_source configuration
 >>> [CLI] bundle summary --output json
 

diff --git a/acceptance/bundle/apps/git_source/script b/acceptance/bundle/apps/git_source/script
@@ -17,6 +17,7 @@ trace $CLI bundle plan
 
 title "Deploy bundle"
 trace $CLI bundle deploy
+trace $CLI bundle run my_app
 
 title "Get app details and verify git_source configuration"
 app_name=$(trace $CLI bundle summary --output json | jq -r '.resources.apps.my_app.name')

diff --git a/acceptance/bundle/apps/git_source/test.toml b/acceptance/bundle/apps/git_source/test.toml
@@ -9,42 +9,3 @@ Ignore = [".databricks", "databricks.yml", "databricks.yml.bak", "tmp.app-run"]
 
 # Apps can take longer to deploy
 TimeoutCloud = "5m"
-
-# Mock responses for app deployment
-[[Server]]
-Pattern = "POST /api/2.0/apps/{app_name}/deployments"
-Response.Body = '''
-{
- "deployment_id": "test-deployment-123",
- "status": {
- "state": "SUCCEEDED",
- "message": "Deployment succeeded"
- },
- "git_source": {
- "branch": "main",
- "source_code_path": "internal/testdata/simple-app",
- "resolved_commit": "abc123def456"
- },
- "source_code_path": "/Workspace/Users/tester@databricks.com/.bundle/files/app",
- "mode": "SNAPSHOT"
-}
-'''
-
-[[Server]]
-Pattern = "GET /api/2.0/apps/{app_name}/deployments/{deployment_id}"
-Response.Body = '''
-{
- "deployment_id": "test-deployment-123",
- "status": {
- "state": "SUCCEEDED",
- "message": "Deployment succeeded"
- },
- "git_source": {
- "branch": "main",
- "source_code_path": "internal/testdata/simple-app",
- "resolved_commit": "abc123def456"
- },
- "source_code_path": "/Workspace/Users/tester@databricks.com/.bundle/files/app",
- "mode": "SNAPSHOT"
-}
-'''
diff --git a/acceptance/bundle/invariant/configs/app_lifecycle_ref.yml.tmpl b/acceptance/bundle/invariant/configs/app_lifecycle_ref.yml.tmpl
@@ -0,0 +1,15 @@
+bundle:
+ name: test-bundle-$UNIQUE_NAME
+
+resources:
+ apps:
+ foo:
+ name: app-foo-$UNIQUE_NAME
+ source_code_path: ./app
+ lifecycle:
+ started: true
+ bar:
+ name: app-bar-$UNIQUE_NAME
+ source_code_path: ./app
+ lifecycle:
+ started: ${resources.apps.foo.lifecycle.started}
diff --git a/acceptance/bundle/lifecycle/started-validation/app/app.py b/acceptance/bundle/lifecycle/started-validation/app/app.py
@@ -0,0 +1 @@
+print("Hello world\!")
diff --git a/acceptance/bundle/lifecycle/started-validation/databricks.yml b/acceptance/bundle/lifecycle/started-validation/databricks.yml
@@ -0,0 +1,16 @@
+bundle:
+ name: test_lifecycle_started_validation
+
+resources:
+ jobs:
+ my_job:
+ name: my_job
+ lifecycle:
+ started: true
+
+ apps:
+ my_app:
+ name: my_app
+ source_code_path: ./app
+ lifecycle:
+ started: true
diff --git a/acceptance/bundle/lifecycle/started-validation/out.direct.txt b/acceptance/bundle/lifecycle/started-validation/out.direct.txt
@@ -0,0 +1,10 @@
+
+>>> errcode [CLI] bundle plan
+Warning: unknown field: started
+ at resources.jobs.my_job.lifecycle
+ in databricks.yml:9:9
+
+create apps.my_app
+create jobs.my_job
+
+Plan: 2 to add, 0 to change, 0 to delete, 0 unchanged
diff --git a/acceptance/bundle/lifecycle/started-validation/out.terraform.txt b/acceptance/bundle/lifecycle/started-validation/out.terraform.txt
@@ -0,0 +1,11 @@
+
+>>> errcode [CLI] bundle plan
+Warning: unknown field: started
+ at resources.jobs.my_job.lifecycle
+ in databricks.yml:9:9
+
+Error: lifecycle.started is only supported in direct deployment mode
+ in databricks.yml:16:18
+
+
+Exit code: 1
diff --git a/acceptance/bundle/lifecycle/started-validation/out.test.toml b/acceptance/bundle/lifecycle/started-validation/out.test.toml
diff --git a/acceptance/bundle/lifecycle/started-validation/output.txt b/acceptance/bundle/lifecycle/started-validation/output.txt
diff --git a/acceptance/bundle/lifecycle/started-validation/script b/acceptance/bundle/lifecycle/started-validation/script
@@ -0,0 +1 @@
+trace errcode $CLI bundle plan >> out.$DATABRICKS_BUNDLE_ENGINE.txt 2>&1
diff --git a/acceptance/bundle/lifecycle/started-validation/test.toml b/acceptance/bundle/lifecycle/started-validation/test.toml
@@ -0,0 +1,4 @@
+Ignore = [".databricks"]
+
+[EnvMatrix]
+ DATABRICKS_BUNDLE_ENGINE = ["direct", "terraform"]
diff --git a/acceptance/bundle/lifecycle/started/databricks.yml b/acceptance/bundle/lifecycle/started/databricks.yml
@@ -0,0 +1,9 @@
+bundle:
+ name: test_lifecycle_started
+
+resources:
+ jobs:
+ my_job:
+ name: my_job
+ lifecycle:
+ started: true
diff --git a/acceptance/bundle/lifecycle/started/out.test.toml b/acceptance/bundle/lifecycle/started/out.test.toml
diff --git a/acceptance/bundle/lifecycle/started/output.txt b/acceptance/bundle/lifecycle/started/output.txt
@@ -0,0 +1,7 @@
+Warning: unknown field: started
+ at resources.jobs.my_job.lifecycle
+ in databricks.yml:9:9
+
+create jobs.my_job
+
+Plan: 1 to add, 0 to change, 0 to delete, 0 unchanged
diff --git a/acceptance/bundle/lifecycle/started/script b/acceptance/bundle/lifecycle/started/script
@@ -0,0 +1 @@
+errcode $CLI bundle plan
diff --git a/acceptance/bundle/lifecycle/started/test.toml b/acceptance/bundle/lifecycle/started/test.toml
@@ -0,0 +1,7 @@
+Local = true
+Cloud = false
+
+Ignore = [".databricks"]
+
+[EnvMatrix]
+ DATABRICKS_BUNDLE_ENGINE = ["direct"]
diff --git a/acceptance/bundle/refschema/out.fields.txt b/acceptance/bundle/refschema/out.fields.txt
@@ -93,14 +93,14 @@ resources.apps.*.compute_status	*apps.ComputeStatus	ALL
 resources.apps.*.compute_status.active_instances	int	ALL
 resources.apps.*.compute_status.message	string	ALL
 resources.apps.*.compute_status.state	apps.ComputeState	ALL
-resources.apps.*.config	*resources.AppConfig	INPUT
-resources.apps.*.config.command	[]string	INPUT
-resources.apps.*.config.command[*]	string	INPUT
-resources.apps.*.config.env	[]resources.AppEnvVar	INPUT
-resources.apps.*.config.env[*]	resources.AppEnvVar	INPUT
-resources.apps.*.config.env[*].name	string	INPUT
-resources.apps.*.config.env[*].value	string	INPUT
-resources.apps.*.config.env[*].value_from	string	INPUT
+resources.apps.*.config	*resources.AppConfig	ALL
+resources.apps.*.config.command	[]string	ALL
+resources.apps.*.config.command[*]	string	ALL
+resources.apps.*.config.env	[]resources.AppEnvVar	ALL
+resources.apps.*.config.env[*]	resources.AppEnvVar	ALL
+resources.apps.*.config.env[*].name	string	ALL
+resources.apps.*.config.env[*].value	string	ALL
+resources.apps.*.config.env[*].value_from	string	ALL
 resources.apps.*.create_time	string	ALL
 resources.apps.*.creator	string	ALL
 resources.apps.*.default_source_code_path	string	ALL
@@ -112,18 +112,21 @@ resources.apps.*.effective_user_api_scopes[*]	string	ALL
 resources.apps.*.git_repository	*apps.GitRepository	ALL
 resources.apps.*.git_repository.provider	string	ALL
 resources.apps.*.git_repository.url	string	ALL
-resources.apps.*.git_source	*apps.GitSource	INPUT
-resources.apps.*.git_source.branch	string	INPUT
-resources.apps.*.git_source.commit	string	INPUT
-resources.apps.*.git_source.git_repository	*apps.GitRepository	INPUT
-resources.apps.*.git_source.git_repository.provider	string	INPUT
-resources.apps.*.git_source.git_repository.url	string	INPUT
-resources.apps.*.git_source.resolved_commit	string	INPUT
-resources.apps.*.git_source.source_code_path	string	INPUT
-resources.apps.*.git_source.tag	string	INPUT
+resources.apps.*.git_source	*apps.GitSource	ALL
+resources.apps.*.git_source.branch	string	ALL
+resources.apps.*.git_source.commit	string	ALL
+resources.apps.*.git_source.git_repository	*apps.GitRepository	ALL
+resources.apps.*.git_source.git_repository.provider	string	ALL
+resources.apps.*.git_source.git_repository.url	string	ALL
+resources.apps.*.git_source.resolved_commit	string	ALL
+resources.apps.*.git_source.source_code_path	string	ALL
+resources.apps.*.git_source.tag	string	ALL
 resources.apps.*.id	string	ALL
+resources.apps.*.lifecycle	*dresources.AppStateLifecycle	REMOTE	STATE
+resources.apps.*.lifecycle	*resources.LifecycleWithStarted	INPUT
 resources.apps.*.lifecycle	resources.Lifecycle	INPUT
 resources.apps.*.lifecycle.prevent_destroy	bool	INPUT
+resources.apps.*.lifecycle.started	*bool	ALL
 resources.apps.*.modified_status	string	INPUT
 resources.apps.*.name	string	ALL
 resources.apps.*.oauth2_app_client_id	string	ALL
@@ -197,7 +200,7 @@ resources.apps.*.resources[*].uc_securable.securable_type	apps.AppResourceUcSecu
 resources.apps.*.service_principal_client_id	string	ALL
 resources.apps.*.service_principal_id	int64	ALL
 resources.apps.*.service_principal_name	string	ALL
-resources.apps.*.source_code_path	string	INPUT
+resources.apps.*.source_code_path	string	ALL
 resources.apps.*.space	string	ALL
 resources.apps.*.telemetry_export_destinations	[]apps.TelemetryExportDestination	ALL
 resources.apps.*.telemetry_export_destinations[*]	apps.TelemetryExportDestination	ALL

diff --git a/acceptance/bundle/resources/apps/config-drift/app/app.py b/acceptance/bundle/resources/apps/config-drift/app/app.py
@@ -0,0 +1 @@
+print("Hello world!")
diff --git a/acceptance/bundle/resources/apps/config-drift/databricks.yml.tmpl b/acceptance/bundle/resources/apps/config-drift/databricks.yml.tmpl
@@ -0,0 +1,18 @@
+bundle:
+ name: config-drift-$UNIQUE_NAME
+
+resources:
+ apps:
+ myapp:
+ name: $UNIQUE_NAME
+ description: my_app
+ source_code_path: ./app
+ config:
+ command:
+ - python
+ - app.py
+ env:
+ - name: MY_VAR
+ value: original_value
+ lifecycle:
+ started: true
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		trace errcode $CLI bundle plan >> out.$DATABRICKS_BUNDLE_ENGINE.txt 2>&1