Language Understanding Docker kapsayıcılarını yapılandırmaConfigure Language Understanding Docker containers

Language Understanding (lusıs) kapsayıcı çalışma zamanı ortamı, docker run komut bağımsız değişkenleri kullanılarak yapılandırılır.The Language Understanding (LUIS) container runtime environment is configured using the docker run command arguments. LUIS birkaç isteğe bağlı ayarları ile birlikte gerekli birkaç ayar vardır.LUIS has several required settings, along with a few optional settings. Birkaç örnekler komutu kullanılabilir.Several examples of the command are available. Giriş kapsayıcısı özgü ayarlar şunlardır bağlama ayarları ve fatura ayarlar.The container-specific settings are the input mount settings and the billing settings.

Yapılandırma ayarlarıConfiguration settings

Bu kapsayıcı, aşağıdaki yapılandırma ayarları vardır:This container has the following configuration settings:

GerekliRequired AyarSetting AmaçPurpose
EvetYes ApiKeyApiKey Fatura bilgileri izlemek için kullanılır.Used to track billing information.
HayırNo ApplicationInsightsApplicationInsights Eklemenizi sağlayan Azure Application Insights kapsayıcınızı telemetri desteği.Allows you to add Azure Application Insights telemetry support to your container.
EvetYes BillingBilling Azure'daki hizmet kaynağının uç nokta URI'sini belirtir.Specifies the endpoint URI of the service resource on Azure.
EvetYes EulaEula Kapsayıcı lisansını kabul ettiğinizi gösterir.Indicates that you've accepted the license for the container.
HayırNo FluentdFluentd Günlük yazma ve isteğe bağlı olarak ölçüm verileri Fluentd sunucusuna.Write log and, optionally, metric data to a Fluentd server.
HayırNo Http proxy 'SiHttp Proxy Giden istekler oluşturmak için bir HTTP proxy 'si yapılandırın.Configure an HTTP proxy for making outbound requests.
HayırNo LoggingLogging Kapsayıcınız için ASP.NET Core günlük kaydı desteği sunar.Provides ASP.NET Core logging support for your container.
EvetYes MountsMounts Ana bilgisayardaki verileri okuyup kapsayıcıya, kapsayıcıdaki verileri okuyup ana bilgisayara yazar.Read and write data from host computer to container and from container back to host computer.

Önemli

ApiKey , Billing , Ve Eula ayarları birlikte kullanılır ve bunları; Aksi takdirde, tüm üç için geçerli değerler sağlamanız gerekir kapsayıcınızı başlatılamıyor.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. Bir kapsayıcı örneği oluşturmak için bu yapılandırma ayarlarını kullanma hakkında daha fazla bilgi için bkz. faturalama.For more information about using these configuration settings to instantiate a container, see Billing.

ApiKey ayarıApiKey setting

ApiKey Ayar kapsayıcısı için fatura bilgileri izlemek için kullanılan Azure kaynak anahtarını belirtir.The ApiKey setting specifies the Azure resource key used to track billing information for the container. Apikey için bir değer belirtmeniz gerekir ve değerin Billing yapılandırma ayarı için belirtilen bilişsel Hizmetler kaynağı için geçerli bir anahtar olması gerekir.You must specify a value for the ApiKey and the value must be a valid key for the Cognitive Services resource specified for the Billing configuration setting.

Bu ayar aşağıdaki konumlarda bulunabilir:This setting can be found in the following places:

  • Azure portal: Bilişsel Hizmetler Kaynak yönetimi, anahtarlar altındaAzure portal: Cognitive Services Resource Management, under Keys
  • LUSıS Portalı: Anahtarlar ve uç nokta ayarları sayfası.LUIS portal: Keys and Endpoint settings page.

Başlangıç veya geliştirme tuşuna kullanmayın.Do not use the starter key or the authoring key.

Applicationınsights ayarıApplicationInsights setting

ApplicationInsights Ayarı eklemenizi sağlayan Azure Application Insights kapsayıcınızı telemetri desteği.The ApplicationInsights setting allows you to add Azure Application Insights telemetry support to your container. Application Insights, kapsayıcının kapsamlı izleme sağlar.Application Insights provides in-depth monitoring of your container. Kapsayıcınızı kullanılabilirliğini, performansını ve kullanımını kolayca izleyebilir.You can easily monitor your container for availability, performance, and usage. Ayrıca bir kolayca belirleyin ve kapsayıcınızda hatalarını tanılayın.You can also quickly identify and diagnose errors in your container.

