快速入門：在 Azure Spring Apps 標準取用和專用方案中設定應用程式的自動調整

發行項
12/04/2024

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container Apps。

本文適用於：✅ 標準取用和專用（預覽） ❎ 基本/標準❎企業

本文說明如何在 Azure Spring Apps 標準取用和專用方案中設定應用程式的自動調整規則。此方案會使用 Azure Container Apps 環境來裝載 Spring 應用程式，並提供下列管理和支援：

透過一組宣告式調整規則來管理自動水平調整。
支援 Azure Container Apps 支援的所有調整規則。

如需詳細資訊，請參閱 Azure Container Apps 檔。

必要條件

Azure 訂用帳戶。如果您沒有 Azure 訂用帳戶，請在開始之前參閱 Azure 免費帳戶。
Azure Spring 應用程式標準取用和專用方案的服務執行個體。如需詳細資訊，請參閱快速入門：佈建 Azure Spring 應用程式標準取用和專用方案的服務執行個體。
部署至 Azure Spring 應用程式的 Spring 應用程式。

調整定義

調整是由限制和規則的組合所定義。

限制是 Spring 允許的最小和最大實例數目。

調整限制預設值最小值最大值

每個部署的實例數目下限 1 0 30

每個部署的實例數目上限 10 1 30

根據預設，Spring 應用程式的最小實例計數會設定為 1，以確保您的部署一律正在執行。如果您想要將縮減為零，您可以將最小實例計數設定為零。
規則是自動調整所遵守以新增或移除實例的準則。調整規則包括 HTTP、TCP 和自定義規則，如在 Azure Container Apps 中設定調整規則的調整規則一節所述。

如果您定義多個縮放規則，則自動調整會在符合任何規則的第一個條件時開始。
輪詢間隔和冷卻期間是自動調整期間發生的兩個時間範圍。
- 輪詢間隔會定義規則所定義之實時數據的每個輪詢動作之間的時間範圍。輪詢間隔預設會設定為30秒。
- 冷卻期間僅適用於調整為零時，例如，在上次自動調整檢查消息佇列且為空白時，等候五分鐘。

調整限制	預設值	最小值	最大值
每個部署的實例數目下限	1	0	30
每個部署的實例數目上限	10	1	30

設定自動調整設定

您可以使用 Azure 入口網站或 Azure CLI 來設定應用程式的自動調整設定。

Azure 入口網站
Azure CLI

使用下列步驟來定義自動調整設定和規則。

登入 Azure 入口網站。
選取 [Azure 服務] 底下的 [Azure Spring Apps]。
在 [名稱] 數據行中，選取您想要自動調整的 Azure Spring Apps 實例。
在 Azure Spring Apps 實例的概觀頁面上，選取 瀏覽窗格中的 [應用程式 ]。
選取您要自動調整的應用程式。
在所選應用程式的 [概觀] 頁面上，選取瀏覽窗格中的 [ 相應放大 ]。
在 [ 相應放大（預覽）] 頁面上，選取您要自動調整的部署。
設定部署的實例限制。
選取 [ 新增 ] 以新增您的調整規則。

使用下列命令，根據 Keda Azure 服務匯流排 Scaler，在具有自動調整規則的 Azure Spring Apps 中建立應用程式。

注意

Microsoft 建議您使用最安全的可用驗證流程。此程式中所述的驗證流程，例如資料庫、快取、傳訊或 AI 服務，在應用程式中需要高度的信任，而且不會在其他流程中帶來風險。只有在更安全的選項，例如無密碼或無密鑰連線的受控識別時，才能使用此流程。針對本機計算機作業，偏好使用無密碼或無密鑰連線的使用者身分識別。

az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --secrets "connection-string-secret=<service-bus-connection-string>" \
    --scale-rule-name azure-servicebus-queue-rule \
    --scale-rule-type azure-servicebus \
    --scale-rule-metadata "queueName=my-queue" \
                          "namespace=service-bus-namespace" \
                          "messageCount=5" \
    --scale-rule-auth "connection=connection-string-secret" \
    --min-replicas 0 \
    --max-replicas 5

復本計數會根據 Azure 服務匯流排佇列中的訊息計數自動調整。當佇列中沒有任何訊息時，您的應用程式會調整為 0 個複本。當佇列中有訊息時，應用程式會根據訊息計數相應放大。

自訂調整規則

如需定義自定義規則的資訊，請參閱 Keda Scalers。下列各節示範在 MySQL 和 Cron 上設定縮放規則的兩個範例。

在 MySQL 資料庫上設定自動調整規則

下列 CLI 命令示範如何根據 Keda MySQL Scaler 自動調整 Spring 應用程式。首先，建立秘密來儲存 SQL 連接字串。此秘密會用於調整規則驗證。然後，設定規則，根據數據表的數據列計數來調整應用程式。

注意

az spring app update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --secrets mysqlconnectionstring="<username>:<pwd>@tcp(<server name>:3306)/<database name>" 

az spring app scale \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --scale-rule-type mysql \
    --scale-rule-name <your rule name> \
    --scale-rule-auth "connectionString=mysqlconnectionstring" \
    --scale-rule-metadata queryValue=4 query="SELECT count(*) FROM mytable" \
    --min-replicas 0 \
    --max-replicas 3

根據Linux cron 建立規則

下列命令示範如何根據 Keda Cron Scaler 設定規則。復本會在cron時間間隔內調整為所需的數位。

az spring app scale \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --scale-rule-type cron \
    --scale-rule-name testscalerule \
    --scale-rule-metadata timezone="Asia/Shanghai" \
                          start="10 * * * *" \
                          end="15 * * * *" \
                          desiredReplicas="3" \
    --min-replicas 0 \
    --max-replicas 3

調整事件

您可以從基礎容器應用程式的系統記錄中找到調整事件，並使用來篩選 EventSource KEDA，如下列範例所示：

ContainerAppSystemLogs_CL 
| where ContainerAppName_s == 'YourAppName' and EventSource_s == 'KEDA'

清除資源

當您不再需要資源時，請務必刪除您在本文中建立的資源。若要刪除資源，只要刪除包含這些資源的資源群組即可。您可以使用 Azure 入口網站刪除資源群組。或者，若要使用 Azure CLI 刪除資源群組，請使用下列命令：

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

下一步

使用標準取用和專用方案，將自定義網域對應至 Azure Spring Apps

共用方式為