Add support for configuring app.yaml options for apps via bundle config (#4271)

## Changes
Add support for configuring app.yaml options for apps via bundle config

This change uses new fields from Apps.Deploy call: `Command` and
`EnvVars`.

## Why
This change allows users to configure their Databricks Apps differently
for different targets

Fixes #3679

## Tests
Added an acceptance test

<!-- If your PR needs to be included in the release notes for next
release,
add a separate entry in NEXT_CHANGELOG.md as part of your PR. -->

Author: andrewnester

NEXT_CHANGELOG.md

@@ -10,6 +10,7 @@ To disable this, set the environment variable DATABRICKS_CACHE_ENABLED to false.
 * Add commands to pipelines command group ([#4275](https://github.com/databricks/cli/pull/4275))
 
 ### Bundles
+* Add support for configuring app.yaml options for apps via bundle config ([#4271](https://github.com/databricks/cli/pull/4271))
 * Enable caching user identity by default ([#4202](https://github.com/databricks/cli/pull/4202))
 * Do not show single node warning when is_single_node option is explicitly set ([#4272](https://github.com/databricks/cli/pull/4272))
 * Fix false positive folder permission warnings and make them more actionable ([#4216](https://github.com/databricks/cli/pull/4216))

acceptance/bundle/refschema/out.fields.txt

@@ -99,6 +99,13 @@ resources.apps.*.compute_size	apps.ComputeSize	ALL
 resources.apps.*.compute_status	*apps.ComputeStatus	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.*.create_time	string	ALL
 resources.apps.*.creator	string	ALL
 resources.apps.*.default_source_code_path	string	ALL

acceptance/bundle/resources/apps/inline_config/app/app.py

@@ -0,0 +1,10 @@
+import os
+
+from flask import Flask
+
+app = Flask(__name__)
+
+
+@app.route("/")
+def home():
+    return "Hello from inline config app!"

acceptance/bundle/resources/apps/inline_config/app/app.yaml

@@ -0,0 +1,7 @@
+command:
+  - python
+  - app.py
+
+env:
+  - name: MY_ENV_VAR
+    value: test_value_old

acceptance/bundle/resources/apps/inline_config/databricks.yml.tmpl

@@ -0,0 +1,16 @@
+bundle:
+  name: app-inline-config-$UNIQUE_NAME
+
+resources:
+  apps:
+    myapp:
+      name: $UNIQUE_NAME
+      description: my_app_description
+      source_code_path: ./app
+      config:
+        command: ["flask", "--app", "app", "run"]
+        env:
+          - name: MY_ENV_VAR
+            value: test_value
+          - name: ANOTHER_VAR
+            value: another_value

acceptance/bundle/resources/apps/inline_config/out.test.toml

@@ -0,0 +1,33 @@
+
+>>> [CLI] bundle deploy
+Uploading bundle files to /Workspace/Users/[USERNAME]/.bundle/app-inline-config-[UNIQUE_NAME]/default/files...
+Deploying resources...
+Updating deployment state...
+Deployment complete!
+
+>>> [CLI] apps get-deployment [UNIQUE_NAME] [DEPLOYMENT_ID]
+{
+  "command": [
+    "flask",
+    "--app",
+    "app",
+    "run"
+  ],
+  "env_vars": [
+    {
+      "name": "MY_ENV_VAR"
+    },
+    {
+      "name": "ANOTHER_VAR"
+    }
+  ]
+}
+
+>>> [CLI] bundle destroy --auto-approve
+The following resources will be deleted:
+  delete resources.apps.myapp
+
+All files and directories at the following location will be deleted: /Workspace/Users/[USERNAME]/.bundle/app-inline-config-[UNIQUE_NAME]/default
+
+Deleting files...
+Destroy complete!

acceptance/bundle/resources/apps/inline_config/output.txt

@@ -0,0 +1,17 @@
+envsubst < databricks.yml.tmpl > databricks.yml
+
+cleanup() {
+    trace $CLI bundle destroy --auto-approve
+    rm out.requests.txt
+}
+trap cleanup EXIT
+
+trace $CLI bundle deploy
+
+APP_NAME=$($CLI bundle summary -o json | jq -r '.resources.apps.myapp.name')
+$CLI bundle run myapp > /dev/null 2>&1
+
+DEPLOYMENT_ID=$($CLI apps get "$APP_NAME" | jq -r '.active_deployment.deployment_id')
+echo $DEPLOYMENT_ID:DEPLOYMENT_ID >> ACC_REPLS
+
+trace $CLI apps get-deployment "$APP_NAME" "$DEPLOYMENT_ID" | jq '{command, env_vars}'

acceptance/bundle/resources/apps/inline_config/script

@@ -0,0 +1,2 @@
+Local = false
+Cloud = true

acceptance/bundle/resources/apps/inline_config/test.toml

@@ -10,6 +10,25 @@ import (
 	"github.com/databricks/databricks-sdk-go/service/apps"
 )
 
+// AppConfig represents the inline app.yaml configuration structure.
+// This matches the structure of an app.yaml file that can be used to configure how the app runs.
+type AppConfig struct {
+	// Command specifies the command to run the app (e.g., ["streamlit", "run", "app.py"])
+	Command []string `json:"command,omitempty" yaml:"command,omitempty"`
+
+	// Env contains environment variables to set for the app
+	Env []AppEnvVar `json:"env,omitempty" yaml:"env,omitempty"`
+}
+
+// AppEnvVar represents an environment variable configuration for an app
+type AppEnvVar struct {
+	// Name is the environment variable name
+	Name string `json:"name" yaml:"name"`
+
+	// Value is the environment variable value
+	Value string `json:"value" yaml:"value"`
+}
+
 type App struct {
 	BaseResource
 	apps.App // nolint App struct also defines Id and URL field with the same json tag "id" and "url"
@@ -18,6 +37,11 @@ type App struct {
 	// on local disk and to the corresponding workspace path during app deployment.
 	SourceCodePath string `json:"source_code_path"`
 
+	// Config represents inline app.yaml configuration for the app.
+	// When specified, this configuration is written to an app.yaml file in the source code path during deployment.
+	// This allows users to define app configuration directly in the bundle YAML instead of maintaining a separate app.yaml file.
+	Config *AppConfig `json:"config,omitempty"`
+
 	Permissions []AppPermission `json:"permissions,omitempty"`
 }