你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az spring app deployment

注意

此参考是 Azure CLI（版本 2.56.0 或更高版本）的 spring 扩展的一部分。 该扩展将在首次运行 az spring app deployment 命令时自动安装。 详细了解扩展。

用于管理 Azure Spring Apps 中应用的部署生命周期的命令。 可以使用参数 --deployment 在应用级别上对部署执行更多操作。 例如 az spring app deploy --deployment.

命令

名称	说明	类型	状态
az spring app deployment create	为应用创建过渡部署。 若要将代码或更新设置部署到现有部署，请使用 az spring app deploy/update --deployment <staging deployment>。	扩展	GA
az spring app deployment delete	删除应用的部署。	扩展	GA
az spring app deployment generate-heap-dump	将目标应用实例的堆转储生成到给定的文件路径。	扩展	GA
az spring app deployment generate-thread-dump	将目标应用实例的线程转储生成到给定的文件路径。	扩展	GA
az spring app deployment list	列出应用中的所有部署。	扩展	GA
az spring app deployment show	显示部署的详细信息。	扩展	GA
az spring app deployment start-jfr	在目标应用实例上启动 JFR 以指定文件路径。	扩展	GA

az spring app deployment create

为应用创建过渡部署。 若要将代码或更新设置部署到现有部署，请使用 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]
                                [--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]
                                [--scale-rule-http-concurrency]
                                [--scale-rule-metadata]
                                [--scale-rule-name]
                                [--scale-rule-type]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

示例

将源代码部署到应用的新部署。 这将打包当前目录，使用 Pivotal 生成服务生成二进制文件，然后部署。

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

使用 jvm 选项和环境变量将预生成的 jar 部署到应用。

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

将 Docker Hub 上的容器映像部署到应用。

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

将专用注册表上的容器映像部署到应用。

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>

必需参数

--app

应用的名称。

--name -n

部署的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service -s

Azure Spring Apps 实例的名称，可以使用 az configure --defaults spring=配置默认服务。

可选参数

--apms

（仅限企业层）空格分隔的 APM 名称。

--artifact-path

部署指定的预生成项目（jar、war 或 netcore zip，war 为公共预览版）。

--build-certificates

（仅限企业层）空间分隔的证书名称，证书在生成期间使用。

--build-env

以“key[=value]”格式分隔的空间分隔环境变量。

--builder

（仅限企业层）用于生成可执行文件的生成服务生成器。

默认值: default

--config-file-patterns

（仅限企业层）使用“”分隔的配置文件模式，以确定将使用哪个应用程序配置服务的模式。 使用“”“清除现有配置。

--container-args

容器映像的参数。

--container-command

容器映像的命令。

--container-image

容器映像标记。

--container-registry

容器映像的注册表。

默认值: docker.io

--cpu

CPU 资源数量。 应为 250m、500m、750m、12.50 米或 CPU 内核数。

--custom-actuator-path

（仅限企业层）应用的自定义执行器路径。 默认为“/执行器”。

--custom-actuator-port

（仅限企业层）应用的自定义执行器端口。 默认值为 8080。

--disable-app-log

部署应用程序时不要打印应用程序日志。

默认值: False

--disable-probe

如果为 true，请禁用实时性和就绪情况探测。

接受的值: false, true

--disable-validation

如果为 true，请禁用 jar 验证。

接受的值: false, true

--enable-liveness-probe

预览

如果为 false，将禁用应用实例的运行情况探测。

接受的值: false, true

--enable-readiness-probe

预览

如果为 false，将禁用应用实例的就绪情况探测。

接受的值: false, true

--enable-startup-probe

预览

如果为 false，将禁用应用实例的启动探测。

接受的值: false, true

--env

以“key[=value]”格式分隔的空间分隔环境变量。

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

预览

应用实例需要正常终止的可选持续时间（以秒为单位）。

--instance-count

实例数。

--jvm-options

包含 jvm 选项的字符串，请对此参数使用“=”而不是“'”以避免 bash 分析错误，例如：--jvm-options='-Xms1024m -Xmx2048m'。

--language-framework

上传的容器映像的语言框架。 支持的值：“springboot”、“”。

--liveness-probe-config

预览

json 文件路径指示实时探测配置。

--main-entry -m

一个字符串，包含相对于 zip 根的 .NET 可执行文件的路径。

--max-replicas

最大副本 (replica)数。

默认值: 10

--memory

内存资源数量。 应为 512Mi、1536Mi、2560Mi、3584Mi 或 #Gi，例如 1Gi、3Gi。

--min-replicas

最小副本 (replica)数。

默认值: 1

--no-wait

不等待长时间运行的操作完成。

默认值: False

--readiness-probe-config

预览

json 文件路径指示就绪情况探测配置。

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

横向扩展前的最大并发请求数。仅支持 http 和 tcp 缩放规则。

--scale-rule-metadata --srm

缩放规则元数据。 设置“key[=value]”格式，并用空格分隔。

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。 默认值：http。

--server-version

（仅限标准和基本层）Tomcat 服务器版本。 通过运行 az spring list-support-server-versions -o table列出所有受支持的服务器版本。 此功能目前以公共预览版提供。

--skip-clone-settings

创建过渡部署将自动从生产部署复制设置。

默认值: False

--source-path

部署指定的源文件夹。 该文件夹将打包到 tar 中，上传并使用 kpack 生成。 如果未提供任何值，则默认为当前文件夹。

--startup-probe-config

预览

json 文件路径指示启动探测配置。

--target-module

要部署的子模块，需要从源代码生成的多个 jar 包。

--version

部署版本，如果未设置，则保持不变。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az spring app deployment delete

删除应用的部署。

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

必需参数

--app

应用的名称。

--name -n

部署的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service -s

Azure Spring Apps 实例的名称，可以使用 az configure --defaults spring=配置默认服务。

可选参数

--no-wait

不等待长时间运行的操作完成。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az spring app deployment generate-heap-dump

将目标应用实例的堆转储生成到给定的文件路径。

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

必需参数

--app

应用的名称。

--app-instance

要转储的目标应用实例。

--file-path

转储文件的装载文件路径。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service -s

Azure Spring Apps 实例的名称，可以使用 az configure --defaults spring=配置默认服务。

可选参数

--deployment -d

应用的现有部署的名称。 如果未指定，则默认为生产部署。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az spring app deployment generate-thread-dump

将目标应用实例的线程转储生成到给定的文件路径。

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

必需参数

--app

应用的名称。

--app-instance

要转储的目标应用实例。

--file-path

转储文件的装载文件路径。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service -s

Azure Spring Apps 实例的名称，可以使用 az configure --defaults spring=配置默认服务。

可选参数

--deployment -d

应用的现有部署的名称。 如果未指定，则默认为生产部署。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az spring app deployment list

列出应用中的所有部署。

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

必需参数

--app

应用的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service -s

Azure Spring Apps 实例的名称，可以使用 az configure --defaults spring=配置默认服务。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az spring app deployment show

显示部署的详细信息。

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

必需参数

--app

应用的名称。

--name -n

部署的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service -s

Azure Spring Apps 实例的名称，可以使用 az configure --defaults spring=配置默认服务。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az spring app deployment start-jfr

在目标应用实例上启动 JFR 以指定文件路径。

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

必需参数

--app

应用的名称。

--app-instance

要转储的目标应用实例。

--file-path

转储文件的装载文件路径。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service -s

Azure Spring Apps 实例的名称，可以使用 az configure --defaults spring=配置默认服务。

可选参数

--deployment -d

应用的现有部署的名称。 如果未指定，则默认为生产部署。

--duration

JFR 的持续时间。

默认值: 60s

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。