Aşağıdaki tabloda altında desteklenen yapılandırma ayarları açıklanmaktadır ApplicationInsights bölümü.The following table describes the configuration settings supported under the ApplicationInsights section.

GerekliRequired AdName Veri türüData type AçıklamaDescription
HayırNo InstrumentationKey DizeString İzleme anahtarı Application Insights örneğinin hangi telemetri veri kapsayıcısı için gönderilir.The instrumentation key of the Application Insights instance to which telemetry data for the container is sent. Daha fazla bilgi için ASP.NET Core için Application Insights.For more information, see Application Insights for ASP.NET Core.

Örnek:Example:
InstrumentationKey=123456789

Faturalandırma ayarıBilling setting

Ayar, Azure üzerinde bulunan bilişsel hizmetler kaynağının, kapsayıcının fatura bilgilerini ölçmek için kullanılan uç nokta URI 'sini belirtir. BillingThe Billing setting specifies the endpoint URI of the Cognitive Services resource on Azure used to meter billing information for the container. Bu yapılandırma ayarı için bir değer belirtmeniz gerekir ve Azure 'daki bilişsel Hizmetler kaynağı için değer geçerli bir uç nokta URI 'si olmalıdır.You must specify a value for this configuration setting, and the value must be a valid endpoint URI for a Cognitive Services resource on Azure. Kapsayıcı her 10 ila 15 dakikada bir kullanım raporu sağlar.The container reports usage about every 10 to 15 minutes.

Bu ayar aşağıdaki konumlarda bulunabilir:This setting can be found in the following places:

  • Azure portal: Bilişsel Hizmetler Genel bakış, etiketliEndpointAzure portal: Cognitive Services Overview, labeled Endpoint
  • LUSıS Portalı: Uç nokta URI 'sinin bir parçası olarak anahtarlar ve uç nokta ayarları sayfası.LUIS portal: Keys and Endpoint settings page, as part of the endpoint URI.

Aşağıdaki tabloda gösterildiği gibi luis/v2.0 , yönlendirme URL 'sine dahil etmeyi unutmayın:Remember to include the luis/v2.0 routing in the URL as shown in the following table:

GerekliRequired AdName Veri türüData type AçıklamaDescription
EvetYes Billing DizeString Faturalandırma uç noktası URI'siBilling endpoint URI

Örnek:Example:
Billing=https://westus.api.cognitive.microsoft.com/luis/v2.0

EULA'yı ayarlamaEula setting

Eula Ayarı, kapsayıcı lisansını kabul ettiğiniz belirtir.The Eula setting indicates that you've accepted the license for the container. Bu yapılandırma ayarı için bir değer belirtmeniz gerekir ve değer ayarlanmalıdır accept.You must specify a value for this configuration setting, and the value must be set to accept.

GerekliRequired AdName Veri türüData type AçıklamaDescription
EvetYes Eula DizeString Lisans kabulüLicense acceptance

Örnek:Example:
Eula=accept

Bilişsel hizmetler kapsayıcıları altında lisanslanır sözleşmenize Azure kullanımınızı.Cognitive Services containers are licensed under your agreement governing your use of Azure. Azure kullanımınızı var olan bir anlaşma değilse, Azure'un kullanımını düzenleyen sözleşmenize olduğunu kabul ediyorum Microsoft çevrimiçi Abonelik Sözleşmesi, kullanımımın çevrimiçi hizmet koşulları .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. Önizlemeler için de kabul ek kullanım koşulları Microsoft Azure önizlemeleri için.For previews, you also agree to the Supplemental Terms of Use for Microsoft Azure Previews. Kapsayıcı kullanarak bu koşulları kabul etmiş olursunuz.By using the container you agree to these terms.

Fluentd ayarlarıFluentd settings

