設定語言服務 Docker 容器
語言服務為每個容器提供了常見的設定架構，讓您可以輕鬆地設定及管理您容器的儲存體、記錄和遙測，以及安全性設定。 此文章適用於下列容器：
- 情感分析
- 語言偵測
- 關鍵片語擷取
- 健康情況的文字分析
- 摘要
- 具名實體辨識 (NER)
- 個人標識（PII） 偵測
組態設定
此容器具有下列組態設定：
| 必要 | 設定 | 目的 |
|---|---|---|
| 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 組態設定
ApiKey 設定會指定用來追蹤容器帳單資訊的 Azure資源金鑰。 您必須指定金鑰的值，該值必須是有效金鑰，且適用於為 Billing 組態設定所指定的語言資源。
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 分鐘回報使用量。
| 必要 | 名稱 | 資料類型 | 描述 |
|---|---|---|---|
| Yes | Billing |
String | 計費端點 URI。 |
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 |
下一步
- 使用更多 Azure AI 容器