在 Azure 容器應用程式中為 Durable Task SDK 應用程式設定自動調整

當你在 Azure 容器應用程式 中架設 Durable Task SDK 應用程式時,你可以設定自動擴展,讓平台根據你的編排、活動或實體工作負載自動調整副本數量。

在本文中,您將學會如何:

  • 為你的容器應用程式設定最小和最大副本數量。
  • 新增能回應持久任務排程器工作項目的規模規則。
  • 部署並驗證使用 Azure Developer CLI 的自動縮放範例。

備註

自動擴展支援使用 Durable Task SDK 建置並托管於 Azure 容器應用程式 的應用程式。 此功能使用 azure-durabletask-scheduler KEDA 縮放器。

Important

將 minReplicas 設定為 0 可啟用縮放至零,這會在閒置時節省成本,但在新的工作項目抵達時會導入冷啟動延遲。 如果你的工作負載對延遲敏感,則設定 minReplicas 為 1 或更高。

配置 Durable Functions 自動縮放

對於在 Azure 容器應用程式 上使用 Durable Task Scheduler 的 Durable Functions 應用程式,請在已部署的 host.json 檔案中包含 Durable Task Scheduler 的設定,讓平台能產生 Durable Scale 規則。

Important

不要只透過環境變數覆寫來設定這些設定。 函式主機目前在建置用於自動縮放的觸發程序中繼資料時,會直接從 host.json 讀取 Durable 設定。 你的應用程式可以連接排程器,並在未設定相應的 Durable 調整規模規則的情況下順利處理工作。

例如,將以下配置合併到你現有 host.json的配置中:

{
  "version": "2.0",
  "extensions": {
    "durableTask": {
      "hubName": "myTaskHub",
      "storageProvider": {
        "type": "azureManaged",
        "connectionStringName": "MySchedulerConnection"
      }
    }
  }
}

在這個例子中, MySchedulerConnection 是包含排程器 連接字串 的應用程式設定名稱。 將連接字串值存在這個設定裡,而不是 host.json。

保持提供者類型、任務集線器名稱及連線設定名稱與執行時覆寫一致。 重新部署後,請確認新版本包含 Durable 協調流程、活動及實體調整規模規則。

設定自動調整程式

你可以透過 Azure 入口網站、Bicep 範本和 Azure CLI 設定自動縮放器設定。

  1. 在 Azure 入口網站中,流覽至您的容器應用程式。

  2. 從左側選單選擇 應用>量表。

  3. 為你的修訂設定最小 複製 數和 最大複製 數值。

     在 Azure portal 中縮放器最小與最大複製設定的截圖。

  4. 選擇 新增 以建立新的縮放規則。 把 類型 設為 自訂 ,並設定持久任務排程器欄位。

    在 Azure 入口網站中,調整程式之長期工作排程器相關設定的螢幕擷取畫面。

  5. 請確保勾選「 以管理身份認證 」的核取方塊,並選擇與您的排程器及任務中心資源連結的身份。

  6. 選取 [儲存]。

領域 說明 範例
最小複本 在任何指定時間允許容器修訂的複本數目下限。 1
最大複本 在任何指定時間允許容器修訂的複本數目上限。 10
端點 調整程式連線的長期工作排程器端點。 https://dts-ID.centralus.durabletask.io
maxConcurrentWorkItemsCount (最大並行工作項數量) 單一複本可並行處理的工作項目數上限。 數值越低,調整器會較早新增副本。 對於 CPU 密集型工作,請從 1 開始;針對 I/O 繫結工作負載,請增加此值。 1
taskhubName 與排程器連接的工作中樞名稱。 taskhub-ID
工作項目類型 正在分派的工作項目類型。 選項包含 Orchestration、Activity 或 Entity。 Orchestration
受管理的識別 與排程器和任務中心資源相關聯的使用者指派或系統指派的受控身份。 /subscriptions/<SUB_ID>/resourceGroups/<RG>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<IDENTITY_NAME>

教學:部署自動縮放容器應用程式

已經在現有應用程式上設定自動縮放了嗎? 你可以跳過這部分。 如果你想要實地操作,請按照以下步驟使用 Azure Developer CLI 部署 Azure 容器應用程式 中的 Autoscaling 範例。 範例部署了一個 .NET Durable Task SDK 應用程式,採用函式鏈式模式,並包含預先設定的 KEDA 縮放器。

備註

雖然本範例使用 Durable Task .NET SDK,但自動縮放不依賴語言。

先決條件

設定您的環境

  1. 複製 Azure-Samples/Durable-Task-Scheduler 目錄。

    git clone https://github.com/Azure-Samples/Durable-Task-Scheduler.git
    
  2. 使用 Azure 開發人員 CLI 向 Azure 進行驗證。

    azd auth login
    