Bir açık kaynak veri toplayıcı birleşik günlük kaydı için Fluentd olur.Fluentd is an open-source data collector for unified logging. Fluentd Ayarlarını yönetmek için kapsayıcının bağlantı bir Fluentd sunucusu.The Fluentd settings manage the container's connection to a Fluentd server. Kapsayıcı günlüklerini yazma izni veren bir Fluentd oturum açma sağlayıcısı kapsayıcı içerir ve isteğe bağlı olarak ölçüm verileri Fluentd sunucusuna.The container includes a Fluentd logging provider, which allows your container to write logs and, optionally, metric data to a Fluentd server.

Aşağıdaki tabloda altında desteklenen yapılandırma ayarları açıklanmaktadır Fluentd bölümü.The following table describes the configuration settings supported under the Fluentd section.

AdName Veri türüData type AçıklamaDescription
Host DizeString Fluentd sunucusunun DNS ana bilgisayar adını veya IP adresi.The IP address or DNS host name of the Fluentd server.
Port TamsayıInteger Fluentd sunucusunun bağlantı noktası.The port of the Fluentd server.
24224 varsayılan değerdir.The default value is 24224.
HeartbeatMs TamsayıInteger Milisaniye cinsinden sinyal aralığı.The heartbeat interval, in milliseconds. Bu aralığı süresi dolmadan önce olay trafik gönderildi, bir sinyal Fluentd sunucuya gönderilir.If no event traffic has been sent before this interval expires, a heartbeat is sent to the Fluentd server. 60000 milisaniye (1 dakika) varsayılan değerdir.The default value is 60000 milliseconds (1 minute).
SendBufferSize TamsayıInteger Gönderme işlemleri için ayrılan bayt cinsinden ağ arabellek alanı.The network buffer space, in bytes, allocated for send operations. 32768 bayt (32 kilobayt) varsayılan değerdir.The default value is 32768 bytes (32 kilobytes).
TlsConnectionEstablishmentTimeoutMs TamsayıInteger Zaman aşımı, Fluentd sunucusuyla bir SSL/TLS bağlantı kurmak için milisaniye cinsinden.The timeout, in milliseconds, to establish a SSL/TLS connection with the Fluentd server. 10000 milisaniye (10 saniye) varsayılan değerdir.The default value is 10000 milliseconds (10 seconds).
Varsa UseTLS yanlış olarak bu değeri yok sayıldı ayarlanmış.If UseTLS is set to false, this value is ignored.
UseTLS BooleBoolean Kapsayıcı Fluentd sunucusu ile iletişim kurmak için SSL/TLS kullanıp kullanmayacağını belirtir.Indicates whether the container should use SSL/TLS for communicating with the Fluentd server. Varsayılan değer false'tur.The default value is false.

Http proxy kimlik bilgileri ayarlarıHttp proxy credentials settings

Giden istekler oluşturmak için bir HTTP proxy 'si yapılandırmanız gerekiyorsa şu iki bağımsız değişkeni kullanın:If you need to configure an HTTP proxy for making outbound requests, use these two arguments:

AdName Veri türüData type AçıklamaDescription
HTTP_PROXYHTTP_PROXY dizestring Kullanılacak proxy, örneğin,http://proxy:8888The proxy to use, for example, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDSHTTP_PROXY_CREDS dizestring Proxy için kimlik doğrulaması yapmak için gereken tüm kimlik bilgileri, örneğin, Kullanıcı adı: parola.Any credentials needed to authenticate against the proxy, for example, username:password.
<proxy-user> dizestring Proxy için Kullanıcı.The user for the proxy.
<proxy-password> dizestring Ara sunucu için ile <proxy-user> ilişkili parola.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> \

Günlük ayarlarıLogging settings

Logging Ayarlarını yönetme kapsayıcınız için ASP.NET Core oturum açma desteği.The Logging settings manage ASP.NET Core logging support for your container. Bir ASP.NET Core uygulaması için kullandığınız kapsayıcınız için aynı yapılandırma ayarları ve değerleri kullanabilirsiniz.You can use the same configuration settings and values for your container that you use for an ASP.NET Core application.

Aşağıdaki günlük oluşturma sağlayıcıları kapsayıcı tarafından desteklenir:The following logging providers are supported by the container:

