Настройка функции "Анализ текста" для контейнеров работоспособности в Docker
Функция "Анализ текста" предоставляет каждому контейнеру работоспособности общую платформу конфигурации, что позволяет легко настроить хранилище, ведение журнала, данные телеметрии и параметры безопасности для контейнеров, а также управлять ими. Также доступны несколько примеров выполнения команд docker run.
Параметры конфигурации
К контейнеру применяются следующие параметры конфигурации:
| Обязательно | Параметр | Назначение |
|---|---|---|
| Да | ApiKey | Отслеживает данные для выставления счетов. |
| Нет | ApplicationInsights | Позволяет добавить в контейнер поддержку телеметрии Azure Application Insights. |
| Да | Выставление счетов | Задает URI конечной точки для ресурса службы в Azure. |
| Да | Eula | Указывает, что вы приняли условия лицензии для контейнера. |
| Нет | Fluentd | Записывает данные в журнал и при необходимости передает метрики на сервер Fluentd. |
| Нет | Прокси-сервер HTTP | Настраивает прокси-сервер HTTP для исходящих запросов. |
| Нет | Logging | Обеспечивает поддержку ведения журнала ASP.NET Core для вашего контейнера. |
| Нет | Подключения | Считывает и записывает данные с главного компьютера в контейнер и обратно. |
Важно!
Параметры ApiKey, Billing и Eula используются совместно, и для всех трех параметров необходимо указать допустимые значения. В противном случае контейнер не запустится. Дополнительные сведения об использовании этих параметров конфигурации для создания экземпляра контейнера см. в разделе Выставление счетов.
Параметр конфигурации ApiKey
Параметр ApiKey определяет ключ ресурса Azure, который используется для отслеживания данных для выставления счетов для контейнера. Значение ApiKey является обязательным и должно содержать допустимый ключ для ресурса языковой службы, заданного в параметре конфигурации Billing.
Этот параметр можно найти в следующем месте.
- Портал Azure: управление ресурсами языковой службы в разделе Ключи и конечная точка
Параметр ApplicationInsights.
Параметр ApplicationInsights позволяет добавить в контейнер поддержку телеметрии Azure Application Insights. Служба Application Insights обеспечивает детализированный мониторинг контейнера. Вы можете легко отслеживать доступность, производительность и использование своего контейнера. Вы также можете быстро идентифицировать и диагностировать ошибки в контейнере.
В следующей таблице описаны параметры конфигурации, поддерживаемые в разделе ApplicationInsights.
| Обязательно | Имя | Тип данных | Описание |
|---|---|---|---|
| нет | InstrumentationKey |
Строка | Ключ инструментирования экземпляра Application Insights, которому отправляются данные телеметрии для контейнера. Дополнительные сведения см. в статье Application Insights для ASP.NET Core. Пример. InstrumentationKey=123456789 |
Параметр конфигурации выставления счетов
Параметр Billing определяет URI конечной точки ресурса языковой службы в Azure. Используется для контроля данных, связанных с контейнером, при выставлении счетов. Для этого параметра конфигурации необходимо задать значение, которое должно быть допустимым URI конечной точки для ресурса языковой службы в Azure. Отчеты об использовании контейнера примерно каждые 10—15 минут.
Этот параметр можно найти в следующем месте.
- Портал Azure: обзор языковой службы с меткой
Endpoint
| Обязательно | Имя | Тип данных | Описание |
|---|---|---|---|
| Да | Billing |
Строка | URI конечной точки биллинга. Дополнительные сведения о получении URI выставления счетов см. в разделе Сбор обязательных параметров. Дополнительные сведения и полный список региональных конечных точек см. в статье Пользовательские имена поддоменов для служб ИИ Azure. |
Параметр Eula
Параметр Eula указывает, что вы приняли условия лицензии для контейнера. Для этого параметра конфигурации необходимо указать значение accept.
| Обязательно | Имя | Тип данных | Описание |
|---|---|---|---|
| Да | Eula |
Строка | Принятие условий лицензионного соглашения Пример. Eula=accept |
Контейнеры служб ИИ Azure лицензируются в соответствии с соглашением, регулирующим использование Azure. Если вы не заключали соглашение, регламентирующее использование Azure, вы подтверждаете, что ваше соглашение об использовании Azure является соглашением Microsoft Online Subscription, которое содержит условия использования веб-служб. Что касается предварительных версий, вы также соглашаетесь с Дополнительными условиями использования предварительных версий Microsoft Azure. Факт использования вами контейнера подтверждает ваше согласие с этими условиями.
Параметры Fluentd
Fluentd — это сборщик данных с открытым кодом для унифицированного ведения журнала. Параметры Fluentd управляют подключением контейнера к серверу Fluentd. В состав контейнера входит поставщик ведения журнала Fluentd, который позволяет контейнеру записывать данные журналов и (необязательно) данные метрик на сервер Fluentd.
В следующей таблице описаны параметры конфигурации, поддерживаемые в разделе Fluentd.
| Имя | Тип данных | Описание |
|---|---|---|
Host |
Строка | IP-адрес или имя узла DNS сервера Fluentd. |
Port |
Целое число | Порт сервера Fluentd. Значение по умолчанию — 24224. |
HeartbeatMs |
Целое число | Интервал пульса в миллисекундах. Если до окончания этого интервала не отправлялся никакой трафик событий, пульс отправляется на сервер Fluentd. Значение по умолчанию — 60 000 миллисекунд (1 минута). |
SendBufferSize |
Целое число | Место в сетевом буфере (в байтах), выделенное для операций отправки. Значение по умолчанию — 32768 байт (32 килобайта). |
TlsConnectionEstablishmentTimeoutMs |
Целое число | Время ожидания (в миллисекундах) до установки соединения по протоколу SSL/TLS с сервером Fluentd. Значение по умолчанию — 10 000 миллисекунд (10 секунд). Если для параметра UseTLS задано значение false, то это значение игнорируется. |
UseTLS |
Логическое | Указывает, должен ли контейнер использовать протокол SSL/TLS для связи с сервером Fluentd. Значением по умолчанию является false. |
Параметры учетных данных прокси-сервера HTTP
Чтобы настроить прокси-сервер HTTP для исходящих запросов, используйте следующие два аргумента.
| Имя | Тип данных | Описание |
|---|---|---|
| HTTP_PROXY | строка | Используемый прокси-сервер, например http://proxy:8888.<proxy-url> |
| HTTP_PROXY_CREDS | строка | Любые учетные данные, необходимые для выполнения аутентификации на прокси-сервере, например username:password. Это значение должно быть в нижнем регистре. |
<proxy-user> |
строка | Пользователь прокси-сервера. |
<proxy-password> |
строка | Пароль, связанный с параметром <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.
Контейнер поддерживает указанных ниже поставщиков ведения журналов.
| Поставщик | Назначение |
|---|---|
| Консоль | Поставщик ведения журнала Console для ASP.NET Core. Для этого поставщика ведения журнала поддерживаются все параметры конфигурации ASP.NET Core и значения по умолчанию. |
| Отладка | Поставщик ведения журнала Debug для ASP.NET Core. Для этого поставщика ведения журнала поддерживаются все параметры конфигурации 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 |
Строка | Выходной формат файлов журналов. Примечание. Чтобы включить поставщика ведения журнала, для этого параметра необходимо задать значение json. Если это значение задано без указания выходного подключения, при создании экземпляра контейнера возникает ошибка. |
MaxFileSize |
Целое число | Максимальный размер файла журнала в мегабайтах (МБ). Когда размер текущего файла журнала достигает этого значения или превышает его, поставщик ведения журнала создает файл журнала. Если задано значение –1, то размер файла журнала ограничивается только максимальным размером файла (если он задан) для выходного подключения. Значение по умолчанию — 1. |
Дополнительные сведения о настройке поддержки ведения журналов для ASP.NET Core см. в разделе Настройка файла параметров.
Параметры подключения
Используйте подключения привязок для чтения данных из контейнера и записи в него. Вы можете указать входное или выходное подключение, указав параметр --mount в команде docker run.
Функция "Анализ текста" для контейнеров работоспособности не использует входные или выходные подключения для хранения учебных или служебных данных.
Точный синтаксис расположения подключения к узлу зависит от операционной системы узла. Кроме того,расположение подключения на главном компьютере может оказаться недоступным из-за конфликта между разрешениями для учетной записи службы Docker и расположения подключения к узлу.
| Необязательно | Имя | Тип данных | Описание |
|---|---|---|---|
| Нельзя использовать | Input |
Строка | Функция "Анализ текста" для контейнеров работоспособности не задействует этот параметр. |
| Необязательный | Output |
Строка | Цель выходного подключения. Значение по умолчанию — /output. Это расположение файлов журналов. Сюда входят журналы контейнера. Пример --mount type=bind,src=c:\output,target=/output |
Дальнейшие действия
- Изучите статью об установке и запуске контейнеров.
- Использование дополнительных контейнеров ИИ Azure