Настройка контейнеров Docker API анализа текстаConfigure Text Analytics docker containers

Анализ текста предоставляет контейнер с общей платформой конфигурации, что позволяет легко настроить хранилище, ведение журнала, данные телеметрии и параметры безопасности для контейнеров, а также управлять ими.Text Analytics provides each container with a common configuration framework, so that you can easily configure and manage storage, logging and telemetry, and security settings for your containers.

Параметры конфигурацииConfiguration settings

К контейнеру применяются следующие параметры конфигурации:The container has the following configuration settings:

Обязательно для заполненияRequired ПараметрSetting ЦельPurpose
ДаYes ApiKeyApiKey Отслеживает данные для выставления счетов.Tracks billing information.
НетNo ApplicationInsightsApplicationInsights Позволяет добавить в контейнер поддержку телеметрии Azure Application Insights.Enables adding Azure Application Insights telemetry support to your container.
ДаYes Выставление счетовBilling Задает URI конечной точки для ресурса службы в Azure.Specifies the endpoint URI of the service resource on Azure.
ДаYes Лицензионное соглашениеEula Указывает, что вы приняли условия лицензии для контейнера.Indicates that you've accepted the license for the container.
НетNo FluentdFluentd Записывает данные в журнал и при необходимости передает метрики на сервер Fluentd.Writes log and, optionally, metric data to a Fluentd server.
НетNo Прокси-сервер HTTPHttp Proxy Настраивает прокси-сервер HTTP для исходящих запросов.Configures an HTTP proxy for making outbound requests.
НетNo LoggingLogging Обеспечивает поддержку ведения журнала ASP.NET Core для вашего контейнера.Provides ASP.NET Core logging support for your container.
НетNo ПодключенияMounts Считывает и записывает данные с главного компьютера в контейнер и обратно.Reads and writes data from the host computer to the container and from the container back to the host computer.

Важно!

Параметры ApiKey, Billing и Eula используются совместно, и для всех трех параметров необходимо указать допустимые значения. В противном случае контейнер не запустится.The ApiKey, Billing, and Eula settings are used together, and you must provide valid values for all three of them; otherwise your container won't start. Дополнительные сведения об использовании этих параметров конфигурации для создания экземпляра контейнера см. в разделе Выставление счетов.For more information about using these configuration settings to instantiate a container, see Billing.

Параметр конфигурации ApiKeyApiKey configuration setting

Параметр ApiKey определяет ключ ресурса Azure, который используется для отслеживания данных для выставления счетов для контейнера.The ApiKey setting specifies the Azure resource key used to track billing information for the container. Значение ApiKey является обязательным и должно содержать допустимый ключ ресурса службы Анализ текста, который определяется в параметре конфигурации Billing.You must specify a value for the ApiKey and the value must be a valid key for the Text Analytics resource specified for the Billing configuration setting.

Этот параметр можно найти в следующем месте.This setting can be found in the following place:

  • Портал Azure: Анализ текста управление ресурсами в разделе ключиAzure portal: Text Analytics resource management, under Keys

Параметр ApplicationInsights.ApplicationInsights setting

Параметр ApplicationInsights позволяет добавить в контейнер поддержку телеметрии Azure Application Insights.The ApplicationInsights setting allows you to add Azure Application Insights telemetry support to your container. Служба Application Insights обеспечивает детализированный мониторинг контейнера.Application Insights provides in-depth monitoring of your container. Вы можете легко отслеживать доступность, производительность и использование своего контейнера.You can easily monitor your container for availability, performance, and usage. Вы также можете быстро идентифицировать и диагностировать ошибки в контейнере.You can also quickly identify and diagnose errors in your container.

В следующей таблице описаны параметры конфигурации, поддерживаемые в разделе ApplicationInsights.The following table describes the configuration settings supported under the ApplicationInsights section.

Обязательно для заполненияRequired ИМЯName Тип данныхData type ОписаниеDescription
НетNo InstrumentationKey Строка,String Ключ инструментирования экземпляра Application Insights, которому отправляются данные телеметрии для контейнера.The instrumentation key of the Application Insights instance to which telemetry data for the container is sent. Дополнительные сведения см. в статье Application Insights для ASP.NET Core.For more information, see Application Insights for ASP.NET Core.

Пример:Example:
InstrumentationKey=123456789

Параметр конфигурации выставления счетовBilling configuration setting

