Translator Docker kapsayıcılarını yapılandırma

Azure AI hizmetleri her kapsayıcıya ortak bir yapılandırma çerçevesi sağlar. Translator kapsayıcılarınızı kolayca yapılandırarak güçlü bulut özellikleri ve uç yerellik için iyileştirilmiş Translator uygulama mimarisi oluşturabilirsiniz.

Translator kapsayıcı çalışma zamanı ortamı, komut bağımsız değişkenleri kullanılarak docker run yapılandırılır. Bu kapsayıcı hem gerekli hem de isteğe bağlı ayarlara sahiptir. Gerekli kapsayıcıya özgü ayarlar faturalama ayarlarıdır.

Yapılandırma ayarları

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

Zorunlu Ayar Purpose
Yes ApiKey Fatura bilgilerini izler.
Hayır ApplicationInsights Kapsayıcınıza Azure Uygulaması lication Insights telemetrik desteği eklenmesini sağlar.
Yes Faturalandırma Azure'daki hizmet kaynağının uç nokta URI'sini belirtir.
Yes EULA Kapsayıcı için son kullanıcı lisans sözleşmesini (EULA) kabul ettiğinizi gösterir.
Hayır Fluentd Günlük ve isteğe bağlı olarak ölçüm verilerini Fluentd sunucusuna yazar.
Hayır HTTP Ara Sunucusu Giden istekler yapmak için bir HTTP ara sunucusu yapılandırılır.
Hayır Günlüğe kaydetme Kapsayıcınız için ASP.NET Core günlük kaydı desteği sağlar.
Yes Bağlar Konak bilgisayardan kapsayıcıya ve kapsayıcıdan ana bilgisayara verileri okur ve yazar.

Önemli

ApiKey, Faturalama ve EULA ayarları birlikte kullanılır ve bunların üçü için de geçerli değerler sağlamanız gerekir; aksi takdirde kapsayıcınız başlatılmaz. Kapsayıcı örneği oluşturmak için bu yapılandırma ayarlarını kullanma hakkında daha fazla bilgi için.

ApiKey yapılandırma ayarı

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

Bu ayar aşağıdaki yerde bulunabilir:

  • Azure portalı: Anahtarlar altında Translator kaynak yönetimi

ApplicationInsights ayarı

Bu ApplicationInsights ayar kapsayıcınıza Azure Uygulaması lication Insights telemetri desteği eklemenize olanak tanır. Application Insights kapsayıcınızın derinlemesine izlenmesini sağlar. Kullanılabilirlik, performans ve kullanım için kapsayıcınızı kolayca izleyebilirsiniz. Ayrıca kapsayıcınızdaki hataları hızla belirleyebilir ve tanılayabilirsiniz.

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

Zorunlu Veri Akışı Adı Veri türü Açıklama
Hayır InstrumentationKey String Kapsayıcı için telemetri verilerinin gönderildiği Application Insights örneğinin izleme anahtarı. Daha fazla bilgi için bkz . ASP.NET Core için Application Insights.

Örnek:
InstrumentationKey=123456789

Faturalama yapılandırma ayarı

ayarı, Billing kapsayıcının faturalama bilgilerini ölçerken kullanılan Azure'daki Translator kaynağının uç nokta URI'sini belirtir. Bu yapılandırma ayarı için bir değer belirtmeniz ve değerin Azure'daki Translator kaynağı için geçerli bir uç nokta URI'si olması gerekir. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir.

Bu ayar aşağıdaki yerde bulunabilir:

  • Azure portalı: Translator Genel Bakış sayfası etiketli Endpoint
Zorunlu Veri Akışı Adı Veri türü Açıklama
Yes Billing String Faturalama uç noktası URI'si. Faturalama URI'sini alma hakkında daha fazla bilgi için bkz . Gerekli parametreleri toplama. Daha fazla bilgi ve bölgesel uç noktaların tam listesi için bkz . Azure AI hizmetleri için özel alt etki alanı adları.

EULA ayarı

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

Zorunlu Veri Akışı Adı Veri türü Açıklama
Yes Eula String Lisans kabulü

Örnek:
Eula=accept

Azure yapay zeka hizmetleri kapsayıcıları, Azure kullanımınızı yöneten sözleşmeniz kapsamında lisanslandırılır. Azure kullanımınızı yöneten mevcut bir sözleşmeniz yoksa, Azure kullanımını düzenleyen sözleşmenizin, Çevrimiçi Hizmetler Koşulları'nı içeren Microsoft Çevrimiçi Abonelik Sözleşmesi olduğunu kabul edersiniz. Önizlemeler için Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'nı da kabul edersiniz. Kapsayıcıyı kullanarak bu koşulları kabul etmiş olursunuz.

