Translator Docker コンテナーを構成する

Azure AI サービスには、各コンテナーに共通の構成フレームワークが用意されています。 堅牢なクラウド機能とエッジ ローカリティのために最適化された Translator アプリケーション アーキテクチャを構築するために、Translator コンテナーを構成することは簡単にできます。

Translator コンテナーのランタイム環境は、docker run コマンドの引数を使用して構成されます。 このコンテナーには、必須の設定と省略可能な設定の両方があります。 このコンテナー固有の必須の設定は、課金設定です。

構成設定

このコンテナーには、次の構成設定があります。

必須	設定	目的
はい	ApiKey	課金情報を追跡します。
いいえ	ApplicationInsights	コンテナーに Azure Application Insights テレメトリ サポートを追加できるようにします。
はい	Billing	Azure 上のサービス リソースのエンドポイント URI を指定します。
はい	EULA	お客様がコンテナーのエンドユーザー ライセンス契約 (EULA) に同意したことを示します。
いいえ	Fluentd	ログと (必要に応じて) メトリック データを Fluentd サーバーに書き込みます。
いいえ	HTTP Proxy	送信要求を行うために、HTTP プロキシを構成します。
いいえ	Logging	ASP.NET Core のログ サポートをお客様のコンテナーに提供します。
Yes	Mounts	ホスト コンピューターからコンテナーに、またコンテナーからホスト コンピューターにデータを読み取ったり書き込んだりします。

重要

ApiKey、Billing、EULA の各設定は一緒に使用されるため、それらの 3 つすべてに有効な値を指定する必要があります。そうしないと、お客様のコンテナーは起動しません。 これらの構成設定を使用してコンテナーをインスタンス化する方法の詳細については、ご確認ください。

ApiKey 構成設定

ApiKey 設定では、コンテナーの課金情報を追跡するために使用される Azure リソース キーを指定します。 ApiKey の値を指定する必要があります。また、その値は、Billing 構成設定に指定された Translator リソースの有効なキーであることが必要です。

この設定は次の場所で確認できます。

• Azure portal: Translator の [リソース管理] の [キー] の下

ApplicationInsights 設定

ApplicationInsights 設定を使用すると、Azure Application Insights テレメトリのサポートをお客様のコンテナーに追加できます。 Application Insights によってお客様のコンテナーを詳細に監視できます。 コンテナーの可用性、パフォーマンス、利用状況を簡単に監視できます。 さらに、お客様のコンテナーのエラーを迅速に特定して診断することもできます。

次の表に、ApplicationInsights セクションでサポートされている構成設定について説明します。

必須	名前	データの種類	説明
いいえ	InstrumentationKey	String	コンテナーのテレメトリ データの送信先の Application Insights インスタンスのインストルメンテーション キー。 詳細については、「Application Insights for ASP.NET Core」を参照してください。 例: InstrumentationKey=123456789

Billing 構成設定

Billing 設定では、コンテナーの課金情報を測定するために使用される Azure の Translator リソースのエンドポイント URI を指定します。 この構成設定の値を指定する必要があり、値は Azure の Translator リソースの有効なエンドポイント URI である必要があります。 コンテナーから、約 10 ～ 15 分ごとに使用状況が報告されます。

この設定は次の場所で確認できます。

• Azure portal: Endpoint というラベルの翻訳の [概要] ページ

必須	名前	データの種類	Description
イエス	Billing	String	課金エンドポイント URI。 課金 URI の取得の詳細については、「必須パラメーターの収集」を参照してください。 リージョンのエンドポイントの詳細および完全な一覧については、「Azure AI サービスのカスタム サブドメイン名」 を参照してください。

EULA の設定

Eula 設定は、コンテナーのライセンスに同意済みであることを示します。 この構成設定の値を指定する必要があり、値を accept に設定する必要があります。

必須	名前	データの種類	Description
イエス	Eula	String	ライセンスへの同意 例: Eula=accept

Azure AI サービス コンテナーは、Azure の使用について定める契約の下でライセンスされます。 Azure の使用について定める契約をまだ結んでいない場合、Azure の使用について定める契約がマイクロソフト オンライン サブスクリプション契約 (オンライン サービス規約を含む) であることに同意するものとします。 また、プレビューに関しては、「Microsoft Azure プレビューの追加使用条件」にも同意するものとします。 コンテナーの使用をもって、お客様はこれらの規約に同意したものとします。

Fluentd の設定

Fluentd は、ログの一元管理を実現するオープンソースのデータ コレクターです。 Fluentd サーバーに対するコンテナーの接続は、Fluentd の設定によって管理されます。 コンテナーには、お客様のコンテナーでログ、および必要に応じてメトリック データを Fluentd サーバーに書き込むことができる Fluentd ログ プロバイダーが含まれます。

次の表に、Fluentd セクションでサポートされている構成設定について説明します。

名前	データの種類	Description
Host	String	Fluentd サーバーの IP アドレスまたは DNS ホスト名。
Port	Integer	Fluentd サーバーのポート。 既定値は 24224 です。
HeartbeatMs	Integer	ハートビート間隔 (ミリ秒)。 この間隔が期限切れになるまでにイベント トラフィックが送信されなかった場合、ハートビートが Fluentd サーバーに送信されます。 既定値は、60000 ミリ秒 (1 分) です。
SendBufferSize	Integer	送信操作用に割り当てられたネットワーク バッファー領域 (バイト数)。 既定値は、32,768 バイト (32 キロバイト) です。
TlsConnectionEstablishmentTimeoutMs	Integer	Fluentd サーバーとの SSL または TLS 接続を確立するためのタイムアウト (ミリ秒)。 既定値は、10000 ミリ秒 (10 秒) です。 UseTLS が false に設定されている場合、この値は無視されます。
UseTLS	ブール型	コンテナーで、Fluentd サーバーとの通信に SSL または TLS を使用する必要があるかどうかを示します。 既定値は false です。

HTTP/HTTPS プロキシ資格情報設定

送信要求を行うために HTTP プロキシを構成する必要がある場合は、次の 2 つの引数を使用します。

Name	データの種類	説明
HTTPS_PROXY	string	プロキシ 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>

Logging の設定

翻訳コンテナーでは、次のログ プロバイダーがサポートされています。

プロバイダー	目的
コンソール	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}

次のコマンドを実行すると、LogLevel が警告に設定され、ログ プロバイダーがコンソールに設定された状態で Docker コンテナーが起動されます。 このコマンドを実行すると、アプリケーション フロー中の異常または予期しないイベントがコンソールに出力されます。

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 ログ

Disk ログ プロバイダーでは、次の構成設定がサポートされます。

名前	データの種類	Description
Format	String	ログ ファイルの出力形式。 注: ログ プロバイダーを有効にするためにこの値を json に設定する必要があります。 コンテナーのインスタンス化中に、出力マウントを指定せずに、この値を指定した場合、エラーが発生します。
MaxFileSize	Integer	ログ ファイルの最大サイズ (メガバイト (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 オプションを指定することによって指定できます。

次のステップ

Azure AI コンテナーの詳細情報