Параметр Billing определяет URI конечной точки ресурса Анализа текста на Azure, используемый, чтобы измерять данные для выставления счетов для контейнера.The Billing setting specifies the endpoint URI of the Text Analytics resource on Azure used to meter billing information for the container. Для этого параметра конфигурации необходимо задать значение, которое должно быть допустимым URI конечной точки для ресурса Анализа текста в Azure.You must specify a value for this configuration setting, and the value must be a valid endpoint URI for a _Text Analytics resource on Azure. Отчеты об использовании контейнера примерно каждые 10—15 минут.The container reports usage about every 10 to 15 minutes.

Этот параметр можно найти в следующем месте.This setting can be found in the following place:

  • Портал Azure: Анализ текста Общие сведения, помеченныеEndpointAzure portal: Text Analytics Overview, labeled Endpoint
Обязательное значениеRequired НазваниеName Тип данныхData type ОписаниеDescription
ДаYes Billing СтроковоеString Требуемый URI конечной точки выставления счетовThe required billing endpoint URI

Параметр EulaEula setting

Параметр Eula указывает, что вы приняли условия лицензии для контейнера.The Eula setting indicates that you've accepted the license for the container. Для этого параметра конфигурации необходимо указать значение accept.You must specify a value for this configuration setting, and the value must be set to accept.

Обязательно для заполненияRequired ИМЯName Тип данныхData type ОписаниеDescription
ДаYes Eula Строка,String Принятие условий лицензионного соглашенияLicense acceptance

Пример:Example:
Eula=accept

Лицензия на использование контейнеров Cognitive Services предоставляется в рамках вашего соглашения об использовании Azure.Cognitive Services containers are licensed under your agreement governing your use of Azure. Если вы не заключали соглашение, регламентирующее использование Azure, вы подтверждаете, что ваше соглашение об использовании Azure является соглашением Microsoft Online Subscription, которое содержит условия использования веб-служб.If you do not have an existing agreement governing your use of Azure, you agree that your agreement governing use of Azure is the Microsoft Online Subscription Agreement, which incorporates the Online Services Terms. Что касается предварительных версий, вы также принимаете Дополнительные условия использования предварительных версий Microsoft Azure.For previews, you also agree to the Supplemental Terms of Use for Microsoft Azure Previews. Факт использования вами контейнера подтверждает ваше согласие с этими условиями.By using the container you agree to these terms.

Параметры FluentdFluentd settings

Fluentd — это сборщик данных с открытым кодом для унифицированного ведения журнала.Fluentd is an open-source data collector for unified logging. Параметры Fluentd управляют подключением контейнера к серверу Fluentd.The Fluentd settings manage the container's connection to a Fluentd server. В состав контейнера входит поставщик ведения журнала Fluentd, который позволяет контейнеру записывать данные журналов и (необязательно) данные метрик на сервер Fluentd.The container includes a Fluentd logging provider, which allows your container to write logs and, optionally, metric data to a Fluentd server.

В следующей таблице описаны параметры конфигурации, поддерживаемые в разделе Fluentd.The following table describes the configuration settings supported under the Fluentd section.

ИМЯName Тип данныхData type ОписаниеDescription
Host Строка,String IP-адрес или имя узла DNS сервера Fluentd.The IP address or DNS host name of the Fluentd server.
Port Целое числоInteger Порт сервера Fluentd.The port of the Fluentd server.
Значение по умолчанию — 24224.The default value is 24224.
HeartbeatMs Целое числоInteger Интервал пульса в миллисекундах.The heartbeat interval, in milliseconds. Если до окончания этого интервала не отправлялся никакой трафик событий, пульс отправляется на сервер Fluentd.If no event traffic has been sent before this interval expires, a heartbeat is sent to the Fluentd server. Значение по умолчанию — 60 000 миллисекунд (1 минута).The default value is 60000 milliseconds (1 minute).
SendBufferSize Целое числоInteger Место в сетевом буфере (в байтах), выделенное для операций отправки.The network buffer space, in bytes, allocated for send operations. Значение по умолчанию — 32768 байт (32 килобайта).The default value is 32768 bytes (32 kilobytes).
TlsConnectionEstablishmentTimeoutMs Целое числоInteger Время ожидания (в миллисекундах) до установки соединения по протоколу SSL/TLS с сервером Fluentd.The timeout, in milliseconds, to establish a SSL/TLS connection with the Fluentd server. Значение по умолчанию — 10 000 миллисекунд (10 секунд).The default value is 10000 milliseconds (10 seconds).
Если для параметра UseTLS задано значение false, то это значение игнорируется.If UseTLS is set to false, this value is ignored.
UseTLS ЛогическоеBoolean Указывает, должен ли контейнер использовать протокол SSL/TLS для связи с сервером Fluentd.Indicates whether the container should use SSL/TLS for communicating with the Fluentd server. По умолчанию для этого параметра используется значение false.The default value is false.