SağlayıcıProvider AmaçPurpose
ConsoleConsole ASP.NET Core Console oturum açma sağlayıcısı.The ASP.NET Core Console logging provider. Tüm ASP.NET Core yapılandırma ayarlarını ve bu oturum açma sağlayıcısı için varsayılan değerleri desteklenir.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
Hata ayıklamaDebug ASP.NET Core Debug oturum açma sağlayıcısı.The ASP.NET Core Debug logging provider. Tüm ASP.NET Core yapılandırma ayarlarını ve bu oturum açma sağlayıcısı için varsayılan değerleri desteklenir.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
DiskDisk JSON oturum açma sağlayıcısı.The JSON logging provider. Bu oturum açma sağlayıcısı için çıktı bağlama günlük verilerini yazar.This logging provider writes log data to the output mount.

Bu kapsayıcı komutu, günlük bilgilerini JSON biçiminde çıktı bağlamaya depolar: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

Bu kapsayıcı komutu, kapsayıcı çalışırken, ön eki dbugolan hata ayıklama bilgilerini gösterir: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 günlüğe kaydetmeDisk logging

Disk Oturum açma sağlayıcısı, aşağıdaki yapılandırma ayarları destekler:The Disk logging provider supports the following configuration settings:

AdName Veri türüData type AçıklamaDescription
Format DizeString Günlük dosyaları için çıkış biçimi.The output format for log files.
Not: Günlüğe kaydetme sağlayıcısını etkinleştirmek için bu json değerin olarak ayarlanması gerekir.Note: This value must be set to json to enable the logging provider. Bu değer aynı zamanda bir kapsayıcı örneği oluşturulurken bir çıkış bağlama belirtmeden belirtilirse, bir hata oluşur.If this value is specified without also specifying an output mount while instantiating a container, an error occurs.
MaxFileSize TamsayıInteger Megabayt (MB) günlük dosyasının en büyük boyutu.The maximum size, in megabytes (MB), of a log file. Yeni bir günlük dosyası, geçerli günlük dosyası boyutunu karşıladığından veya bu değeri aşarsa, oturum açma sağlayıcısı tarafından başlatılır.When the size of the current log file meets or exceeds this value, a new log file is started by the logging provider. -1 belirtilmezse, günlük dosyasının boyutu, çıkış bağlama yalnızca en büyük dosya boyutuyla sınırlıdır.If -1 is specified, the size of the log file is limited only by the maximum file size, if any, for the output mount. Varsayılan değer 1'dir.The default value is 1.

ASP.NET Core günlük desteği yapılandırma hakkında daha fazla bilgi için bkz. ayarları dosya Yapılandırması.For more information about configuring ASP.NET Core logging support, see Settings file configuration.

Bağlama ayarlarıMount settings

Kullanım bağlama okumak ve kapsayıcı gelen ve giden veri yazmak için bağlar.Use bind mounts to read and write data to and from the container. Bir giriş bağlama belirtin veya çıkış bağlama belirterek --mount seçeneğini docker run komutu.You can specify an input mount or output mount by specifying the --mount option in the docker run command.

LUIS kapsayıcı giriş kullanmaz ya da eğitim veya hizmeti verilerini depolamak için çıkış bağlar.The LUIS container doesn't use input or output mounts to store training or service data.

Konak bağlama konumu söz dizimi konak işletim sistemine göre değişir.The exact syntax of the host mount location varies depending on the host operating system. Ayrıca, ana bilgisayar's bağlama konumu docker hizmet hesabı tarafından kullanılan izinler arasında bir çakışma nedeniyle erişilebilir olmayabilir ve konak yeri izinleri bağlayın.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.

Aşağıdaki tabloda, desteklenen ayarları açıklanmaktadır.The following table describes the settings supported.

GerekliRequired AdName Veri türüData type AçıklamaDescription
EvetYes Input DizeString Giriş bağlama hedefi.The target of the input mount. Varsayılan değer /input şeklindedir.The default value is /input. LUIS paket dosyalarının konumunu budur.This is the location of the LUIS package files.

Örnek:Example:
--mount type=bind,src=c:\input,target=/input
HayırNo Output DizeString Çıkış bağlama hedefi.The target of the output mount. Varsayılan değer /output şeklindedir.The default value is /output. Bu günlükler konumdur.This is the location of the logs. Bu, LUIS sorgu ve kapsayıcı günlükleri içerir.This includes LUIS query logs and container logs.

