az spring-cloud app

注意

此參考是 Azure CLI (2.30.0 版或更高版本) 的 spring-cloud 擴充功能的一部分。 當您第一次執行 az spring-cloud app 命令時,擴充功能會自動安裝。 深入了解延伸模組。

在 Azure Spring Cloud 中管理應用程式的命令。

命令

az spring-cloud app append-loaded-public-certificate

將新載入的公用憑證附加至 Azure Spring Cloud 中的應用程式。

az spring-cloud app append-persistent-storage

將新的永續性儲存體附加至 Azure Spring Cloud 中的應用程式。

az spring-cloud app binding

使用 Azure Data Services 管理系結的命令,您必須手動重新開機應用程式,讓設定生效。

az spring-cloud app binding cosmos

用來管理 Azure Cosmos DB 系結的命令。

az spring-cloud app binding cosmos add

將 Azure Cosmos DB 與應用程式系結。

az spring-cloud app binding cosmos update

更新應用程式的 Azure Cosmos DB 服務系結。

az spring-cloud app binding list

列出應用程式中的所有服務系結。

az spring-cloud app binding mysql

用來管理適用於 MySQL 的 Azure 資料庫系結的命令。

az spring-cloud app binding mysql add

將適用於 MySQL 的 Azure 資料庫系結至應用程式。

az spring-cloud app binding mysql update

更新應用程式的適用於 MySQL 的 Azure 資料庫服務系結。

az spring-cloud app binding redis

用來管理Azure Cache for Redis系結的命令。

az spring-cloud app binding redis add

將Azure Cache for Redis系結至應用程式。

az spring-cloud app binding redis update

更新應用程式的Azure Cache for Redis服務系結。

az spring-cloud app binding remove

移除應用程式的服務系結。

az spring-cloud app binding show

顯示服務系結的詳細資料。

az spring-cloud app create

在 Azure Spring Cloud 中建立具有預設部署的新應用程式。

az spring-cloud app custom-domain

用來管理自訂網域的命令。

az spring-cloud app custom-domain bind

將自訂網域與應用程式系結。

az spring-cloud app custom-domain list

列出應用程式的所有自訂網域。

az spring-cloud app custom-domain show

顯示自訂網域的詳細資料。

az spring-cloud app custom-domain unbind

解除系結應用程式的自訂網域。

az spring-cloud app custom-domain update

更新應用程式的自訂網域。

az spring-cloud app delete

刪除 Azure Spring Cloud 中的應用程式。

az spring-cloud app deploy

將原始程式碼或預先建置的二進位檔部署到應用程式並更新相關的設定。

az spring-cloud app deployment

在 Azure Spring Cloud 中管理應用程式部署生命週期的命令。 更多有關部署的作業可以使用參數 --deployment 在應用層級上完成。 例如 az spring-cloud app deploy --deployment 。

az spring-cloud app deployment create

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

az spring-cloud app deployment delete

刪除應用程式的部署。

az spring-cloud app deployment generate-heap-dump

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

az spring-cloud app deployment generate-thread-dump

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

az spring-cloud app deployment list

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

az spring-cloud app deployment show

顯示部署的詳細資料。

az spring-cloud app deployment start-jfr

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

az spring-cloud app identity

管理應用程式的受控識別。

az spring-cloud app identity assign

啟用系統指派的受控識別,或將使用者指派的受控識別指派給應用程式。

az spring-cloud app identity force-set

在應用程式上強制設定受控識別。

az spring-cloud app identity remove

從應用程式移除受控識別。

az spring-cloud app identity show

顯示應用程式的受控識別資訊。

az spring-cloud app list

列出 Azure Spring Cloud 中的所有應用程式。

az spring-cloud app log

使用多個選項結尾應用程式實例記錄的命令。 如果應用程式只有一個實例,則實例名稱是選擇性的。

az spring-cloud app log tail

顯示應用程式實例的記錄,設定 '-f/--follow' 時,將會串流記錄。

az spring-cloud app logs

顯示應用程式實例的記錄,設定 '-f/--follow' 時,將會串流記錄。

az spring-cloud app restart

重新開機應用程式的實例,預設為生產部署。

az spring-cloud app scale

手動調整應用程式或其部署。

az spring-cloud app set-deployment

設定應用程式的生產部署。

