Metin Analizi Docker kapsayıcılarını yapılandırma

Metin Analizi, her kapsayıcıyı ortak bir yapılandırma çerçevesiyle sağlar; böylece, kapsayıcılarınız için depolama, günlüğe kaydetme ve telemetri ve güvenlik ayarlarını kolayca yapılandırabilir ve yönetebilirsiniz. Birkaç örnek Docker Run komutu de mevcuttur.

Yapılandırma ayarları

Kapsayıcı aşağıdaki yapılandırma ayarlarına sahiptir:

Gerekli Ayar Amaç
Yes ApiKey Fatura bilgilerini izler.
No ApplicationInsights , Kapsayıcınıza Azure Application Insights telemetri desteğinin eklenmesini sağlar.
Yes Faturalandırma Azure üzerindeki hizmet kaynağının uç nokta URI 'sini belirtir.
Yes Sözleşmesi Kapsayıcının lisansını kabul ettiğinizi gösterir.
No Fluentd Günlük ve isteğe bağlı olarak ölçüm verilerini Floentd sunucusuna yazar.
No HTTP proxy 'Si Giden istekler oluşturmak için bir HTTP proxy yapılandırır.
No Günlüğe kaydetme , Kapsayıcınız için ASP.NET Core günlük desteği sağlar.
No Kullan Ana bilgisayardan kapsayıcıya ve kapsayıcıdan ana bilgisayara geri veri okur ve yazar.

Önemli

ApiKey, Billing Ve Eula ayarları birlikte kullanılır ve üçü için geçerli değerler sağlamanız gerekir; Aksi takdirde Kapsayıcınız başlatılmaz. Bir kapsayıcı oluşturmak için bu yapılandırma ayarlarını kullanma hakkında daha fazla bilgi için bkz. faturalandırma.

ApiKey yapılandırma ayarı

Bu ApiKey ayar, kapsayıcının fatura bilgilerini izlemek için kullanılan Azure Kaynak anahtarını belirtir. ApiKey için bir değer belirtmeniz gerekir ve değerin yapılandırma ayarı için belirtilen metin analizi kaynağı için geçerli bir anahtar olması gerekir Billing .

Bu ayar aşağıdaki yerde bulunabilir:

  • Azure portal: metin analizi kaynak yönetimi, anahtarlar altında

ApplicationInsights ayarı

ApplicationInsightsAyar, kapsayıcınıza Azure Application Insights telemetri desteği eklemenize olanak tanır. Application Insights kapsayıcının derinlemesine izlenmesini sağlar. Kapsayıcınızı kullanılabilirlik, performans ve kullanım açısından kolayca izleyebilirsiniz. Ayrıca, kapsayıcıınızda hataları hızlıca tanımlayabilir ve tanılayabilirsiniz.

Aşağıdaki tabloda, bölümünde desteklenen yapılandırma ayarları açıklanmaktadır ApplicationInsights .

Gerekli Name Veri türü Açıklama
Hayır InstrumentationKey Dize Kapsayıcı için Telemetri verilerinin gönderildiği Application Insights örneğinin izleme anahtarı. Daha fazla bilgi için bkz. ASP.NET Core Application Insights.

Örnek:
InstrumentationKey=123456789

Faturalandırma yapılandırma ayarı

Bu Billing ayar, Azure 'da kapsayıcının fatura bilgilerini ölçmek için kullanılan metin analizi KAYNAĞıNıN uç nokta URI 'sini belirtir. Bu yapılandırma ayarı için bir değer belirtmeniz gerekir ve Azure 'da bir _ metin analizi kaynağı için değer geçerli bir uç nokta URI 'si olmalıdır. Kapsayıcı her 10 ila 15 dakikada bir kullanım raporu sağlar.

Bu ayar aşağıdaki yerde bulunabilir:

  • Azure portal: metin analizi genel bakış, etiketli Endpoint
Gerekli Name Veri türü Açıklama
Evet Billing Dize Faturalama uç noktası URI 'SI. Faturalandırma URI 'sini alma hakkında daha fazla bilgi için bkz. gerekli parametreleri toplama. Daha fazla bilgi ve bölgesel uç noktaların tamamen listesi için bkz. bilişsel Hizmetler Için özel alt etki alanı adları.

EULA ayarı

EulaAyar, kapsayıcının lisansını kabul ettiğinizi gösterir. Bu yapılandırma ayarı için bir değer belirtmeniz gerekir ve değer olarak ayarlanmalıdır accept .

Gerekli Name Veri türü Açıklama
Evet Eula Dize Lisans kabulü

Örnek:
Eula=accept

Bilişsel hizmetler kapsayıcıları, Azure kullanımınızı düzenleyen sözleşmeniz kapsamında lisanslanır. Azure kullanımınızı yöneten mevcut bir anlaşmanız yoksa, Azure 'un kullanımını yöneten sözleşmenizin, çevrimiçi hizmet koşulları'nı içeren Microsoft çevrimiçi abonelik sözleşmesiolduğunu kabul etmiş olursunuz. Önizlemeler için Ayrıca, Microsoft Azure önizlemeleri Için ek kullanım koşulları'nı kabul etmiş olursunuz. Kapsayıcıyı kullanarak bu koşulları kabul etmiş olursunuz.

Akışkan entd ayarları

Floentd, Birleşik günlük kaydına yönelik açık kaynaklı bir veri toplayıcıdır. FluentdAyarlar, kapsayıcının bir Floentd sunucusuyla bağlantısını yönetir. Kapsayıcı, kapsayıcının günlükleri ve isteğe bağlı olarak ölçüm verilerini Floentd sunucusuna yazmasını sağlayan bir Floentd günlüğe kaydetme sağlayıcısı içerir.

