az spring app deployment

Note

This reference is part of the spring extension for the Azure CLI (version 2.56.0 or higher). The extension will automatically install the first time you run an az spring app deployment command. Learn more about extensions.

Commands to manage life cycle of deployments of an app in Azure Spring Apps. More operations on deployments can be done on app level with parameter --deployment. e.g. az spring app deploy --deployment <staging deployment>.

Commands

Name	Description	Type	Status
az spring app deployment create	Create a staging deployment for the app. To deploy code or update setting to an existing deployment, use az spring app deploy/update --deployment <staging deployment>.	Extension	GA
az spring app deployment delete	Delete a deployment of the app.	Extension	GA
az spring app deployment generate-heap-dump	Generate a heap dump of your target app instance to given file path.	Extension	GA
az spring app deployment generate-thread-dump	Generate a thread dump of your target app instance to given file path.	Extension	GA
az spring app deployment list	List all deployments in an app.	Extension	GA
az spring app deployment show	Show details of a deployment.	Extension	GA
az spring app deployment start-jfr	Start a JFR on your target app instance to given file path.	Extension	GA

az spring app deployment create

Create a staging deployment for the app. To deploy code or update setting to an existing deployment, use az spring app deploy/update --deployment <staging deployment>.

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--apms]
                                [--artifact-path]
                                [--build-certificates]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--custom-actuator-path]
                                [--custom-actuator-port]
                                [--disable-app-log]
                                [--disable-probe {false, true}]
                                [--disable-validation {false, true}]
                                [--enable-liveness-probe {false, true}]
                                [--enable-readiness-probe {false, true}]
                                [--enable-startup-probe {false, true}]
                                [--env]
                                [--grace-period --termination-grace-period-seconds]
                                [--instance-count]
                                [--jvm-options]
                                [--language-framework]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--max-replicas]
                                [--memory]
                                [--min-replicas]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                                [--scale-rule-auth --sra]
                                [--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc]
                                [--scale-rule-metadata --srm]
                                [--scale-rule-name --srn]
                                [--scale-rule-type --srt]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

Examples

Deploy source code to a new deployment of an app. This will pack current directory, build binary with Pivotal Build Service and then deploy.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --source-path

Deploy a pre-built jar to an app with jvm options and environment variables.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Deploy a container image on Docker Hub to an app.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

Deploy a container image on a private registry to an app.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

Required Parameters

--app

Name of app.

--name -n

Name of deployment.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

The name of Azure Spring Apps instance, you can configure the default service using az configure --defaults spring=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--apms

(Enterprise Tier Only) Space-separated APM names.

--artifact-path

Deploy the specified pre-built artifact (jar, war or netcore zip, war is in public preview).

--build-certificates

(Enterprise Tier Only) Space-separated certificate names, the certificates are used during build time.

--build-env

Space-separated environment variables in 'key[=value]' format.

--builder

(Enterprise Tier Only) Build service builder used to build the executable.

Property	Value
Default value:	default

--config-file-patterns

(Enterprise Tier Only) Config file patterns separated with ',' to decide which patterns of Application Configuration Service will be used. Use '""' to clear existing configurations.

--container-args

The arguments of the container image.

Property	Value
Parameter group:	Custom Container Arguments

--container-command

The command of the container image.

Property	Value
Parameter group:	Custom Container Arguments

--container-image

The container image tag.

Property	Value
Parameter group:	Custom Container Arguments

--container-registry

The registry of the container image.

Property	Value
Parameter group:	Custom Container Arguments
Default value:	docker.io

--cpu

CPU resource quantity. Should be 250m, 500m, 750m, 1250m or number of CPU cores.

--custom-actuator-path

(Enterprise Tier Only) Custom actuator path for the app. Default to "/actuator".

--custom-actuator-port

(Enterprise Tier Only) Custom actuator port for the app. Default to 8080.

--disable-app-log

Do not print application logs when deploy application.

Property	Value
Default value:	False

--disable-probe

If true, disable the liveness and readiness probe.

Property	Value
Accepted values:	false, true

--disable-validation

If true, disable jar validation.

Property	Value
Accepted values:	false, true

--enable-liveness-probe

Preview

If false, will disable the liveness probe of the app instance.

Property	Value
Parameter group:	App Customization Arguments
Accepted values:	false, true

--enable-readiness-probe

Preview

If false, will disable the readiness probe of the app instance.

Property	Value
Parameter group:	App Customization Arguments
Accepted values:	false, true

--enable-startup-probe

Preview

If false, will disable the startup probe of the app instance.

Property	Value
Parameter group:	App Customization Arguments
Accepted values:	false, true

--env

Space-separated environment variables in 'key[=value]' format.

--grace-period --termination-grace-period-seconds

Preview

Optional duration in seconds the app instance needs to terminate gracefully.

Property	Value
Parameter group:	App Customization Arguments

--instance-count

Number of instance.

--jvm-options

A string containing jvm options, use '=' instead of ' ' for this argument to avoid bash parse error, eg: --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Language framework of the container image uploaded. Supported values: "springboot", "".

Property	Value
Parameter group:	Custom Container Arguments