用 Azure Developer CLI 部署解決方案

  1. 流覽至 AutoscalingInACA 範例目錄。

    cd /path/to/Durable-Task-Scheduler/samples/scenarios/AutoscalingInACA
    
  2. 初始化 Azure Developer CLI 的環境(僅在第一次需要):

    azd init
    
  3. 佈建資源並部署應用程式:

    azd up
    
  4. 在終端機出現提示時,請提供下列參數。

    參數 說明
    環境名稱 為用來儲存所有 Azure 資源而建立的資源群組所使用的前綴。
    Azure 位置 您資源的 Azure 地區位置。
    Azure 訂用帳戶 您資源的 Azure 訂閱。

    此程序需要一些時間才會完成。 當 azd up 命令完成時,CLI 輸出會顯示兩個 Azure 入口網站連結,以監視部署進度。 輸出也會示範如何 azd up:

    • 透過 ./infra 目錄中提供的 Bicep 檔案,使用 azd provision 建立並配置所有必要的Azure資源。 經 Azure Developer CLI 配置後,您可以透過 Azure 入口網站存取這些資源。 提供 Azure 資源的檔案包括:
      • main.parameters.json
      • main.bicep
      • 依功能組織的 app 資源目錄
      • 包含 core 範本所使用 Bicep 模組的 azd 參考程式庫
    • 使用 azd deploy 部署程式碼

    預期的輸出

    Packaging services (azd package)
    
    (✓) Done: Packaging service client
    - Image Hash: {IMAGE_HASH}
    - Target Image: {TARGET_IMAGE}
    
    
    (✓) Done: Packaging service worker
    - Image Hash: {IMAGE_HASH}
    - Target Image: {TARGET_IMAGE}
    
    
    Provisioning Azure resources (azd provision)
    Provisioning Azure resources can take some time.
    
    Subscription: SUBSCRIPTION_NAME (SUBSCRIPTION_ID)
    Location: West US 2
    
     You can view detailed progress in the Azure portal:
     https://portal.azure.com/#view/HubsExtension/DeploymentDetailsBlade/~/overview/id/%2Fsubscriptions%SUBSCRIPTION_ID%2Fproviders%2FMicrosoft.Resources%2Fdeployments%2FCONTAINER_APP_ENVIRONMENT
    
     (✓) Done: Resource group: GENERATED_RESOURCE_GROUP (1.385s)
     (✓) Done: Virtual Network: VNET_ID (862ms)
     (✓) Done: Container Apps Environment: GENERATED_CONTAINER_APP_ENVIRONMENT (54.125s)
     (✓) Done: Container Registry: GENERATED_REGISTRY (1m27.747s)
     (✓) Done: Container App: SAMPLE_CLIENT_APP (21.39s)
     (✓) Done: Container App: SAMPLE_WORKER_APP (24.136s)   
    
    Deploying services (azd deploy)
    
     (✓) Done: Deploying service client
     - Endpoint: https://SAMPLE_CLIENT_APP.westus2.azurecontainerapps.io/
    
     (✓) Done: Deploying service worker
     - Endpoint: https://SAMPLE_WORKER_APP.westus2.azurecontainerapps.io/
    
    
    SUCCESS: Your up workflow to provision and deploy to Azure completed in 10 minutes 34 seconds.   
    

確認成功部署

在 Azure 入口網站中,確認協調流程已成功執行。

  1. 從終端機輸出複製資源組名。

  2. 登入 Azure 入口網站,搜尋該資源群組名稱。

  3. 在 [資源群組概觀] 頁面上,按一下用戶端容器應用程式資源。

  4. 選取 [監視>記錄數據流]。

  5. 確認用戶端容器正在記錄函式鏈結工作。

    Azure 入口網站中用戶端容器記錄數據流的螢幕快照。

  6. 流覽回資源群組頁面,以選取 worker 容器。

  7. 選取 [監視>記錄數據流]。

  8. 確認背景工作角色容器正在記錄函式鏈結工作。

    Azure 平台中,工作者容器的日誌流截圖。

了解自訂比例器

此範例包含 azure.yaml 組態檔。 當你執行 azd up 時,你已經部署了整個範例解決方案到 Azure,包括一個自訂的容器應用程式縮放器,會根據持久任務排程器的工作負載自動擴展。

自訂調整程式:

  • 監視工作中樞內擱置的協調流程數目。
  • 當工作負載增加時,會相應增加背景工作角色複本的數目。
  • 當負載減少時,會將規模縮小。
  • 藉由比對容量與需求,提供有效率的資源使用率。

驗證縮放器配置

確認自動調整功能在已部署的解決方案中正常運作。

  1. 在 Azure 入口網站中,導覽到你的工作者應用程式。

  2. 從左側選單中,選擇 應用程式>修訂與複本。

  3. 選擇「 複製品 」標籤以確認你的應用程式正在擴展。

    螢幕擷取畫面顯示 Azure 入口網站中具有縮放複本的修訂和複本頁面。

  4. 從左側選單選擇 應用>量表。

  5. 選擇縮放規則名稱以查看縮放器的設定。