Azure AI 容器的常見問題

一般問題

有哪些可用專案?

Azure AI 容器可讓開發人員使用 Azure 中可用的相同智慧型手機 API,但具有 容器化的優點 。 某些容器可作為閘道預覽,可能需要應用程式才能存取。 其他容器會公開提供為已解除鎖定的預覽,或已正式推出。 您可以在 Azure AI 服務中的容器支援一文中找到容器及其可用性的完整清單。 您也可以在 Microsoft Container Registry (MCR)檢視容器。

Azure AI 服務雲端和容器之間是否有任何差異?

Azure AI 容器是 Azure AI 服務雲端的替代方案。 容器提供與對應雲端服務相同的功能。 客戶可以在內部部署或 Azure 中部署容器。 容器與對應雲端服務之間的核心 AI 技術、定價層、API 金鑰和 API 簽章相同。 選擇容器與其雲端服務對等專案有一定 功能和優點

如何? 存取和使用閘道預覽容器?

先前,閘道預覽容器裝載於存放庫上 containerpreview.azurecr.io 。 自 2020 年 9 月 22 日起,這些容器會裝載在 Microsoft Container Registry 上。 下載它們不需要您使用 docker login 命令。 如果您的 Azure 資源是以核准的 Azure 訂用帳戶標識碼建立,您可以執行閘道預覽容器。 如果您的 Azure 訂用帳戶在完成要求表單之後尚未核准,您將無法執行容器。

容器是否適用於所有 Azure AI 服務供應專案,以及我應該預期的下一組容器?

我們想要讓更多 Azure AI 服務供應專案以容器的形式提供。 請連絡您的本機 Microsoft 帳戶管理員,以取得新容器版本和其他 Azure AI 服務公告的更新。

Azure AI 容器的服務等級協定 (SLA) 為何?

重要

若要深入瞭解 Azure AI 服務的服務等級協定, 請瀏覽我們的 SLA 頁面

Azure AI 為可在 SLA 頁面上檢視的雲端託管服務提供 SLA。

不過,容器中的 Azure AI 服務不會提供 SLA,因為它是內部部署軟體。 客戶可控制資源的 Azure AI 服務容器組態,因此 Microsoft 無法提供正式運作的 SLA。 客戶可以自由部署內部部署容器,並定義主機環境。

這些容器是否可在主權雲端中使用?

標準 Azure AI 容器可用於主權雲端。 容器可以在授權後執行並連線到這些雲端中的計費端點,但必須從公用雲端容器登錄提取容器映射。 依賴運行時間下載之語言模型的容器,例如 翻譯工具 或自定義語音轉換文字,也會設定為從公用端點提取模型。

主權雲端目前不支持購買已中斷連線的容器。 在公用雲端中購買的已中斷連線的容器,以及所有相依性都可以傳輸到主權雲端,並在主權雲端基礎結構上執行。

版本控制

容器如何更新為最新版本?

客戶可以選擇何時更新其部署的容器。 容器會標示為標準 Docker 標籤 ,例如 latest ,以指出最新版本。 我們鼓勵客戶在發行時提取最新版本的容器。 如需有關如何在映像更新時收到通知的詳細資訊,請參閱 Azure Container Registry Webhook

容器授權檔案是用於解密每個容器映像內特定檔案的金鑰。 如果這些加密檔案的更新發生在新的容器映像內,則您擁有的授權檔案可能無法啟動容器,即使它適用於以前版本的容器映像。 若要避免此問題,建議您從 mcr.microsoft.com 提取新映像版本之後,再從 Azure 入口網站中所提供的容器資源端點下載新的授權檔案。

若要下載新的授權檔案,您可以將 DownloadLicense=True 以及授權掛接、API 金鑰和計費端點一起新增至 Docker 執行命令。 如需詳細指示,請參閱容器的文件

支援哪些版本?

一般而言,只支援目前版本的容器。 我們鼓勵客戶保持最新狀態,以取得最新的修補程式和技術。

更新如何設定版本?

主要版本變更表示 API 簽章有重大變更。 我們預期此指示通常會與對應 Azure AI 服務雲端供應專案的主要版本變更一致。 次要版本變更表示錯誤修正、模型更新,或不會對 API 簽章進行重大變更的新功能。

技術問題

如何診斷部署環境中的潛在錯誤?

如果您在執行 Azure AI 服務容器時遇到問題,可以嘗試使用 Microsoft 診斷容器。 您可以使用此容器來診斷部署環境中的常見錯誤,這些錯誤可能會導致 Azure AI 容器無法如預期般運作。

若要取得容器,請使用下列 docker pull 命令:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

然後執行容器。 {ENDPOINT_URI}取代為您的端點,並將 取代{API_KEY}為您的資源金鑰:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

容器會測試與計費端點的網路連線。

如何在IoT裝置上執行 Azure AI 容器?

無論您沒有可靠的因特網連線,您想要節省頻寬成本、低延遲需求,或處理需要現場分析的敏感數據, Azure IoT Edge 與 Azure AI 容器 可讓您與雲端保持一致。

這些容器是否與 OpenShift 相容?

我們不會使用 OpenShift 測試容器,但一般而言,Azure AI 容器應該在任何支援 Docker 映射的平台上執行。 如果您使用 OpenShift,建議您以 身分 root-user執行容器。

如何? 提供產品意見反應和功能建議?