az spring-cloud app show

在 Azure Spring Cloud 中顯示應用程式的詳細資料。

az spring-cloud app show-deploy-log

顯示上次部署的組建記錄,僅適用于原始程式碼部署,預設為生產部署。

az spring-cloud app start

啟動應用程式的實例,預設為生產部署。

az spring-cloud app stop

停止應用程式的實例,預設為生產部署。

az spring-cloud app unset-deployment

取消設定應用程式的生產部署。

az spring-cloud app update

更新應用程式的組態。

az spring-cloud app append-loaded-public-certificate

將新載入的公用憑證附加至 Azure Spring Cloud 中的應用程式。

az spring-cloud app append-loaded-public-certificate --certificate-name
                                                     --load-trust-store {false, true}
                                                     --name
                                                     --resource-group
                                                     --service

範例

將新載入的公用憑證附加至應用程式。

az spring-cloud app append-loaded-public-certificate --name MyApp --service MyCluster --resource-group MyResourceGroup --certificate-name MyCertName --load-trust-store true

必要參數

--certificate-name

要附加的憑證名稱。

--load-trust-store

如果為 true,則會將憑證載入 JAVA 應用程式的信任存放區。

接受的值: false, true
--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

az spring-cloud app append-persistent-storage

將新的永續性儲存體附加至 Azure Spring Cloud 中的應用程式。

az spring-cloud app append-persistent-storage --mount-path
                                              --name
                                              --persistent-storage-type
                                              --resource-group
                                              --service
                                              --share-name
                                              --storage-name
                                              [--mount-options]
                                              [--read-only {false, true}]

範例

將新的永續性儲存體附加至應用程式。

az spring-cloud app append-persistent-storage --persistent-storage-type AzureFileVolume --share-name MyShareName --mount-path /MyMountPath --storage-name MyStorageName -n MyApp -g MyResourceGroup -s MyService

必要參數

--mount-path

要掛接之永續性儲存體磁片區的路徑。

--name -n

應用程式的名稱。

--persistent-storage-type -t

永續性儲存體磁片區的類型。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

--share-name

預先建立的檔案共用名稱稱。 只有在永續性儲存體磁片區的類型為 AzureFileVolume 時,才應該提供 ShareName。

--storage-name

您在 Azure Spring Cloud 中建立的儲存體資源名稱。

選擇性參數

--mount-options

[選擇性]永續性儲存體磁片區的掛接選項。

--read-only

[選擇性]如果為 true,則永續性儲存體磁片區將會是唯讀的。

接受的值: false, true

az spring-cloud app create

在 Azure Spring Cloud 中建立具有預設部署的新應用程式。

az spring-cloud app create --name
                           --resource-group
                           --service
                           [--assign-endpoint {false, true}]
                           [--assign-identity {false, true}]
                           [--cpu]
                           [--disable-probe {false, true}]
                           [--enable-persistent-storage {false, true}]
                           [--env]
                           [--instance-count]
                           [--jvm-options]
                           [--loaded-public-certificate-file]
                           [--memory]
                           [--persistent-storage]
                           [--runtime-version {Java_11, Java_17, Java_8, NetCore_31}]
                           [--system-assigned {false, true}]
                           [--user-assigned]

範例

使用預設組態建立應用程式。

az spring-cloud app create -n MyApp -s MyCluster -g MyResourceGroup

建立具有 3 個實例和 2 個 CPU 核心和每個實例 3 GB 記憶體的公用可存取應用程式。

az spring-cloud app create -n MyApp -s MyCluster -g MyResourceGroup --assign-endpoint true --cpu 2 --memory 3 --instance-count 3

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--assign-endpoint

如果為 true,請指派端點 URL 以進行直接存取。

接受的值: false, true
--assign-identity

啟用系統指派的受控識別。

接受的值: false, true
--cpu

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

預設值: 1
--disable-probe

如果為 true,請停用活躍度和整備探查。

接受的值: false, true
--enable-persistent-storage

如果為 true,請掛接 50G (標準定價層) 或 1G (基本定價層) 預設路徑的磁片。

接受的值: false, true
--env

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

--instance-count

實例數目。

預設值: 1
--jvm-options

包含 jvm 選項的字串,請針對此引數使用 '=' 而不是 ' ',以避免 bash 剖析錯誤,例如:--jvm-options='-Xms1024m -Xmx2048m'。

