databricks-cli/bundle/internal/schema/annotations.yml

493 lines
17 KiB
YAML
Raw Normal View History

github.com/databricks/cli/bundle/config.Artifact:
2024-12-10 12:44:20 +00:00
"build":
"description": |-
An optional set of non-default build commands that you want to run locally before deployment.
For Python wheel builds, the Databricks CLI assumes that it can find a local install of the Python wheel package to run builds, and it runs the command python setup.py bdist_wheel by default during each bundle deployment.
To specify multiple build commands, separate each command with double-ampersand (&&) characters.
"executable":
"description": |-
2024-12-10 15:07:25 +00:00
The executable type. Valid values are ......
2024-12-10 12:44:20 +00:00
"files":
"description": |-
2024-12-10 15:07:25 +00:00
The source files for the artifact.
"markdown_description": |-
The source files for the artifact, defined as an [_](#artifact_file).
2024-12-10 12:44:20 +00:00
"path":
"description": |-
2024-12-10 15:07:25 +00:00
The location where the built artifact will be saved.
2024-12-10 12:44:20 +00:00
"type":
"description": |-
2024-12-10 15:07:25 +00:00
The type of the artifact. Valid values are wheel or jar.
github.com/databricks/cli/bundle/config.ArtifactFile:
2024-12-10 12:44:20 +00:00
"source":
"description": |-
2024-12-10 15:07:25 +00:00
The path of the files used to build the artifact.
github.com/databricks/cli/bundle/config.Bundle:
2024-12-10 12:44:20 +00:00
"cluster_id":
"description": |-
2024-12-10 15:07:25 +00:00
The ID of a cluster to use to run the bundle.
"markdown_description": |-
The ID of a cluster to use to run the bundle. See [_](/dev-tools/bundles/settings.md#cluster_id).
2024-12-10 12:44:20 +00:00
"compute_id":
"description": |-
PLACEHOLDER
"databricks_cli_version":
"description": |-
2024-12-10 15:07:25 +00:00
The Databricks CLI version to use for the bundle.
"markdown_description": |-
The Databricks CLI version to use for the bundle. See [_](/dev-tools/bundles/settings.md#databricks_cli_version).
2024-12-10 12:44:20 +00:00
"deployment":
"description": |-
2024-12-10 15:07:25 +00:00
The definition of the bundle deployment
"markdown_description": |-
The definition of the bundle deployment. For supported attributes, see [_](#deployment) and [_](/dev-tools/bundles/deployment-modes.md).
2024-12-10 12:44:20 +00:00
"git":
"description": |-
2024-12-10 15:07:25 +00:00
The Git version control details that are associated with your bundle.
"markdown_description": |-
The Git version control details that are associated with your bundle. For supported attributes, see [_](#git) and [_](/dev-tools/bundles/settings.md#git).
2024-12-10 12:44:20 +00:00
"name":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the bundle.
2024-12-10 12:44:20 +00:00
"uuid":
"description": |-
PLACEHOLDER
github.com/databricks/cli/bundle/config.Deployment:
2024-12-10 12:44:20 +00:00
"fail_on_active_runs":
"description": |-
2024-12-10 15:07:25 +00:00
Whether to fail on active runs. If this is set to true a deployment that is running can be interrupted.
2024-12-10 12:44:20 +00:00
"lock":
"description": |-
2024-12-10 15:07:25 +00:00
The deployment lock attributes.
"markdown_description": |-
The deployment lock attributes. See [_](#lock).
github.com/databricks/cli/bundle/config.Experimental:
2024-12-10 12:44:20 +00:00
"pydabs":
"description": |-
2024-12-10 15:07:25 +00:00
The PyDABs configuration.
2024-12-10 12:44:20 +00:00
"python_wheel_wrapper":
"description": |-
2024-12-10 15:07:25 +00:00
Whether to use a Python wheel wrapper
2024-12-10 12:44:20 +00:00
"scripts":
"description": |-
2024-12-10 15:07:25 +00:00
The commands to run
2024-12-10 12:44:20 +00:00
"use_legacy_run_as":
"description": |-
2024-12-10 15:07:25 +00:00
Whether to use the legacy run_as behavior
github.com/databricks/cli/bundle/config.Git:
2024-12-10 12:44:20 +00:00
"branch":
"description": |-
2024-12-10 15:07:25 +00:00
The Git branch name.
"markdown_description": |-
The Git branch name. See [_](/dev-tools/bundles/settings.md#git).
2024-12-10 12:44:20 +00:00
"origin_url":
"description": |-
2024-12-10 15:07:25 +00:00
The origin URL of the repository.
"markdown_description": |-
The origin URL of the repository. See [_](/dev-tools/bundles/settings.md#git).
github.com/databricks/cli/bundle/config.Lock:
2024-12-10 12:44:20 +00:00
"enabled":
"description": |-
2024-12-10 15:07:25 +00:00
Whether this lock is enabled.
2024-12-10 12:44:20 +00:00
"force":
"description": |-
2024-12-10 15:07:25 +00:00
Whether to force this lock if it is enabled.
github.com/databricks/cli/bundle/config.Presets:
2024-12-10 12:44:20 +00:00
"jobs_max_concurrent_runs":
"description": |-
2024-12-10 15:07:25 +00:00
The maximum concurrent runs for a job.
2024-12-10 12:44:20 +00:00
"name_prefix":
"description": |-
2024-12-10 15:07:25 +00:00
The prefix for job runs of the bundle.
2024-12-10 12:44:20 +00:00
"pipelines_development":
"description": |-
2024-12-10 15:07:25 +00:00
Whether pipeline deployments should be locked in development mode.
2024-12-10 12:44:20 +00:00
"source_linked_deployment":
"description": |-
2024-12-10 15:07:25 +00:00
Whether to link the deployment to the bundle source.
2024-12-10 12:44:20 +00:00
"tags":
"description": |-
2024-12-10 15:07:25 +00:00
The tags for the bundle deployment.
2024-12-10 12:44:20 +00:00
"trigger_pause_status":
"description": |-
2024-12-10 15:07:25 +00:00
A pause status to apply to all job triggers and schedules. Valid values are PAUSED or UNPAUSED.
github.com/databricks/cli/bundle/config.PyDABs:
2024-12-10 12:44:20 +00:00
"enabled":
"description": |-
2024-12-10 15:07:25 +00:00
Whether or not PyDABs (Private Preview) is enabled
2024-12-10 12:44:20 +00:00
"import":
"description": |-
2024-12-10 15:07:25 +00:00
The PyDABs project to import to discover resources, resource generator and mutators
2024-12-10 12:44:20 +00:00
"venv_path":
"description": |-
2024-12-10 15:07:25 +00:00
The Python virtual environment path
github.com/databricks/cli/bundle/config.Resources:
2024-12-10 12:44:20 +00:00
"clusters":
"description": |-
2024-12-10 15:07:25 +00:00
The cluster definitions for the bundle.
"markdown_description": |-
The cluster definitions for the bundle. See [_](/dev-tools/bundles/resources.md#cluster)
2024-12-10 12:44:20 +00:00
"dashboards":
"description": |-
2024-12-10 15:07:25 +00:00
The dashboard definitions for the bundle.
"markdown_description": |-
The dashboard definitions for the bundle. See [_](/dev-tools/bundles/resources.md#dashboard)
2024-12-10 12:44:20 +00:00
"experiments":
"description": |-
2024-12-10 15:07:25 +00:00
The experiment definitions for the bundle.
"markdown_description": |-
The experiment definitions for the bundle. See [_](/dev-tools/bundles/resources.md#experiment)
2024-12-10 12:44:20 +00:00
"jobs":
"description": |-
2024-12-10 15:07:25 +00:00
The job definitions for the bundle.
"markdown_description": |-
The job definitions for the bundle. See [_](/dev-tools/bundles/resources.md#job)
2024-12-10 12:44:20 +00:00
"model_serving_endpoints":
"description": |-
2024-12-10 15:07:25 +00:00
The model serving endpoint definitions for the bundle.
"markdown_description": |-
The model serving endpoint definitions for the bundle. See [_](/dev-tools/bundles/resources.md#model_serving_endpoint)
2024-12-10 12:44:20 +00:00
"models":
"description": |-
2024-12-10 15:07:25 +00:00
The model definitions for the bundle.
"markdown_description": |-
The model definitions for the bundle. See [_](/dev-tools/bundles/resources.md#model)
2024-12-10 12:44:20 +00:00
"pipelines":
"description": |-
2024-12-10 15:07:25 +00:00
The pipeline definitions for the bundle.
"markdown_description": |-
The pipeline definitions for the bundle. See [_](/dev-tools/bundles/resources.md#pipeline)
2024-12-10 12:44:20 +00:00
"quality_monitors":
"description": |-
2024-12-10 15:07:25 +00:00
The quality monitor definitions for the bundle.
"markdown_description": |-
The quality monitor definitions for the bundle. See [_](/dev-tools/bundles/resources.md#quality_monitor)
2024-12-10 12:44:20 +00:00
"registered_models":
"description": |-
2024-12-10 15:07:25 +00:00
The registered model definitions for the bundle.
"markdown_description": |-
The registered model definitions for the bundle. See [_](/dev-tools/bundles/resources.md#registered_model)
2024-12-10 12:44:20 +00:00
"schemas":
"description": |-
2024-12-10 15:07:25 +00:00
The schema definitions for the bundle.
"markdown_description": |-
The schema definitions for the bundle. See [_](/dev-tools/bundles/resources.md#schema)
2024-12-10 12:44:20 +00:00
"volumes":
"description": |-
PLACEHOLDER
github.com/databricks/cli/bundle/config.Root:
2024-12-10 12:44:20 +00:00
"artifacts":
"description": |-
Defines the attributes to build an artifact
"bundle":
"description": |-
2024-12-10 15:07:25 +00:00
The attributes of the bundle.
"markdown_description": |-
The attributes of the bundle. See [_](/dev-tools/bundles/settings.md#bundle)
2024-12-10 12:44:20 +00:00
"experimental":
"description": |-
2024-12-10 15:07:25 +00:00
Defines attributes for experimental features.
2024-12-10 12:44:20 +00:00
"include":
"description": |-
PLACEHOLDER
"permissions":
"description": |-
2024-12-10 15:07:25 +00:00
Defines the permissions to apply to experiments, jobs, pipelines, and models defined in the bundle
"markdown_description": |-
Defines the permissions to apply to experiments, jobs, pipelines, and models defined in the bundle. See [_](/dev-tools/bundles/settings.md#permissions) and [_](/dev-tools/bundles/permissions.md).
2024-12-10 12:44:20 +00:00
"presets":
"description": |-
2024-12-10 15:07:25 +00:00
Defines bundle deployment presets.
"markdown_description": |-
Defines bundle deployment presets. See [_](/dev-tools/bundles/deployment-modes.md#presets).
2024-12-10 12:44:20 +00:00
"resources":
"description": |-
PLACEHOLDER
2024-12-10 15:07:25 +00:00
"markdown_description": |-
See [_](/dev-tools/bundles/resources.md).
2024-12-10 12:44:20 +00:00
"run_as":
"description": |-
PLACEHOLDER
"sync":
"description": |-
2024-12-10 15:07:25 +00:00
The files and file paths to include or exclude in the bundle.
"markdown_description": |-
The files and file paths to include or exclude in the bundle. See [_](/dev-tools/bundles/)
2024-12-10 12:44:20 +00:00
"targets":
"description": |-
2024-12-10 15:07:25 +00:00
Defines deployment targets for the bundle.
2024-12-10 12:44:20 +00:00
"variables":
"description": |-
2024-12-10 15:07:25 +00:00
A Map that defines the custom variables for the bundle, where each key is the name of the variable, and the value is a Map that defines the variable.
2024-12-10 12:44:20 +00:00
"workspace":
"description": |-
2024-12-10 15:07:25 +00:00
Defines the Databricks workspace for the bundle.
github.com/databricks/cli/bundle/config.Sync:
2024-12-10 12:44:20 +00:00
"exclude":
"description": |-
2024-12-10 15:07:25 +00:00
A list of files or folders to exclude from the bundle.
2024-12-10 12:44:20 +00:00
"include":
"description": |-
2024-12-10 15:07:25 +00:00
A list of files or folders to include in the bundle.
2024-12-10 12:44:20 +00:00
"paths":
"description": |-
2024-12-10 15:07:25 +00:00
The local folder paths, which can be outside the bundle root, to synchronize to the workspace when the bundle is deployed.
github.com/databricks/cli/bundle/config.Target:
2024-12-10 12:44:20 +00:00
"artifacts":
"description": |-
2024-12-10 15:07:25 +00:00
The artifacts to include in the target deployment.
"markdown_description": |-
The artifacts to include in the target deployment. See [_](#artifact)
2024-12-10 12:44:20 +00:00
"bundle":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the bundle when deploying to this target.
2024-12-10 12:44:20 +00:00
"cluster_id":
"description": |-
2024-12-10 15:07:25 +00:00
The ID of the cluster to use for this target.
2024-12-10 12:44:20 +00:00
"compute_id":
"description": |-
2024-12-10 15:07:25 +00:00
Deprecated. The ID of the compute to use for this target.
2024-12-10 12:44:20 +00:00
"default":
"description": |-
2024-12-10 15:07:25 +00:00
Whether this target is the default target.
2024-12-10 12:44:20 +00:00
"git":
"description": |-
2024-12-10 15:07:25 +00:00
The Git version control settings for the target.
"markdown_description": |-
The Git version control settings for the target. See [_](#git).
2024-12-10 12:44:20 +00:00
"mode":
"description": |-
2024-12-10 15:07:25 +00:00
The deployment mode for the target. Valid values are development or production.
"markdown_description": |-
The deployment mode for the target. Valid values are development or production. See [_](/dev-tools/bundles/deployment-modes.md).
2024-12-10 12:44:20 +00:00
"permissions":
"description": |-
2024-12-10 15:07:25 +00:00
The permissions for deploying and running the bundle in the target.
"markdown_description": |-
The permissions for deploying and running the bundle in the target. See [_](#permission).
2024-12-10 12:44:20 +00:00
"presets":
"description": |-
2024-12-10 15:07:25 +00:00
The deployment presets for the target.
"markdown_description": |-
The deployment presets for the target. See [_](#preset).
2024-12-10 12:44:20 +00:00
"resources":
"description": |-
2024-12-10 15:07:25 +00:00
The resource definitions for the target.
"markdown_description": |-
The resource definitions for the target. See [_](#resources).
2024-12-10 12:44:20 +00:00
"run_as":
"description": |-
2024-12-10 15:07:25 +00:00
The identity to use to run the bundle.
"markdown_description": |-
The identity to use to run the bundle. See [_](#job_run_as) and [_](/dev-tools/bundles/run_as.md).
2024-12-10 12:44:20 +00:00
"sync":
"description": |-
2024-12-10 15:07:25 +00:00
The local paths to sync to the target workspace when a bundle is run or deployed.
"markdown_description": |-
The local paths to sync to the target workspace when a bundle is run or deployed. See [_](#sync).
2024-12-10 12:44:20 +00:00
"variables":
"description": |-
2024-12-10 15:07:25 +00:00
The custom variable definitions for the target.
"markdown_description": |-
The custom variable definitions for the target. See [_](/dev-tools/bundles/settings.md#variables) and [_](/dev-tools/bundles/variables.md).
2024-12-10 12:44:20 +00:00
"workspace":
"description": |-
2024-12-10 15:07:25 +00:00
The Databricks workspace for the target. _.
"markdown_description": |-
The Databricks workspace for the target. [_](#workspace)
github.com/databricks/cli/bundle/config.Workspace:
2024-12-10 12:44:20 +00:00
"artifact_path":
"description": |-
2024-12-10 15:07:25 +00:00
The artifact path to use within the workspace for both deployments and workflow runs
2024-12-10 12:44:20 +00:00
"auth_type":
"description": |-
2024-12-10 15:07:25 +00:00
The authentication type.
2024-12-10 12:44:20 +00:00
"azure_client_id":
"description": |-
2024-12-10 15:07:25 +00:00
The Azure client ID
2024-12-10 12:44:20 +00:00
"azure_environment":
"description": |-
2024-12-10 15:07:25 +00:00
The Azure environment
2024-12-10 12:44:20 +00:00
"azure_login_app_id":
"description": |-
2024-12-10 15:07:25 +00:00
The Azure login app ID
2024-12-10 12:44:20 +00:00
"azure_tenant_id":
"description": |-
2024-12-10 15:07:25 +00:00
The Azure tenant ID
2024-12-10 12:44:20 +00:00
"azure_use_msi":
"description": |-
2024-12-10 15:07:25 +00:00
Whether to use MSI for Azure
2024-12-10 12:44:20 +00:00
"azure_workspace_resource_id":
"description": |-
2024-12-10 15:07:25 +00:00
The Azure workspace resource ID
2024-12-10 12:44:20 +00:00
"client_id":
"description": |-
2024-12-10 15:07:25 +00:00
The client ID for the workspace
2024-12-10 12:44:20 +00:00
"file_path":
"description": |-
2024-12-10 15:07:25 +00:00
The file path to use within the workspace for both deployments and workflow runs
2024-12-10 12:44:20 +00:00
"google_service_account":
"description": |-
2024-12-10 15:07:25 +00:00
The Google service account name
2024-12-10 12:44:20 +00:00
"host":
"description": |-
2024-12-10 15:07:25 +00:00
The Databricks workspace host URL
2024-12-10 12:44:20 +00:00
"profile":
"description": |-
2024-12-10 15:07:25 +00:00
The Databricks workspace profile name
2024-12-10 12:44:20 +00:00
"resource_path":
"description": |-
2024-12-10 15:07:25 +00:00
The workspace resource path
2024-12-10 12:44:20 +00:00
"root_path":
"description": |-
2024-12-10 15:07:25 +00:00
The Databricks workspace root path
2024-12-10 12:44:20 +00:00
"state_path":
"description": |-
2024-12-10 15:07:25 +00:00
The workspace state path
github.com/databricks/cli/bundle/config/resources.Grant:
2024-12-10 12:44:20 +00:00
"principal":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the principal that will be granted privileges
2024-12-10 12:44:20 +00:00
"privileges":
"description": |-
2024-12-10 15:07:25 +00:00
The privileges to grant to the specified entity
github.com/databricks/cli/bundle/config/resources.Permission:
2024-12-10 12:44:20 +00:00
"group_name":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the group that has the permission set in level.
2024-12-10 12:44:20 +00:00
"level":
"description": |-
2024-12-10 15:07:25 +00:00
The allowed permission for user, group, service principal defined for this permission.
2024-12-10 12:44:20 +00:00
"service_principal_name":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the service principal that has the permission set in level.
2024-12-10 12:44:20 +00:00
"user_name":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the user that has the permission set in level.
github.com/databricks/cli/bundle/config/variable.Lookup:
2024-12-10 12:44:20 +00:00
"alert":
"description": |-
PLACEHOLDER
"cluster":
"description": |-
PLACEHOLDER
"cluster_policy":
"description": |-
PLACEHOLDER
"dashboard":
"description": |-
PLACEHOLDER
"instance_pool":
"description": |-
PLACEHOLDER
"job":
"description": |-
PLACEHOLDER
"metastore":
"description": |-
PLACEHOLDER
"notification_destination":
"description": |-
PLACEHOLDER
"pipeline":
"description": |-
PLACEHOLDER
"query":
"description": |-
PLACEHOLDER
"service_principal":
"description": |-
PLACEHOLDER
"warehouse":
"description": |-
PLACEHOLDER
github.com/databricks/cli/bundle/config/variable.TargetVariable:
2024-12-10 12:44:20 +00:00
"default":
"description": |-
PLACEHOLDER
"description":
"description": |-
2024-12-10 15:07:25 +00:00
The description of the variable
2024-12-10 12:44:20 +00:00
"lookup":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the alert, cluster_policy, cluster, dashboard, instance_pool, job, metastore, pipeline, query, service_principal, or warehouse object for which to retrieve an ID.
2024-12-10 12:44:20 +00:00
"type":
"description": |-
2024-12-10 15:07:25 +00:00
The type of the variable. Valid values are complex.
github.com/databricks/cli/bundle/config/variable.Variable:
2024-12-10 12:44:20 +00:00
"default":
"description": |-
PLACEHOLDER
"description":
"description": |-
2024-12-10 15:07:25 +00:00
The description of the variable
2024-12-10 12:44:20 +00:00
"lookup":
"description": |-
2024-12-10 15:07:25 +00:00
The name of the alert, cluster_policy, cluster, dashboard, instance_pool, job, metastore, pipeline, query, service_principal, or warehouse object for which to retrieve an ID.
2024-12-10 12:44:20 +00:00
"type":
"description": |-
2024-12-10 15:07:25 +00:00
The type of the variable. Valid values are complex.
github.com/databricks/databricks-sdk-go/service/serving.Ai21LabsConfig:
2024-12-10 12:44:20 +00:00
"ai21labs_api_key":
"description": |-
PLACEHOLDER
"ai21labs_api_key_plaintext":
"description": |-
PLACEHOLDER
github.com/databricks/databricks-sdk-go/service/serving.GoogleCloudVertexAiConfig:
2024-12-10 12:44:20 +00:00
"private_key":
"description": |-
PLACEHOLDER
"private_key_plaintext":
"description": |-
PLACEHOLDER
"project_id":
"description": |-
PLACEHOLDER
"region":
"description": |-
PLACEHOLDER
github.com/databricks/databricks-sdk-go/service/serving.OpenAiConfig:
2024-12-10 12:44:20 +00:00
"microsoft_entra_client_id":
"description": |-
PLACEHOLDER
"microsoft_entra_client_secret":
"description": |-
PLACEHOLDER
"microsoft_entra_client_secret_plaintext":
"description": |-
PLACEHOLDER
"microsoft_entra_tenant_id":
"description": |-
PLACEHOLDER
"openai_api_base":
"description": |-
PLACEHOLDER
"openai_api_key":
"description": |-
PLACEHOLDER
"openai_api_key_plaintext":
"description": |-
PLACEHOLDER
"openai_api_type":
"description": |-
PLACEHOLDER
"openai_api_version":
"description": |-
PLACEHOLDER
"openai_deployment_name":
"description": |-
PLACEHOLDER
"openai_organization":
"description": |-
PLACEHOLDER
github.com/databricks/databricks-sdk-go/service/serving.PaLmConfig:
2024-12-10 12:44:20 +00:00
"palm_api_key":
"description": |-
PLACEHOLDER
"palm_api_key_plaintext":
"description": |-
PLACEHOLDER