設定翻譯工具 Docker 容器
Azure AI 服務會為每個容器提供一個通用的設定架構。 您可以輕鬆設定翻譯工具容器來建置翻譯工具應用程式結構，以最佳化穩固的雲端功能和邊緣位置。
翻譯工具容器執行階段環境可使用 docker run 命令引數來設定。 此容器同時具有必要和選擇性的設定。 需要的容器專屬設定包括計費設定。
組態設定
此容器具有下列組態設定：
| 必要 | 設定 | 目的 |
|---|---|---|
| Yes | ApiKey | 追蹤計費資訊。 |
| No | ApplicationInsights | 可讓您將 Azure Application Insights 遙測支援新增至容器。 |
| Yes | Billing | 指定 Azure 上服務資源的端點 URI。 |
| Yes | EULA | 表示您已接受容器的使用者授權合約 (EULA)。 |
| No | Fluentd | 將記錄和/或計量資料寫入 Fluentd 伺服器。 |
| No | HTTP Proxy | 設定 HTTP Proxy 以提出輸出要求。 |
| No | Logging | 提供適用於容器的 ASP.NET Core 記錄支援。 |
| Yes | Mounts | 在主機電腦和容器之間往來讀取和寫入資料。 |
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/HTTPS Proxy 認證設定
如果您需要設定 HTTP Proxy 以進行輸出要求，請使用以下兩個引數：
| 名稱 | 資料類型 | 描述 |
|---|---|---|
| HTTPS_PROXY | 字串 | Proxy URL，例如 https://proxy:8888 |
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> \
HTTPS_PROXY=<proxy-url>
記錄設定
翻譯工具容器支援下列記錄提供者：
| Provider | 目的 |
|---|---|
| 主控台 | ASP.NET Core Console 記錄提供者。 支援此記錄提供者的所有 ASP.NET Core 組態設定和預設值。 |
| 偵錯 | ASP.NET Core Debug 記錄提供者。 支援此記錄提供者的所有 ASP.NET Core 組態設定和預設值。 |
| 磁碟 | JSON 記錄提供者。 此記錄提供者會將記錄資料寫入至輸出裝載。 |
Logging設定可管理適用於容器的 ASP.NET Core 記錄支援。 對於您用於 ASP.NET Core 應用程式的容器，您可以使用相同的組態設定和值。Logging.LogLevel會指定要記錄的最小層級。LogLevel的嚴重性範圍從 0 到 6。 指定LogLevel時，會針對指定層級和更高層級的訊息啟用記錄：追蹤 = 0、偵錯 = 1、資訊 = 2、警告 = 3、錯誤 = 4、危急 = 5、無 = 6。目前，翻譯工具容器能夠將記錄限制在警告 LogLevel 或更高層級。
記錄的一般命令語法如下：
-Logging:LogLevel:{Provider}={FilterSpecs}
下列命令會啟動 Docker 容器，並將 LogLevel 設為警告，以及將記錄提供者設為主控台。 這個指令會在應用程式流程期間將異常或非預期的事件列印至主控台：
docker run --rm -it -p 5000:5000
-v /mnt/d/TranslatorContainer:/usr/local/models \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru \
-e Logging:LogLevel:Console="Warning"
mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest
磁碟記錄
Disk 記錄提供者支援下列組態設定：
| 名稱 | 資料類型 | 描述 |
|---|---|---|
Format |
String | 適用於記錄檔的輸出格式。 注意：此值必須設定為 json 以啟用記錄提供者。 如果在具現化期間指定此值，但沒有同時指定輸出裝載，便會發生錯誤。 |
MaxFileSize |
整數 | 記錄檔的大小上限，以 MB 為單位。 當目前記錄檔案的大小達到或超過此值時，記錄提供者會啟動新的記錄檔。 如果指定 -1，記錄檔的大小便只會受限於輸出裝載的檔案大小上限 (若有的話)。 預設值是 1。 |
磁碟提供者範例
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type-bind,src=/home/azureuser/output,target=/output \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
如需設定 ASP.NET Core 記錄支援的詳細資訊，請參閱設定檔案組態。
裝載設定
使用繫結裝載將資料讀取和寫入至容器，及從中讀取和寫入。 您可以在 docker run 命令中指定 --mount 選項，以指定輸入裝載或輸出裝載。