--loaded-public-certificate-file -f

json 檔案路徑會指出要載入至應用程式的憑證。

--memory

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

預設值: 1Gi
--persistent-storage

要掛接至應用程式的永續性儲存體 JSON 檔案路徑。

--runtime-version

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

接受的值: Java_11, Java_17, Java_8, NetCore_31
--system-assigned

啟用系統指派的受控識別。

接受的值: false, true
--user-assigned

將空間分隔的使用者指派受控識別資源識別碼指派給應用程式。

az spring-cloud app delete

刪除 Azure Spring Cloud 中的應用程式。

az spring-cloud app delete --name
                           --resource-group
                           --service

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

az spring-cloud app deploy

將原始程式碼或預先建置的二進位檔部署至應用程式並更新相關的組態。

az spring-cloud app deploy --name
                           --resource-group
                           --service
                           [--artifact-path]
                           [--build-env]
                           [--builder]
                           [--config-file-patterns]
                           [--container-args]
                           [--container-command]
                           [--container-image]
                           [--container-registry]
                           [--deployment]
                           [--disable-probe {false, true}]
                           [--disable-validation {false, true}]
                           [--env]
                           [--jvm-options]
                           [--main-entry]
                           [--no-wait]
                           [--registry-password]
                           [--registry-username]
                           [--runtime-version {Java_11, Java_17, Java_8, NetCore_31}]
                           [--source-path]
                           [--target-module]
                           [--version]

範例

將原始程式碼部署至應用程式。 這會封裝目前目錄、使用 Pivotal Build Service 建置二進位檔,然後部署至應用程式。

az spring-cloud app deploy -n MyApp -s MyCluster -g MyResourceGroup

使用 jvm 選項和環境變數,將預先建置的 jar 部署至應用程式。

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

將原始程式碼部署至應用程式的特定部署。

az spring-cloud app deploy -n MyApp -s MyCluster -g MyResourceGroup -d green-deployment

將容器映射部署至應用程式Docker Hub。

az spring-cloud app deploy -n MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

將私人登錄上的容器映射部署到應用程式。

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

使用應用程式組態服務組態檔模式部署至應用程式。

az spring-cloud app deploy -n MyApp -s MyCluster -g MyResourceGroup --config-file-patterns MyPatterns --jar-path app.jar

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

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

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

--disable-probe

如果為 true,請停用活躍度和整備探查。

接受的值: false, true
--disable-validation

如果為 true,請停用 jar 驗證。

接受的值: false, true
--env

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

--jvm-options

包含 jvm 選項的字串,請針對此引數使用 '=' 而不是 ' ',以避免 bash 剖析錯誤,例如:--jvm-options='-Xms1024m -Xmx2048m'。

--main-entry -m

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

--no-wait

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

--registry-password

容器登錄的密碼。

--registry-username

容器登錄的使用者名稱。

--runtime-version

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

接受的值: Java_11, Java_17, Java_8, NetCore_31
--source-path

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

--target-module

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

--version

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

az spring-cloud app list

列出 Azure Spring Cloud 中的所有應用程式。

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

範例

所有應用程式的持續性儲存體查詢狀態

az spring-cloud app list -s MyCluster -g MyResourceGroup -o json --query '[].{Name:name, PersistentStorage:properties.persistentDisk}'

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

az spring-cloud app logs

顯示應用程式實例的記錄,設定 '-f/--follow' 時,將會串流記錄。

az spring-cloud app logs --name
                         --resource-group
                         --service
                         [--deployment]
                         [--follow]
                         [--format-json]
                         [--instance]
                         [--limit]
                         [--lines]
                         [--since]

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--deployment -d

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

--follow -f

指定是否應該串流記錄。

--format-json

如果已啟用結構化記錄檔,請格式化 JSON 記錄。

--instance -i

部署的現有實例名稱。

--limit

要傳回的記錄數目上限。 上限編號為 2048。

預設值: 2048
--lines

要顯示的行數。 最大值為 10000。

預設值: 50
--since

只傳回比相對持續時間還新的記錄,例如 5s、2m 或 1h。 最大值為 1h。

az spring-cloud app restart

重新開機應用程式的實例,預設為生產部署。

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

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--deployment -d

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