Fluentd ayarları

Fluentd, birleşik günlük kaydı için açık kaynak bir veri toplayıcıdır. Ayarlar kapsayıcının Fluentd Fluentd sunucusuyla bağlantısını yönetir. Kapsayıcı, kapsayıcınızın fluentd sunucusuna günlükleri ve isteğe bağlı olarak ölçüm verilerini yazmasına olanak tanıyan bir Fluentd günlük sağlayıcısı içerir.

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

Veri Akışı Adı Veri türü Açıklama
Host String Fluentd sunucusunun IP adresi veya DNS ana bilgisayar adı.
Port Tamsayı Fluentd sunucusunun bağlantı noktası.
Varsayılan değer 24224'dür.
HeartbeatMs Tamsayı Milisaniye cinsinden sinyal aralığı. Bu süre dolmadan önce hiçbir olay trafiği gönderilmediyse Fluentd 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ı Fluentd sunucusuyla SSL/TLS bağlantısı kurmak için milisaniye cinsinden zaman aşımı. Varsayılan değer 10000 milisaniyedir (10 saniye).
false olarak ayarlanırsa UseTLS , bu değer yoksayılır.
UseTLS Boolean Kapsayıcının Fluentd sunucusuyla iletişim kurmak için SSL/TLS kullanıp kullanmayacağını gösterir. Varsayılan değer olarak yanlış kullanılır.

HTTP/HTTPS proxy kimlik bilgileri ayarları

Giden istekler yapmak için bir HTTP ara sunucusu yapılandırmanız gerekiyorsa, şu iki bağımsız değişkeni kullanın:

Veri Akışı Adı Veri türü Açıklama
HTTPS_PROXY Dize Ara sunucu URL'si, örneğin, https://proxy:8888
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>

Günlüğe kaydetme ayarları

Translator kapsayıcıları aşağıdaki günlük sağlayıcılarını destekler:

Provider Purpose
Konsol ASP.NET Core Console günlük sağlayıcısı. Bu günlük sağlayıcısı için tüm 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ük sağlayıcısı için tüm 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ük sağlayıcısı günlük verilerini çıkış bağlamasına yazar.
  • Ayarlar Logging , kapsayıcınız için ASP.NET Core günlük desteğini yönetir. Kapsayıcınız için bir ASP.NET Core uygulaması için kullandığınız yapılandırma ayarlarını ve değerlerini kullanabilirsiniz.

  • , Logging.LogLevel günlüğe kaydedilecek en düşük düzeyi belirtir. Önem derecesi LogLevel 0 ile 6 arasında değişir. belirtildiğinde LogLevel , belirtilen düzeyde ve daha yüksek bir düzeydeki iletiler için günlüğe kaydetme etkinleştirilir: İzleme = 0, Hata Ayıklama = 1, Bilgi = 2, Uyarı = 3, Hata = 4, Kritik = 5, Yok = 6.

  • Şu anda Translator kapsayıcıları Uyarı LogLevel veya sonraki sürümlerde günlükleri kısıtlayabilir.

Günlüğe kaydetmeye yönelik genel komut söz dizimi aşağıdaki gibidir:

    -Logging:LogLevel:{Provider}={FilterSpecs}

Aşağıdaki komut Docker kapsayıcısını LogLevel Uyarı ve günlük sağlayıcısı konsolu olarak ayarlanmış olarak başlatır. Bu komut, konsola uygulama akışı sırasında anormal veya beklenmeyen olayları yazdırır:

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 günlüğü

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

Veri Akışı Adı Veri türü Açıklama
Format String Günlük dosyalarının çıkış biçimi.
Not: Günlük sağlayıcısını json etkinleştirmek için bu değer olarak ayarlanmalıdır. Bu değer kapsayıcı örneği oluşturulurken çı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ı yeni bir günlük dosyası başlatır. -1 belirtilirse, günlük dosyasının boyutu yalnızca çıktı bağlaması için en büyük dosya boyutuyla (varsa) sınırlıdır. Varsayılan değer 1 şeklindedir.

Disk sağlayıcısı örneği

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 günlük kaydını 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ıdan veri okumak ve yazmak için bağlama bağlamalarını kullanın. Docker run komutunda seçeneğini belirterek --mount bir giriş bağlaması veya çıkış bağlaması belirtebilirsiniz.

Sonraki adımlar