將異常偵測程式單變數容器部署至Azure 容器執行個體

發行項
01/18/2024

重要

從 2023 年 9 月 20 日起，您將無法建立新的異常偵測程式資源。異常偵測程式服務將于 2026 年 10 月 1 日淘汰。

瞭解如何將 Azure AI 服務異常偵測程式容器部署至 Azure 容器執行個體。此程式示範如何建立異常偵測程式資源。然後，我們會討論提取相關聯的容器映射。最後，我們強調能夠從瀏覽器執行兩者協調流程。使用容器可將開發人員的注意力從管理基礎結構轉移到專注于應用程式開發。

必要條件

使用 Azure 訂用帳戶。如尚未擁有 Azure 訂用帳戶，請在開始之前先建立免費帳戶。
安裝 Azure CLI （az）。
Docker 引擎並驗證 Docker CLI 是否可在主控台視窗中運作。

建立異常偵測器資源

登入 Azure 入口網站。
選取 [ 建立異常偵測程式資源]。

輸入所有必要的設定：

設定	值
名稱	所需名稱（2-64 個字元）
訂用帳戶	選取適當的訂用帳戶
位置	選取任何附近的可用位置
定價層	`F0` - 每秒 10 次呼叫，每月 20K 筆交易。或： `S0` - 每秒 80 個呼叫數
資源群組	選取可用的資源群組

選取 [建立]，然後等候系統建立資源。建立之後，流覽至資源頁面

收集已設定 endpoint 的 API 金鑰：

入口網站中的 [金鑰和端點] 索引標籤	設定	值
概觀	端點	複製端點。看起來類似 `https://<your-resource-name>.cognitiveservices.azure.com/`
[索引鍵]	API 金鑰	複製兩個金鑰的 1。它是 32 個英數位元字串，不含空格或破折號。 `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

從 Azure CLI 建立 Azure 容器實例資源

下列 YAML 會定義 Azure 容器實例資源。將內容複寫並貼到名為的新檔案中， my-aci.yaml 並以您自己的值取代批註值。請參閱有效的 YAML 範本格式。如需可用的映射名稱和其對應的存放庫，請參閱容器存放庫和映射。如需容器實例 YAML 參考的詳細資訊，請參閱 YAML 參考：Azure 容器執行個體。

apiVersion: 2018-10-01
location: # < Valid location >
name: # < Container Group name >
properties:
  imageRegistryCredentials: # This is only required if you are pulling a non-public image that requires authentication to access. For example Text Analytics for health.
  - server: containerpreview.azurecr.io
    username: # < The username for the preview container registry >
    password: # < The password for the preview container registry >
  containers:
  - name: # < Container name >
    properties:
      image: # < Repository/Image name >
      environmentVariables: # These env vars are required
        - name: eula
          value: accept
        - name: billing
          value: # < Service specific Endpoint URL >
        - name: apikey
          value: # < Service specific API key >
      resources:
        requests:
          cpu: 4 # Always refer to recommended minimal resources
          memoryInGb: 8 # Always refer to recommended minimal resources
      ports:
        - port: 5000
  osType: Linux
  volumes: # This node, is only required for container instances that pull their model in at runtime, such as LUIS.
  - name: aci-file-share
    azureFile:
      shareName: # < File share name >
      storageAccountName: # < Storage account name>
      storageAccountKey: # < Storage account key >
  restartPolicy: OnFailure
  ipAddress:
    type: Public
    ports:
    - protocol: tcp
      port: 5000
tags: null
type: Microsoft.ContainerInstance/containerGroups

注意

並非所有位置都有相同的 CPU 和記憶體可用性。如需每個位置和 OS 容器可用資源的清單，請參閱位置和資源資料表。

我們將依賴我們為命令建立的 az container create YAML 檔案。從 Azure CLI 執行 az container create 命令，並將 <resource-group> 取代為您自己的命令。此外，若要保護 YAML 部署中的值，請參閱安全值。

az container create -g <resource-group> -f my-aci.yaml

當輸出變更為代表新建立 ACI 資源的 JSON 字串之後，命令的輸出會 Running... 是有效的。容器映射可能一段時間無法使用，但資源現在已部署。

提示

請密切注意公開預覽版中 Azure AI 服務的位置，因為需要據以調整 YAML 以符合該位置。

驗證容器是否正在執行

有數種方式可以驗證容器正在執行。 找出有問題的容器的外部 IP 位址和公開的埠，然後開啟您最愛的網頁瀏覽器。使用後續的各種要求 URL 來驗證容器正在執行中。此處列出的範例要求 URL 為 http://localhost:5000 ，但您的特定容器可能會有所不同。請務必依賴容器的外部 IP 位址和公開的埠。

要求 URL	目的
`http://localhost:5000/`	容器會提供首頁。
`http://localhost:5000/ready`	透過 GET 要求，此 URL 會提供容器已準備好接受模型查詢的驗證。此要求可用於 Kubernetes 活躍度和整備探查。
`http://localhost:5000/status`	此外，使用 GET 要求此 URL 會驗證用來啟動容器的 API 金鑰是否有效，而不會造成端點查詢。此要求可用於 Kubernetes 活躍度和整備探查。
`http://localhost:5000/swagger`	容器會為端點提供一組完整的文件和立即試用功能。透過這項功能，您可以將您的設定輸入網頁式 HTML 表單，然後進行查詢，而不需要撰寫任何程式碼。查詢傳回之後，會提供範例 CURL 命令來示範所需的 HTTP 標頭和主體格式。

Container's home page

下一步

檢閱安裝和執行容器以提取容器映射並執行容器
檢閱設定容器以進行組態設定
深入瞭解異常偵測程式 API 服務

將異常偵測程式單變數容器部署至Azure 容器執行個體

必要條件

建立異常偵測器資源

從 Azure CLI 建立 Azure 容器實例資源

驗證容器是否正在執行

下一步

其他資源