Translator Docker 컨테이너 구성

Azure AI 서비스는 각 컨테이너에 공통 구성 프레임워크를 제공합니다. Translator 컨테이너를 쉽게 구성하고, 강력한 클라우드 기능 및 에지 위치에 맞게 최적화된 Translator 애플리케이션 아키텍처를 빌드할 수 있습니다.

Translator 컨테이너 런타임 환경은 docker run 명령 인수를 사용하여 구성됩니다. 이 컨테이너에는 필수 설정과 선택 사항 설정이 모두 있습니다. 필수 컨테이너별 설정은 청구 설정입니다.

구성 설정

컨테이너에는 다음 구성 설정이 있습니다.

ApiKey 구성 설정

ApiKey 설정은 컨테이너에 대한 청구 정보를 추적하는 데 사용되는 Azure 리소스 키를 지정합니다. ApiKey에 대한 값을 지정해야 하며 이 값은 Billing 구성 설정에 대해 지정된 Translator 리소스에 대한 유효한 키여야 합니다.

이 설정은 다음 위치에서 찾을 수 있습니다.

• Azure Portal: 키 아래의 Translator 리소스 관리

ApplicationInsights 설정

ApplicationInsights 설정으로 Azure Application Insights 원격 분석 지원을 컨테이너에 추가할 수 있습니다. Application Insights는 컨테이너의 심층 모니터링을 제공합니다. 컨테이너의 가용성, 성능 및 사용량을 쉽게 모니터링할 수 있습니다. 또한 컨테이너의 오류를 빠르게 식별하고 진단할 수 있습니다.

다음 표에서는 ApplicationInsights 섹션에서 지원되는 구성 설정을 설명합니다.

청구 구성 설정

Billing 설정은 컨테이너에 대한 청구 정보를 측정하는 데 사용되는 Azure의 Translator 리소스에 대한 엔드포인트 URI를 지정합니다. 이 구성 설정에 대한 값을 지정해야 하며, 이 값은 Azure의 Translator 리소스에 대한 유효한 엔드포인트 URI여야 합니다. 컨테이너는 약 10 ~ 15분마다 사용량을 보고합니다.

이 설정은 다음 위치에서 찾을 수 있습니다.

• Azure Portal: Translator 개요 페이지, 레이블이 지정된 Endpoint

EULA 설정

Eula 설정은 컨테이너에 대한 라이선스에 동의했음을 나타냅니다. 이 구성 설정에 대한 값을 지정해야 하며, 이 값은 accept로 설정해야 합니다.

Azure AI 서비스 컨테이너는 Azure 사용에 관한 계약에 따라 라이선스가 부여됩니다. Azure 사용에 관한 기존 계약이 없으면 Azure 사용에 관한 계약은 온라인 서비스 사용 약관을 포함한 Microsoft 온라인 정기가입 계약임에 동의합니다. 미리 보기의 경우 Microsoft Azure 미리 보기에 대한 추가 사용 약관에도 동의합니다. 컨테이너를 사용하여 이 사용 약관에 동의합니다.

Fluentd 설정

Fluentd는 통합된 로깅에 대한 오픈 소스 데이터 수집기입니다. Fluentd 설정은 Fluentd 서버에 컨테이너의 연결을 관리합니다. 컨테이너에는 Fluentd 로깅 공급자가 포함되어 있어 컨테이너에서 로그 및 메트릭 데이터(선택 사항)를 Fluentd 서버에 쓸 수 있습니다.

다음 표에서는 Fluentd 섹션에서 지원되는 구성 설정을 설명합니다.

HTTP/HTTPS 프록시 자격 증명 설정

아웃바운드 요청을 만들기 위한 HTTP 프록시를 구성해야 하는 경우 다음 두 인수를 사용합니다.

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 로깅 지원을 관리합니다. ASP.NET Core 애플리케이션에 사용하는 컨테이너에 대한 동일한 구성 설정 및 값을 사용할 수 있습니다.

• Logging.LogLevel은 기록할 최소 수준을 지정합니다. LogLevel의 심각도 범위는 0~6입니다. LogLevel이 지정되면 지정된 수준 이상의 메시지에 대해 로깅이 사용하도록 설정됩니다. 추적 = 0, 디버그 = 1, 정보 = 2, 경고 = 3, 오류 = 4, 위험 = 5, 없음 = 6.

• 현재 Translator 컨테이너에는 경고 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 로깅 공급자는 다음과 같은 구성 설정을 지원합니다.

디스크 공급자 예

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 실행 명령의 --mount옵션을 지정하여 입력 탑재 또는 출력 탑재를 지정할 수 있습니다.

다음 단계