設定語音服務容器

文章
05/30/2024

語音容器可讓客戶建置最能同時利用健全雲端功能和邊緣位置的語音應用程式架構。

語音容器運行時間環境是使用 docker run 命令引數來設定。此容器有一些必要和選擇性的設定。容器專屬設定包括計費設定。

組態設定

此容器具有下列組態設定：

必要	設定	目的
Yes	ApiKey	追蹤計費資訊。
No	ApplicationInsights	可讓您將 Azure Application Insights 遙測支援新增至容器。
Yes	Billing	指定 Azure 上服務資源的端點 URI。
Yes	Eula	表示您已接受容器的授權。
No	Fluentd	將記錄和/或計量資料寫入 Fluentd 伺服器。
No	HTTP Proxy	設定 HTTP Proxy 以提出輸出要求。
No	Logging	提供適用於容器的 ASP.NET Core 記錄支援。
No	Mounts	在主機電腦和容器之間往來讀取和寫入資料。

重要

系統會同時使用 ApiKey、Billing 及 Eula 設定，且您必須同時為這三個設定提供有效的值，否則容器將不會啟動。如需使用這些組態設定來將容器具現化的詳細資訊，請參閱帳單。

ApiKey 組態設定

ApiKey 設定會指定用來追蹤容器帳單資訊的 Azure資源金鑰。您必須指定 ApiKey 的值，且此值必須是為 Billing 組態設定所指定的語音資源有效金鑰。

此設定可在下列位置找到：

Azure 入口網站：位於 [金鑰] 下的語音資源管理

ApplicationInsights 設定

ApplicationInsights 設定可讓您將 Azure Application Insights 遙測支援新增至容器。 Application Insights 可提供深入容器監視。您可輕鬆監視容器的可用性、效能和使用情形。您也可以快速識別並診斷容器中的錯誤。

下表說明 ApplicationInsights 區段下所支援的組態設定。

必要	名稱	資料類型	描述
No	`InstrumentationKey`	String	Application Insights 執行個體的檢測金鑰，容器的遙測資料會傳送到這裡。如需詳細資訊，請參閱 ASP.NET Core 的 Application Insights。範例： `InstrumentationKey=123456789`

Billing 組態設定

Billing 設定會指定 Azure 上用來計量容器帳單資訊的語音資源端點 URI。您必須為此組態設定指定值，且此值必須是 Azure 上語音資源的有效端點 URI。容器會每隔 10 到 15 分鐘回報使用量。

此設定可在下列位置找到：

Azure 入口網站：語音概觀頁面上標示的 Endpoint

必要	名稱	資料類型	描述
Yes	`Billing`	String	計費端點 URI。如需有關取得計費 URI 的詳細資訊，請參閱帳單。如需詳細資訊和完整的區域端點清單，請參閱 Azure AI 服務的自訂子網域名稱。

Eula 設定

Eula 設定可指出您已接受容器的授權。您必須為此組態設定指定值，且該值必須設定為 accept。

必要	名稱	資料類型	描述
Yes	`Eula`	String	接受授權範例： `Eula=accept`

Azure AI 服務容器是在您的合約 (控管您對於 Azure 的使用) 底下獲得授權。如果您沒有可控管您使用 Azure 的現有合約，您同意控管使用 Azure 的合約是 Microsoft 線上訂閱合約 (其中包含線上服務條款)。對於預覽版，您也同意 Microsoft Azure 預覽專用的補充使用條款。使用容器即表示您同意這些條款。

Fluentd 設定

Fluentd 是適用於統一記錄的開放原始碼資料收集器。 Fluentd 設定可管理容器對 Fluentd 伺服器的連線。容器包含 Fluentd 記錄提供者，可讓您的容器將記錄 (及選擇性的計量資料) 寫入至 Fluentd 伺服器。

下表說明 Fluentd 區段下所支援的組態設定。

名稱	資料類型	描述
`Host`	String	Fluentd 伺服器的 IP 位址或 DNS 主機名稱。
`Port`	整數	Fluentd 伺服器的連接埠。預設值為 24224。
`HeartbeatMs`	整數	活動訊號間隔，以毫秒為單位。如果在此間隔到期之前未傳送任何事件流量，系統便會將活動訊號傳送至 Fluentd 伺服器。預設值為 60000 毫秒 (1 分鐘)。
`SendBufferSize`	整數	針對傳送作業所配置的網路緩衝空間，以位元組為單位。預設值為 32768 個位元組 (32 KB)。
`TlsConnectionEstablishmentTimeoutMs`	整數	向 Fluentd 伺服器建立 SSL/TLS 連線的逾時，以毫秒為單位。預設值是 10000 毫秒 (10 秒)。如果將 `UseTLS` 設定為 false，便會忽略此值。
`UseTLS`	布林值	指出容器是否應使用 SSL/TLS 來與 Fluentd 伺服器通訊。預設值為 false。