Örnek:Example:
--mount type=bind,src=c:\output,target=/output

Örnek docker komutlarını çalıştırınExample docker run commands

Aşağıdaki örnekler, yazma ve kullanma göstermek için yapılandırma ayarlarını kullanır. docker run komutları.The following examples use the configuration settings to illustrate how to write and use docker run commands. Kapsayıcıyı çalıştıran sonra dek çalıştırmaya devam Durdur bu.Once running, the container continues to run until you stop it.

  • Bu örnekler, Windows 'ta herhangi bir c: izin çakışmasını önlemek için dizini sürücüden kullanır.These examples use the directory off the c: drive to avoid any permission conflicts on Windows. Giriş dizini belirli bir dizini kullanmak istiyorsanız, docker vermeniz gerekebilir hizmet izni.If you need to use a specific directory as the input directory, you may need to grant the docker service permission.
  • Docker kapsayıcıları ile çok iyi bilmiyorsanız, bağımsız değişkenlerin sırası değiştirmeyin.Do not change the order of the arguments unless you are very familiar with docker containers.
  • Farklı bir işletim sistemi kullanıyorsanız, sistem için doğru konsol/Terminal, bağlama için klasör söz dizimi ve satır devamlılık karakteri kullanın.If you are using a different operating system, use the correct console/terminal, folder syntax for mounts, and line continuation character for your system. Bu örneklerde bir Windows konsolunun satır devamlılık karakteriyle ^birlikte varsayılmaktadır.These examples assume a Windows console with a line continuation character ^. Kapsayıcı bir Linux işletim sistemi olduğundan, hedef bağlama bir Linux stili klasör söz dizimini kullanır.Because the container is a Linux operating system, the target mount uses a Linux-style folder syntax.

Aşağıdaki tabloda gösterildiği gibi luis/v2.0 , yönlendirme URL 'sine dahil etmeyi unutmayın.Remember to include the luis/v2.0 routing in the URL as shown in the following table.

Yerine {argument_name} kendi değerlerinizle:Replace {argument_name} with your own values:

Yer tutucuPlaceholder DeğerValue Biçim veya örnekFormat or example
{API_KEY}{API_KEY} Eğitilen LUIS uygulama uç noktası anahtarı.The endpoint key of the trained LUIS application. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URL}{ENDPOINT_URL} Faturalandırma uç noktası değeri, Azure Cognitive Services Genel Bakış sayfasında bulunur.The billing endpoint value is available on the Azure Cognitive Services Overview page. https://westus.api.cognitive.microsoft.com/luis/v2.0

Önemli

Eula, Billing, Ve ApiKey kapsayıcıyı çalıştırmak için seçenekler belirtilmelidir; Aksi takdirde, kapsayıcı başlatılamıyor.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Daha fazla bilgi için faturalama.For more information, see Billing. Apikey değeri, Lua portalındaki anahtarlar ve uç noktalar sayfasından ve Azure Cognitive Services kaynak anahtarları sayfasında da kullanılabilir.The ApiKey value is the Key from the Keys and Endpoints page in the LUIS portal and is also available on the Azure Cognitive Services resource keys page.

Temel örnekBasic example

Aşağıdaki örnek, kapsayıcıyı çalıştırmak olası en az sayıda bağımsız değişkenlere sahiptir:The following example has the fewest arguments possible to run the container:

docker run --rm -it -p 5000:5000 --memory 4g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY}

Applicationınsights örneğiApplicationInsights example

Aşağıdaki örnek, kapsayıcıyı çalışırken Application Insights'a telemetri göndermek Applicationınsights bağımsız değişken ayarlar:The following example sets the ApplicationInsights argument to send telemetry to Application Insights while the container is running:

docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
InstrumentationKey={INSTRUMENTATION_KEY}

Günlüğe kaydetme örneğiLogging example

Aşağıdaki komut günlüğe kaydetme düzeyini ayarlar Logging:Console:LogLevel, günlüğe kaydetme düzeyini yapılandırmak için Information .The following command sets the logging level, Logging:Console:LogLevel, to configure the logging level to Information.

docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
Logging:Console:LogLevel:Default=Information

Sonraki adımlarNext steps