az spring app deployment

注意

此參考是 Azure CLI (2.30.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>

az spring app deployment delete

刪除應用程式的部署。

az spring app deployment generate-heap-dump

產生目標應用程式實例到指定檔案路徑的堆積傾印。

az spring app deployment generate-thread-dump

產生目標應用程式實例到指定檔案路徑的執行緒傾印。

az spring app deployment list

列出應用程式中的所有部署。

az spring app deployment show

顯示部署的詳細資料。

az spring app deployment start-jfr

在您的目標應用程式實例上啟動 JFR 至指定的檔案路徑。

az spring app deployment create

建立應用程式的預備部署。 若要將程式碼或更新設定部署至現有的部署,請使用 az spring app deploy/update --deployment <staging deployment>

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--artifact-path]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--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]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--memory]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--runtime-version {Java_11, Java_17, Java_8, NetCore_31}]
                                [--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=來設定預設服務。

選擇性參數

--artifact-path

部署指定的預先建置成品 (jar 或 netcore zip) 。

--build-env

以 'key[=value]' 格式分隔的空間環境變數。

--builder

(Enterprise Tier 僅) 用來建置可執行檔的組建服務產生器。

預設值: default
--config-file-patterns

(企業層僅) 組態檔模式與 ',' 分隔,以決定將使用哪一種應用程式組態服務的模式。 使用 '「」' 清除現有的組態。

--container-args

容器映射的引數。

--container-command

容器映射的命令。

--container-image

容器映射標籤。

--container-registry

容器映射的登錄。

預設值: docker.io
--cpu

CPU 資源數量。 應該是 500m 或 CPU 核心數目。

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

--liveness-probe-config

json 檔案路徑表示即時探查組態。

--main-entry -m

字串,包含相對於 zip 根目錄的 .NET 可執行檔路徑。

--memory

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

--no-wait

不等候長時間執行的作業完成。

--readiness-probe-config

json 檔案路徑表示整備探查組態。

--registry-password

容器登錄的密碼。

--registry-username

容器登錄的使用者名稱。

--runtime-version

已使用語言的執行時間版本。

接受的值: Java_11, Java_17, Java_8, NetCore_31
--skip-clone-settings

建立預備部署會自動從生產部署複製設定。

--source-path

部署指定的來源資料夾。 資料夾會封裝到 tar、uploaded,並使用 kpack 建置。 如果未提供任何值,則預設為目前資料夾。

--startup-probe-config

json 檔案路徑表示啟動探查組態。

--target-module

要部署的子模組,需要從原始程式碼建置的多個 jar 套件。

--version

部署版本,如果未設定,則保持不變。

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

不等候長時間執行的作業完成。

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

應用程式現有部署的名稱。 如果未指定,則預設為生產部署。

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

應用程式現有部署的名稱。 如果未指定,則預設為生產部署。

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=來設定預設服務。

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=來設定預設服務。

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