Aşağıdaki tabloda, bölümünde desteklenen yapılandırma ayarları açıklanmaktadır Fluentd .

Name Veri türü Açıklama
Host Dize Floentd sunucusunun IP adresi veya DNS ana bilgisayar adı.
Port Tamsayı Floentd sunucusunun bağlantı noktası.
Varsayılan değer 24224 ' dir.
HeartbeatMs Tamsayı Sinyal aralığı (milisaniye cinsinden). Bu Aralık sona ermeden önce hiçbir olay trafiği gönderilmezse, Floentd sunucusuna bir sinyal gönderilir. Varsayılan değer 60000 milisaniyedir (1 dakika).
SendBufferSize Tamsayı Gönderme işlemleri için ayrılan, bayt cinsinden ağ arabelleği alanı. Varsayılan değer 32768 bayttır (32 kilobayt).
TlsConnectionEstablishmentTimeoutMs Tamsayı Akıcı Entd sunucusuyla SSL/TLS bağlantısı kurmak için milisaniye cinsinden zaman aşımı. Varsayılan değer 10000 milisaniyedir (10 saniye).
UseTLSFalse olarak ayarlanırsa, bu değer yoksayılır.
UseTLS Boole Kapsayıcının, Floentd sunucusuyla iletişim kurmak için SSL/TLS kullanması gerekip gerekmediğini belirtir. Varsayılan değer false'tur.

Http proxy kimlik bilgileri ayarları

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:

Name Veri türü Açıklama
HTTP_PROXY string Kullanılacak proxy, örneğin, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS string Proxy için kimlik doğrulaması yapmak için gereken tüm kimlik bilgileri, örneğin, username:password . Bu değer küçük harf olmalıdır.
<proxy-user> string Proxy için Kullanıcı.
<proxy-password> string <proxy-user>Ara sunucu için ile ilişkili parola.
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> \

Oturum açma ayarları

LoggingAyarlar, Kapsayıcınız için ASP.NET Core günlük desteğini yönetir. ASP.NET Core bir uygulama için kullandığınız, Kapsayıcınız için aynı yapılandırma ayarlarını ve değerlerini kullanabilirsiniz.

Aşağıdaki günlük oluşturma sağlayıcıları kapsayıcı tarafından desteklenir:

Sağlayıcı Amaç
Konsol ASP.NET Core Console günlük sağlayıcısı. Bu günlüğe kaydetme sağlayıcısı için ASP.NET Core yapılandırma ayarları ve varsayılan değerler desteklenir.
Hata Ayıklama ASP.NET Core Debug günlük sağlayıcısı. Bu günlüğe kaydetme sağlayıcısı için ASP.NET Core yapılandırma ayarları ve varsayılan değerler desteklenir.
Disk JSON günlük sağlayıcısı. Bu günlüğe kaydetme sağlayıcısı günlük verilerini çıkış bağlamalarına yazar.

Bu kapsayıcı komutu, günlük bilgilerini JSON biçiminde çıktı bağlamaya depolar:

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 olan hata ayıklama bilgilerini gösterir 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 günlüğü

DiskGünlük sağlayıcısı aşağıdaki yapılandırma ayarlarını destekler:

Name Veri türü Açıklama
Format Dize Günlük dosyaları için çıkış biçimi.
Note: json Günlüğe kaydetme sağlayıcısını etkinleştirmek için bu değerin olarak ayarlanması gerekir. Bu değer, bir kapsayıcıyı örneklarken bir çıkış bağlaması belirtilmeden belirtilirse bir hata oluşur.
MaxFileSize Tamsayı Günlük dosyasının megabayt (MB) cinsinden en büyük boyutu. Geçerli günlük dosyasının boyutu bu değeri karşıladığında veya aştığında, günlük sağlayıcısı tarafından yeni bir günlük dosyası başlatılır. -1 belirtilirse, günlük dosyasının boyutu, varsa çıkış bağlaması için en fazla dosya boyutuyla sınırlıdır. Varsayılan değer 1’dir.

ASP.NET Core günlüğü desteğini yapılandırma hakkında daha fazla bilgi için bkz. Ayarlar dosya yapılandırması.

Bağlama ayarları

Kapsayıcıya ve kapsayıcılardan veri okumak ve buradan veri yazmak için BIND bağlama kullanın. --mount Docker Run komutunda seçeneğini belirterek bir giriş bağlama veya çıkış bağlama belirtebilirsiniz.

Metin Analizi kapsayıcıları, eğitim veya hizmet verilerini depolamak için giriş veya çıkış taklarını kullanmaz.

Konak bağlama konumunun tam sözdizimi, ana bilgisayar işletim sistemine bağlı olarak değişir. Ayrıca, Docker hizmeti hesabı ve konak bağlama konumu izinleri tarafından kullanılan izinler arasındaki bir çakışma nedeniyle ana bilgisayarınbağlama konumu erişilebilir olmayabilir.

İsteğe Bağlı Name Veri türü Açıklama
İzin verilmiyor Input Dize Metin Analizi kapsayıcılar bunu kullanmaz.
İsteğe Bağlı Output Dize Çıkış bağlama hedefi. /output varsayılan değerdir. Bu, günlüklerin konumudur. Bu, kapsayıcı günlüklerini içerir.

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

Sonraki adımlar