我們鼓勵客戶 公開表達他們的擔憂 ,並投票支援那些在潛在問題重疊的情況下進行相同動作的其他人。 您可以針對產品意見反應和功能建議使用意見反應工具。

Azure AI 容器會傳回哪些狀態消息和錯誤?

以下是狀態訊息與錯誤:

狀態 描述
Valid 您的 API 金鑰有效。 不需要採取任何動作。
Invalid 您的 API 金鑰無效。 您必須提供有效的 API 金鑰,才能執行容器。 在 azure AI 服務資源的 [金鑰和端點] 區段中,在 [Azure 入口網站] 中找到您的 API 金鑰和服務區域。
Mismatch 您已為不同類型的 Azure AI 服務資源提供 API 金鑰或端點。 在 Azure AI 服務資源的 [金鑰和端點] 區段中,於 Azure 入口網站 中找到您的 API 金鑰和服務區域。
CouldNotConnect 容器無法連線到計費端點。 Retry-After請檢查值,並等候此期間結束,再提出更多要求。
OutOfQuota API 金鑰已超過配額。 您可以升級定價層,或等候更多配額可供使用。 在 Azure AI 服務資源的 [定價層] 區段中,在 [Azure 入口網站] 中找到您的階層。
BillingEndpointBusy 計費端點目前忙碌中。 Retry-After請檢查值,並等候此期間結束,再提出更多要求。
ContainerUseUnauthorized 提供的 API 金鑰未獲授權來搭配此容器使用。 您可能使用閘道容器,因此請提交 在線要求,確定您的 Azure 訂用帳戶標識碼已獲得核准。
[ERROR] Failed to download: context deadline exceeded 模型檔案將要求下載到我們的伺服器逾時。請確定您有強式因特網連線,可在一小時內下載所有必要的檔案。 模型下載適用於文字翻譯和一些語音服務容器。
The provided license path was not found. Please ensure a volume is mounted and a directory exists at the location specified by Mounts:License 僅中斷連線的容器。 Docker run 命令中指定的位置沒有儲存在本機的授權檔案。 您可能已錯誤地掛接授權磁碟區。 請務必檢查本機文件系統,並使用 docker run 命令中的 -v 自變數,為授權檔案提供所需的本機儲存位置有效的檔案路徑。
Unknown 伺服器目前無法處理計費要求。

我該如何取得支援?

客戶支援通道與 Azure AI 服務雲端式 API 相同。 所有 Azure AI 容器都包含可協助我們和社群支援客戶的記錄功能。 以下是更多支援的選項:

帳單如何運作?

客戶會根據使用量收費,類似於 Azure AI 服務雲端。 容器必須設定為將計量數據傳送至 Azure,並據以計費交易。 跨託管和內部部署服務所使用的資源會新增至具有階層式定價的單一配額,並計入這兩個使用量。 如需詳細資訊,請參閱您正在使用之 容器 的計費一節。

重要

Azure AI 容器 在未連線到 Azure 以進行計量的情況下,不會獲 授權執行。 客戶必須讓容器能夠一律與計量服務通訊帳單資訊。 Azure AI 容器不會將客戶數據傳送給 Microsoft。

以下是容器用於計量的資訊範例:

usageRequestBody": {
  "id": "1234abcd-1234-56ab-ab12-1234abcd",
  "containerType": "<container-type>",
  "containerVersion": "<container-version>",
  "containerId": "<contianer-id>",
  "meter": {
    "name": "<meter-name>",
    "quantity": 0.0
  },
  "requestTime": 12345687890,
  "apiType": "<api-type>"
},

容器目前的支持擔保為何?

Microsoft 企業軟體的標準保固適用於正式宣佈為正式推出的所有容器(GA)。 預覽版沒有瑕疵擔保。

當因特網連線中斷時,Azure AI 容器會發生什麼事?

Azure AI 容器 在未連線到 Azure 以進行計量的情況下,不會獲 授權執行。 客戶必須讓容器一律與計量服務通訊。

容器可以在不連線到 Azure 的情況下運作多久?

Azure AI 容器 在未連線到 Azure 以進行計量的情況下,不會獲 授權執行。 客戶必須讓容器一律與計量服務通訊。

執行這些容器所需的硬體為何?

Azure AI 容器是以 x64 為基礎的容器,可執行支援 x64 Linux Docker 容器的任何相容 Linux 節點、VM 和邊緣裝置。 它們全都需要CPU處理器。 如需詳細資訊,請參閱您正在使用之 容器的容器 需求和建議一節。

Windows 目前是否支持這些容器?

Azure AI 容器是Linux容器,但 Windows 上有一些Linux容器支援。 如需 Windows 上 Linux 容器的詳細資訊,請參閱 Docker 檔

Azure AI 容器如何與 AWS 和 Google 供應項目進行比較?

Microsoft 是第一個在容器中移動預先定型 AI 模型的雲端提供者,其每個交易的計費方式很簡單,就好像客戶使用雲端服務一樣。 Microsoft 認為混合式雲端可讓客戶選擇更多。

容器有哪些合規性認證?

Azure AI 容器沒有任何合規性認證。

Azure AI 容器有哪些區域可供使用?

容器可以在任何區域中的任何位置執行,但需要密鑰,而且需要回呼 Azure 以進行計量。 容器計量呼叫支援雲端服務的所有支持區域。