az spring app deployment

  • 參考

注意

此參考是 Azure CLI 的 Spring 擴充功能的一部分 （2.45.0 版或更高版本）。 擴充功能會在您第一次執行 az spring app deployment 命令時自動安裝。 深入了解擴充功能。

在 Azure Spring Apps 中管理應用程式部署生命週期的命令。 您可以使用 參數 --deployment，在應用層級上執行更多部署作業。 例如 az spring app deploy --deployment 。

命令

名稱 Description 類型 狀態
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]
                                [--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 Build Service 建置二進位檔，然後部署。

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、1250m 或 CPU 核心數目。

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

複本數目上限。

預設值: 10
--memory

記憶體資源數量。 應該是 512Mi、1536Mi、2560Mi、3584Mi 或 #Gi，例如 1Gi、3Gi。

--min-replicas

複本數目下限。

預設值: 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。