--no-wait

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

az spring-cloud app scale

手動調整應用程式或其部署。

az spring-cloud app scale --name
                          --resource-group
                          --service
                          [--cpu]
                          [--deployment]
                          [--instance-count]
                          [--memory]
                          [--no-wait]

範例

將應用程式相應增加至每個實例 4 個 CPU 核心和 8 Gb 的記憶體。

az spring-cloud app scale -n MyApp -s MyCluster -g MyResourceGroup --cpu 3 --memory 8

將應用程式的部署相應放大至 5 個實例。

az spring-cloud app scale -n MyApp -s MyCluster -g MyResourceGroup -d green-deployment --instance-count 5

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--cpu

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

--deployment -d

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

--instance-count

實例數目。

--memory

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

--no-wait

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

az spring-cloud app set-deployment

設定應用程式的生產環境部署。

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

範例

將應用程式的預備部署交換至生產環境。

az spring-cloud app set-deployment -d green-deployment -n MyApp -s MyCluster -g MyResourceGroup

必要參數

--deployment -d

應用程式現有部署的名稱。

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--no-wait

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

az spring-cloud app show

在 Azure Spring Cloud 中顯示應用程式的詳細資料。

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

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

az spring-cloud app show-deploy-log

顯示上次部署的組建記錄,僅適用于原始程式碼部署,預設為生產部署。

az spring-cloud app show-deploy-log --name
                                    --resource-group
                                    --service
                                    [--deployment]

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--deployment -d

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

az spring-cloud app start

啟動應用程式的實例,預設為生產部署。

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

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--deployment -d

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

--no-wait

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

az spring-cloud app stop

停止應用程式的實例,預設為生產環境部署。

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

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--deployment -d

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

--no-wait

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

az spring-cloud app unset-deployment

取消設定應用程式的生產環境部署。

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

範例

如果應用程式具有生產部署,請交換應用程式的生產部署至預備環境。

az spring-cloud app unset-deployment -n MyApp -s MyCluster -g MyResourceGroup

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--no-wait

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

az spring-cloud app update

更新應用程式的組態。

az spring-cloud app update --name
                           --resource-group
                           --service
                           [--assign-endpoint {false, true}]
                           [--config-file-patterns]
                           [--deployment]
                           [--disable-probe {false, true}]
                           [--enable-ingress-to-app-tls {false, true}]
                           [--enable-persistent-storage {false, true}]
                           [--env]
                           [--https-only {false, true}]
                           [--jvm-options]
                           [--loaded-public-certificate-file]
                           [--main-entry]
                           [--no-wait]
                           [--persistent-storage]
                           [--runtime-version {Java_11, Java_17, Java_8, NetCore_31}]

範例

新增應用程式的環境變數。

az spring-cloud app update -n MyApp -s MyCluster -g MyResourceGroup --env foo=bar

必要參數

--name -n

應用程式的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service -s

Azure Spring Cloud 的名稱,您可以使用 az configure --defaults spring-cloud=來設定預設服務。

選擇性參數

--assign-endpoint

如果為 true,請指派端點 URL 以進行直接存取。

接受的值: false, true
--config-file-patterns

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

--deployment -d

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

--disable-probe

如果為 true,請停用活躍度和整備探查。

接受的值: false, true
--enable-ingress-to-app-tls

如果為 true,請啟用應用程式 TLS 的輸入。

接受的值: false, true
--enable-persistent-storage

如果為 true,請掛接 50G (標準定價層) 或 1G (基本定價層) 預設路徑的磁片。

接受的值: false, true
--env

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

--https-only

如果為 true,請透過 HTTPs 存取應用程式。

接受的值: false, true
--jvm-options

包含 jvm 選項的字串,請針對此引數使用 '=' 而不是 ' ',以避免 bash 剖析錯誤,例如:--jvm-options='-Xms1024m -Xmx2048m'。

--loaded-public-certificate-file -f

json 檔案路徑會指出要載入至應用程式的憑證。

--main-entry -m

相對於 zip 根目錄的 .NET 可執行檔路徑。

--no-wait

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

--persistent-storage

要掛接至應用程式的永續性儲存體 JSON 檔案路徑。

--runtime-version

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

接受的值: Java_11, Java_17, Java_8, NetCore_31