Added support for lifecycle.started option for apps

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
 

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!

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"
 }

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
 

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')

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"
-}
-'''

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}

acceptance/bundle/lifecycle/started-validation/app/app.py

@@ -0,0 +1 @@
+print("Hello world\!")

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

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

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

acceptance/bundle/lifecycle/started-validation/script

@@ -0,0 +1 @@
+trace errcode $CLI bundle plan >> out.$DATABRICKS_BUNDLE_ENGINE.txt 2>&1

acceptance/bundle/lifecycle/started-validation/test.toml

@@ -0,0 +1,4 @@
+Ignore = [".databricks"]
+
+[EnvMatrix]
+  DATABRICKS_BUNDLE_ENGINE = ["direct", "terraform"]

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

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

acceptance/bundle/lifecycle/started/script

@@ -0,0 +1 @@
+errcode $CLI bundle plan

acceptance/bundle/lifecycle/started/test.toml

@@ -0,0 +1,7 @@
+Local = true
+Cloud = false
+
+Ignore = [".databricks"]
+
+[EnvMatrix]
+  DATABRICKS_BUNDLE_ENGINE = ["direct"]

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

acceptance/bundle/resources/apps/config-drift/app/app.py

@@ -0,0 +1 @@
+print("Hello world!")

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