Konfigurowanie kontenerów platformy Docker usługi językowej

Usługa językowa udostępnia każdemu kontenerowi wspólną strukturę konfiguracji, dzięki czemu można łatwo skonfigurować magazyn, rejestrowanie i telemetrię oraz ustawienia zabezpieczeń dla kontenerów oraz zarządzać nimi. Ten artykuł dotyczy następujących kontenerów:

  • Analiza tonacji
  • Wykrywanie języka
  • Wyodrębnianie kluczowych fraz
  • Analiza tekstu dla opieki zdrowotnej
  • Podsumowanie
  • Rozpoznawanie jednostek nazwanych

Ustawienia konfiguracji

Kontener ma następujące ustawienia konfiguracji:

Wymagania Ustawienie Purpose
Tak ApiKey Śledzi informacje o rozliczeniach.
Nie. ApplicationInsights Umożliwia dodawanie obsługi telemetrii aplikacja systemu Azure Szczegółowe informacje do kontenera.
Tak Rozliczenia Określa identyfikator URI punktu końcowego zasobu usługi na platformie Azure.
Tak Eula Wskazuje, że zaakceptowano licencję dla kontenera.
Nie. Biegle Zapisuje dziennik i, opcjonalnie, dane metryk na serwerze Fluentd.
Nie. HTTP Proxy Konfiguruje serwer proxy HTTP do tworzenia żądań wychodzących.
Nie. Rejestrowanie Zapewnia obsługę rejestrowania ASP.NET Core dla kontenera.
Nie. Wierzchowce Odczytuje i zapisuje dane z komputera hosta do kontenera i z kontenera z powrotem do komputera hosta.

Ważne

Ustawienia ApiKey, Billingi są Eula używane razem i należy podać prawidłowe wartości dla wszystkich trzech z nich; w przeciwnym razie kontener nie zostanie uruchomiony.

Ustawienie konfiguracji apiKey

Ustawienie ApiKey określa klucz zasobu platformy Azure używany do śledzenia informacji rozliczeniowych dla kontenera. Należy określić wartość klucza i musi być prawidłowym kluczem zasobu Language określonym dla Billing ustawienia konfiguracji.

Ustawienie aplikacji Szczegółowe informacje

Ustawienie ApplicationInsights umożliwia dodanie aplikacja systemu Azure Szczegółowe informacje obsługi telemetrii do kontenera. Szczegółowe informacje aplikacji zapewnia szczegółowe monitorowanie kontenera. Kontener można łatwo monitorować pod kątem dostępności, wydajności i użycia. Możesz również szybko identyfikować i diagnozować błędy w kontenerze.

W poniższej tabeli opisano ustawienia konfiguracji obsługiwane w ApplicationInsights sekcji .

Wymagania Nazwisko Typ danych opis
Nie. InstrumentationKey String Klucz instrumentacji wystąpienia usługi Application Szczegółowe informacje, do którego są wysyłane dane telemetryczne dla kontenera. Aby uzyskać więcej informacji, zobacz Application Szczegółowe informacje for ASP.NET Core.

Przykład:
InstrumentationKey=123456789

Ustawienie konfiguracji rozliczeń

Ustawienie Billing określa identyfikator URI punktu końcowego zasobu language na platformie Azure używanego do pomiaru informacji rozliczeniowych dla kontenera. Musisz określić wartość dla tego ustawienia konfiguracji, a wartość musi być prawidłowym identyfikatorem URI punktu końcowego dla zasobu language na platformie Azure. Kontener raportuje użycie co około 10 do 15 minut.

Wymagania Nazwisko Typ danych opis
Tak Billing String Identyfikator URI punktu końcowego rozliczeń.

Ustawienie Eula

Ustawienie Eula wskazuje, że zaakceptowano licencję dla kontenera. Musisz określić wartość dla tego ustawienia konfiguracji, a wartość musi być ustawiona na acceptwartość .

Wymagania Nazwisko Typ danych opis
Tak Eula String Akceptacja licencji

Przykład:
Eula=accept

Kontenery usług AI platformy Azure są licencjonowane zgodnie z umową regulującą korzystanie z platformy Azure. Jeśli nie masz istniejącej umowy dotyczącej korzystania z platformy Azure, zgadzasz się, że Umowa rządząca korzystaniem z platformy Azure jest umową subskrypcji online firmy Microsoft, która obejmuje postanowienia dotyczące usług online. W przypadku wersji zapoznawczych zgadzasz się również na dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure. Korzystając z kontenera, akceptujesz te warunki.

Ustawienia fluentd

Fluentd to moduł zbierający dane typu open source do ujednoliconego rejestrowania. Ustawienia Fluentd zarządzają połączeniem kontenera z serwerem Fluentd . Kontener zawiera dostawcę rejestrowania Fluentd, który umożliwia kontenerowi zapisywanie dzienników i opcjonalnie danych metryk na serwerze Fluentd.

W poniższej tabeli opisano ustawienia konfiguracji obsługiwane w Fluentd sekcji .