Параметры учетных данных прокси-сервера HTTPHttp proxy credentials settings

Чтобы настроить прокси-сервер HTTP для исходящих запросов, используйте следующие два аргумента.If you need to configure an HTTP proxy for making outbound requests, use these two arguments:

ИмяName Тип данныхData type ОписаниеDescription
HTTP_PROXYHTTP_PROXY строкаstring Используемый прокси-сервер, например http://proxy:8888.The proxy to use, for example, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDSHTTP_PROXY_CREDS строкаstring Любые учетные данные, необходимые для выполнения аутентификации на прокси-сервере, например username:password.Any credentials needed to authenticate against the proxy, for example, username:password.
<proxy-user> строкаstring Пользователь прокси-сервера.The user for the proxy.
<proxy-password> строкаstring Пароль, связанный с параметром <proxy-user> прокси-сервера.The password associated with <proxy-user> for the proxy.
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 settings

Параметры Logging управляют поддержкой ведения журнала ASP.NET Core для контейнера.The Logging settings manage ASP.NET Core logging support for your container. Вы можете использовать для контейнера те же параметры конфигурации и значения, что и для приложения ASP.NET Core.You can use the same configuration settings and values for your container that you use for an ASP.NET Core application.

Контейнер поддерживает указанных ниже поставщиков ведения журналов.The following logging providers are supported by the container:

ПоставщикProvider ЦельPurpose
ConsoleConsole Поставщик ведения журнала Console для ASP.NET Core.The ASP.NET Core Console logging provider. Для этого поставщика ведения журнала поддерживаются все параметры конфигурации ASP.NET Core и значения по умолчанию.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
ОтладкаDebug Поставщик ведения журнала Debug для ASP.NET Core.The ASP.NET Core Debug logging provider. Для этого поставщика ведения журнала поддерживаются все параметры конфигурации ASP.NET Core и значения по умолчанию.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
ДискDisk Поставщик ведения журнала JSON.The JSON logging provider. Поставщик ведения журнала записывает данные журнала в выходное подключение.This logging provider writes log data to the output mount.

В этой команде для контейнера хранятся сведения о ведении журнала в формате JSON для выходного подключения:This container command stores logging information in the JSON format to the output mount:

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

Во время выполнения контейнера в этой команде для контейнера отображается отладочная информация с префиксом dbug:This container command shows debugging information, prefixed with dbug, while the container is running:

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 logging

Поставщик ведения журнала Disk поддерживает перечисленные ниже параметры конфигурации:The Disk logging provider supports the following configuration settings:

ИмяName Тип данныхData type ОписаниеDescription
Format Строка,String Выходной формат файлов журналов.The output format for log files.
Примечание. Чтобы включить регистратор, необходимо указать значение json.Note: This value must be set to json to enable the logging provider. Если это значение задано без указания выходного подключения, при создании экземпляра контейнера возникает ошибка.If this value is specified without also specifying an output mount while instantiating a container, an error occurs.
MaxFileSize Целое числоInteger Максимальный размер файла журнала в мегабайтах (МБ).The maximum size, in megabytes (MB), of a log file. Когда размер текущего файла журнала достигает этого значения или превышает его, поставщик ведения журнала создает файл журнала.When the size of the current log file meets or exceeds this value, a new log file is started by the logging provider. Если задано значение –1, то размер файла журнала ограничивается только максимальным размером файла (если он задан) для выходного подключения.If -1 is specified, the size of the log file is limited only by the maximum file size, if any, for the output mount. Значение по умолчанию — 1.The default value is 1.

Дополнительные сведения о настройке поддержки ведения журналов для ASP.NET Core см. в разделе Настройка файла параметров.For more information about configuring ASP.NET Core logging support, see Settings file configuration.

Параметры подключенияMount settings

Используйте подключения привязок для чтения данных из контейнера и записи в него.Use bind mounts to read and write data to and from the container. Вы можете указать входное или выходное подключение, указав параметр --mount в команде docker run.You can specify an input mount or output mount by specifying the --mount option in the docker run command.