HTTP Proxy 認證設定

如果您需要設定 HTTP Proxy 以進行輸出要求，請使用以下兩個引數：

名稱	資料類型	描述
HTTP_PROXY	string	要使用的 Proxy，例如 `http://proxy:8888` `<proxy-url>`
HTTP_PROXY_CREDS	string	對 Proxy 進行驗證所需的任何認證，例如 `username:password`。此值必須是小寫。
`<proxy-user>`	string	Proxy 的使用者。
`<proxy-password>`	string	對於 Proxy 與 `<proxy-user>` 相關聯的密碼。

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \

記錄設定

Logging 設定可管理適用於容器的 ASP.NET Core 記錄支援。對於您用於 ASP.NET Core 應用程式的容器，您可以使用相同的組態設定和值。

容器支援下列記錄提供者：

Provider	目的
主控台	ASP.NET Core `Console` 記錄提供者。支援此記錄提供者的所有 ASP.NET Core 組態設定和預設值。
偵錯	ASP.NET Core `Debug` 記錄提供者。支援此記錄提供者的所有 ASP.NET Core 組態設定和預設值。
磁碟	JSON 記錄提供者。此記錄提供者會將記錄資料寫入至輸出裝載。

此容器命令會以 JSON 格式，將記錄資訊儲存於輸出裝載中：

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output

此容器命令會在容器執行時顯示偵錯資訊 (前面加上 dbug)：

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug

磁碟記錄

Disk 記錄提供者支援下列組態設定：

名稱	資料類型	描述
`Format`	String	適用於記錄檔的輸出格式。注意：此值必須設定為 `json` 以啟用記錄提供者。如果在具現化期間指定此值，但沒有同時指定輸出裝載，便會發生錯誤。
`MaxFileSize`	整數	記錄檔的大小上限，以 MB 為單位。當目前記錄檔的大小符合或超過此值時，記錄提供者便會建立新的記錄檔。如果指定 -1，記錄檔的大小便只會受限於輸出裝載的檔案大小上限 (若有的話)。預設值是 1。

如需設定 ASP.NET Core 記錄支援的詳細資訊，請參閱設定檔案組態。

裝載設定

使用繫結裝載將資料讀取和寫入至容器，及從中讀取和寫入。您可以在 docker run 命令中指定 --mount 選項，以指定輸入裝載或輸出裝載。

標準語音容器不會使用輸入或輸出裝載來儲存訓練或服務資料。不過，自訂語音容器會依賴磁碟區裝載。

主機裝載位置的正確語法會隨著主機作業系統而有所不同。此外，主機電腦的掛接位置可能無法存取，因為 docker 服務帳戶所使用的權限與主機裝載位置權限之間發生衝突。

選擇性	名稱	資料類型	描述
不允許	`Input`	String	標準語音容器不使用此功能。自訂語音容器會使用磁碟區裝載。
選擇性	`Output`	String	輸出裝載的目標。預設值是 `/output`。這是記錄的位置。這包括容器記錄。範例： `--mount type=bind,src=c:\output,target=/output`

磁片區裝載設定

自訂語音容器會使用磁碟區裝載來保存自訂模型。您可以在 docker run 命令中新增 -v (或 --volume) 選項，以指定輸入磁碟區裝載。

注意

磁碟區裝載設定僅適用於自訂語音轉換文字容器。

第一次下載自訂模型時，新模型會內嵌為自訂語音容器 docker run 命令的一部分。自訂語音容器的相同 ModelId 循序執行會使用先前下載的模型。如果未提供磁碟區掛接，則無法保存自訂模型。

磁碟區裝載設定包含三個以彩色 : 分隔的欄位：

第一個欄位是主機電腦上的磁碟區名稱，例如 C:\input。
第二個欄位是容器中的目錄，例如 /usr/local/models。
第三個欄位 (選擇性) 是以逗號分隔的選項清單，如需詳細資訊，請參閱使用磁碟區。

以下為磁碟區裝載範例，示範將主機電腦的 C:\input 目錄裝載到容器的 /usr/local/models 目錄。

-v C:\input:/usr/local/models

下一步

檢閱如何安裝及執行容器

分享方式：