--liveness-probe-config

Preview

A json file path indicates the liveness probe config.

Property	Value
Parameter group:	App Customization Arguments

--main-entry -m

A string containing the path to the .NET executable relative to zip root.

--max-replicas

The maximum number of replicas.

Property	Value
Parameter group:	StandardGen2 Arguments
Default value:	10

--memory

Memory resource quantity. Should be 512Mi, 1536Mi, 2560Mi, 3584Mi or #Gi, e.g., 1Gi, 3Gi.

--min-replicas

The minimum number of replicas.

Property	Value
Parameter group:	StandardGen2 Arguments
Default value:	1

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--readiness-probe-config

Preview

A json file path indicates the readiness probe config.

Property	Value
Parameter group:	App Customization Arguments

--registry-password

The password of the container registry.

Property	Value
Parameter group:	Custom Container Arguments

--registry-username

The username of the container registry.

Property	Value
Parameter group:	Custom Container Arguments

--runtime-version

Runtime version of used language.

Property	Value
Accepted values:	Java_11, Java_17, Java_21, Java_8, NetCore_31

--scale-rule-auth --sra

Scale rule auth parameters. Format <triggerParameter>=<secretRef> and separated by space.

Property	Value
Parameter group:	StandardGen2 Arguments

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

The maximum number of concurrent requests before scale out. Only supported for http and tcp scale rules.

Property	Value
Parameter group:	StandardGen2 Arguments

--scale-rule-metadata --srm

Scale rule metadata. Format "key[=value]" and separated by space.

Property	Value
Parameter group:	StandardGen2 Arguments

--scale-rule-name --srn

The name of the scale rule.

Property	Value
Parameter group:	StandardGen2 Arguments

--scale-rule-type --srt

The type of the scale rule. Default: http.

Property	Value
Parameter group:	StandardGen2 Arguments

--server-version

(Standard and Basic Tiers Only) Tomcat server version. List all supported server versions by running az spring list-support-server-versions -o table. This feature is in public preview.

--skip-clone-settings

Create staging deployment will automatically copy settings from production deployment.

Property	Value
Default value:	False

--source-path

Deploy the specified source folder. The folder will be packed into tar, uploaded, and built using kpack. Default to the current folder if no value provided.

Property	Value
Parameter group:	Source Code deploy Arguments

--startup-probe-config

Preview

A json file path indicates the startup probe config.

Property	Value
Parameter group:	App Customization Arguments

--target-module

Child module to be deployed, required for multiple jar packages built from source code.

Property	Value
Parameter group:	Source Code deploy Arguments

--version

Deployment version, keep unchanged if not set.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az spring app deployment delete

Delete a deployment of the app.

az spring app deployment delete --app
                                --name
                                --resource-group
                                --service
                                [--no-wait]

Required Parameters

--app

Name of app.

--name -n

Name of deployment.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

The name of Azure Spring Apps instance, you can configure the default service using az configure --defaults spring=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az spring app deployment generate-heap-dump

Generate a heap dump of your target app instance to given file path.

az spring app deployment generate-heap-dump --app
                                            --app-instance
                                            --file-path
                                            --resource-group
                                            --service
                                            [--deployment]

Required Parameters

--app

Name of app.

--app-instance

Target app instance you want to dump.

--file-path

The mount file path for your dump file.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

The name of Azure Spring Apps instance, you can configure the default service using az configure --defaults spring=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--deployment -d

Name of an existing deployment of the app. Default to the production deployment if not specified.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az spring app deployment generate-thread-dump

Generate a thread dump of your target app instance to given file path.

az spring app deployment generate-thread-dump --app
                                              --app-instance
                                              --file-path
                                              --resource-group
                                              --service
                                              [--deployment]

Required Parameters

--app

Name of app.

--app-instance

Target app instance you want to dump.

--file-path

The mount file path for your dump file.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

The name of Azure Spring Apps instance, you can configure the default service using az configure --defaults spring=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--deployment -d

Name of an existing deployment of the app. Default to the production deployment if not specified.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az spring app deployment list

List all deployments in an app.

az spring app deployment list --app
                              --resource-group
                              --service

Required Parameters

--app

Name of app.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

The name of Azure Spring Apps instance, you can configure the default service using az configure --defaults spring=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az spring app deployment show

Show details of a deployment.

az spring app deployment show --app
                              --name
                              --resource-group
                              --service

Required Parameters

--app

Name of app.

--name -n

Name of deployment.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

The name of Azure Spring Apps instance, you can configure the default service using az configure --defaults spring=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az spring app deployment start-jfr

Start a JFR on your target app instance to given file path.

az spring app deployment start-jfr --app
                                   --app-instance
                                   --file-path
                                   --resource-group
                                   --service
                                   [--deployment]
                                   [--duration]

Required Parameters

--app

Name of app.

--app-instance

Target app instance you want to dump.

--file-path

The mount file path for your dump file.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

The name of Azure Spring Apps instance, you can configure the default service using az configure --defaults spring=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--deployment -d

Name of an existing deployment of the app. Default to the production deployment if not specified.

--duration

Duration of JFR.

Property	Value
Default value:	60s

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False