Контейнеры API анализа текста не используют входные или выходные подключения для хранения учебных данных или данных службы.The Text Analytics containers don't use input or output mounts to store training or service data.

Точный синтаксис расположения подключения к узлу зависит от операционной системы узла.The exact syntax of the host mount location varies depending on the host operating system. Кроме того,расположение подключения на главном компьютере может оказаться недоступным из-за конфликта между разрешениями для учетной записи службы Docker и расположения подключения к узлу.Additionally, the host computer's mount location may not be accessible due to a conflict between permissions used by the docker service account and the host mount location permissions.

НеобязательныйOptional НазваниеName Тип данныхData type ОписаниеDescription
Не разрешеноNot allowed Input СтроковоеString Контейнеры API анализа текста не используют этот элемент.Text Analytics containers do not use this.
НеобязательныйOptional Output СтроковоеString Цель выходного подключения.The target of the output mount. Значение по умолчанию — /output.The default value is /output. Это расположение файлов журналов.This is the location of the logs. Сюда входят журналы контейнера.This includes container logs.

Пример:Example:
--mount type=bind,src=c:\output,target=/output

Примеры команд docker runExample docker run commands

В следующих примерах параметры конфигурации иллюстрируют процесс написания и использования команд docker run.The following examples use the configuration settings to illustrate how to write and use docker run commands. После запуска контейнер продолжает работу, пока вы его не остановите.Once running, the container continues to run until you stop it.

  • Символ продолжения строки. В командах Docker в следующих разделах используется обратная косая черта (\) как символ продолжения строки.Line-continuation character: The docker commands in the following sections use the back slash, \, as a line continuation character. Замените или удалите ее в соответствии с требованиями вашей операционной системы.Replace or remove this based on your host operating system's requirements.
  • Порядок аргументов. Не изменяйте порядок аргументов, если вы еще не очень хорошо знакомы с контейнерами Docker.Argument order: Do not change the order of the arguments unless you are very familiar with docker containers.

Замените строку {имя_аргумента} собственными значениями.Replace {argument_name} with your own values:

МестозаполнительPlaceholder ЗначениеValue Формат или примерFormat or example
{API_KEY}{API_KEY} Ключ Text Analytics конечной точки ресурса, доступный на странице ключей Azure Text Analytics .The endpoint key of the Text Analytics resource available on the Azure Text Analytics Keys page. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI}{ENDPOINT_URI} Значение конечной точки выставления счетов доступно на странице Text Analytics обзора Azure.The billing endpoint value is available on the Azure Text Analytics Overview page. См. раздел сбор обязательных параметров для явных примеров.See gathering required parameters for explicit examples.

Важно!

Для запуска контейнера необходимо указать параметры Eula, Billing и ApiKey. В противном случае контейнер не запустится.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Дополнительные сведения см. в разделе о выставлении счетов.For more information, see Billing. Значение apiKey является ключом на странице ключей ресурсов Azure Text Analytics .The ApiKey value is the Key from the Azure Text Analytics Resource keys page.

Извлечение ключевых фраз.Key Phrase Extraction

Примеры извлечение ключевых фраз контейнера DOCKERKey Phrase Extraction container docker examples

Следующие примеры DOCKER предназначены для контейнера извлечение ключевых фраз.The following docker examples are for the Key Phrase Extraction container.

Простой примерBasic example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/keyphrase \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} 

Пример ведения журналаLogging example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/keyphrase \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} \
Logging:Console:LogLevel:Default=Information

Распознавание языка.Language Detection

Примеры распознавание языка контейнера DOCKERLanguage Detection container docker examples

Следующие примеры DOCKER предназначены для контейнера распознавание языка.The following docker examples are for the Language Detection container.

Простой примерBasic example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/language \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} 

Пример ведения журналаLogging example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/language \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} \
Logging:Console:LogLevel:Default=Information

Анализ тональности.Sentiment Analysis

Примеры анализ тональности контейнера DOCKERSentiment Analysis container docker examples

Следующие примеры DOCKER предназначены для контейнера анализ тональности.The following docker examples are for the Sentiment Analysis container.

Простой примерBasic example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/sentiment \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} 

Пример ведения журналаLogging example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/sentiment \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} \
Logging:Console:LogLevel:Default=Information

Следующие шагиNext steps