Nazwisko Typ danych opis
Host String Adres IP lub nazwa hosta DNS serwera Fluentd.
Port Integer Port serwera Fluentd.
Wartość domyślna to 24224.
HeartbeatMs Integer Interwał pulsu w milisekundach. Jeśli żaden ruch zdarzeń nie został wysłany przed wygaśnięciem tego interwału, puls jest wysyłany do serwera Fluentd. Wartość domyślna to 60000 milisekund (1 minuta).
SendBufferSize Integer Miejsce buforu sieci w bajtach przydzielone do operacji wysyłania. Wartość domyślna to 32768 bajtów (32 kilobajty).
TlsConnectionEstablishmentTimeoutMs Integer Limit czasu ( w milisekundach) w celu nawiązania połączenia SSL/TLS z serwerem Fluentd. Wartość domyślna to 10000 milisekund (10 sekund).
Jeśli UseTLS ustawiono wartość false, ta wartość jest ignorowana.
UseTLS Wartość logiczna Wskazuje, czy kontener powinien używać protokołu SSL/TLS do komunikacji z serwerem Fluentd. Wartość domyślna to false.

Ustawienia poświadczeń serwera proxy http

Jeśli musisz skonfigurować serwer proxy HTTP do tworzenia żądań wychodzących, użyj następujących dwóch argumentów:

Nazwisko Typ danych opis
HTTP_PROXY string Serwer proxy do użycia, na przykład http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS string Wszelkie poświadczenia wymagane do uwierzytelnienia na serwerze proxy, na przykład username:password. Ta wartość musi być w małych literach.
<proxy-user> string Użytkownik serwera proxy.
<proxy-password> string Hasło skojarzone z <proxy-user> serwerem 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> \

Ustawienia rejestrowania

Ustawienia Logging zarządzają obsługą rejestrowania ASP.NET Core dla kontenera. Możesz użyć tych samych ustawień konfiguracji i wartości dla kontenera, który jest używany dla aplikacji ASP.NET Core.

Następujący dostawcy rejestrowania są obsługiwani przez kontener:

Provider Przeznaczenie
Konsola Dostawca rejestrowania ASP.NET Core Console . Obsługiwane są wszystkie ustawienia konfiguracji ASP.NET Core i wartości domyślne dla tego dostawcy rejestrowania.
Debug Dostawca rejestrowania ASP.NET Core Debug . Obsługiwane są wszystkie ustawienia konfiguracji ASP.NET Core i wartości domyślne dla tego dostawcy rejestrowania.
Disk Dostawca rejestrowania JSON. Ten dostawca rejestrowania zapisuje dane dziennika w instalacji wyjściowej.

To polecenie kontenera przechowuje informacje rejestrowania w formacie JSON do instalacji wyjściowej:

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

To polecenie kontenera wyświetla informacje debugowania z prefiksem dbug, gdy kontener jest uruchomiony:

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

Rejestrowanie dysku

Dostawca rejestrowania Disk obsługuje następujące ustawienia konfiguracji:

Nazwisko Typ danych opis
Format String Format danych wyjściowych dla plików dziennika.
Uwaga: ta wartość musi być ustawiona na wartość , aby json włączyć dostawcę rejestrowania. Jeśli ta wartość jest określona bez określania również instalacji wyjściowej podczas tworzenia wystąpienia kontenera, wystąpi błąd.
MaxFileSize Integer Maksymalny rozmiar w megabajtach (MB) pliku dziennika. Gdy rozmiar bieżącego pliku dziennika spełnia lub przekracza tę wartość, nowy plik dziennika jest uruchamiany przez dostawcę rejestrowania. Jeśli określono -1, rozmiar pliku dziennika jest ograniczony tylko przez maksymalny rozmiar pliku, jeśli istnieje, dla instalacji wyjściowej. Domyślna wartość wynosi 1.

Aby uzyskać więcej informacji na temat konfigurowania obsługi rejestrowania ASP.NET Core, zobacz Ustawienia konfiguracji plików.

Ustawienia instalacji

Użyj instalacji powiązania, aby odczytywać i zapisywać dane z i z kontenera. Możesz określić instalację wejściową lub instalację wyjściową, określając --mount opcję w poleceniu docker run .

Kontenery usługi językowej nie używają instalacji wejściowych ani wyjściowych do przechowywania danych szkoleniowych lub usług.

Dokładna składnia lokalizacji instalacji hosta różni się w zależności od systemu operacyjnego hosta. Ponadto lokalizacja instalacji komputera hosta może być niedostępna z powodu konfliktu między uprawnieniami używanymi przez konto usługi platformy Docker i uprawnieniami lokalizacji instalacji hosta.

Opcjonalnie Nazwisko Typ danych opis
Niedozwolone Input String Kontenery usług językowych nie używają tego.
Opcjonalnie Output String Element docelowy instalacji wyjściowej. Wartość domyślna to /output. Jest to lokalizacja dzienników. Obejmuje to dzienniki kontenerów.

Przykład:
--mount type=bind,src=c:\output,target=/output

Następne kroki