Konfigurowanie analiza tekstu dla kontenerów platformy Docker kondycji
analiza tekstu dla kondycji zapewnia 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. Dostępnych jest również kilka przykładowych poleceń uruchamiania platformy Docker .
Ustawienia konfiguracji
Kontener ma następujące ustawienia konfiguracji:
| Wymagane | Ustawienie | Przeznaczenie |
|---|---|---|
| Tak | ApiKey | Śledzi informacje o rozliczeniach. |
| Nie | ApplicationInsights | Umożliwia dodawanie obsługi telemetrii usługi aplikacja systemu Azure Insights 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 | Fluentd | 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. Aby uzyskać więcej informacji na temat używania tych ustawień konfiguracji do utworzenia wystąpienia kontenera, zobacz Rozliczenia.
Ustawienie konfiguracji apiKey
Ustawienie ApiKey określa klucz zasobu platformy Azure używany do śledzenia informacji rozliczeniowych dla kontenera. Musisz określić wartość elementu ApiKey, a wartość musi być prawidłowym kluczem zasobu language określonego Billing dla ustawienia konfiguracji.
To ustawienie można znaleźć w następującym miejscu:
- Azure Portal: Zarządzanie zasobami językowymi w obszarze Klucze i punkt końcowy
Ustawienie applicationInsights
Ustawienie ApplicationInsights umożliwia dodanie obsługi telemetrii usługi aplikacja systemu Azure Insights do kontenera. Usługa Application Insights zapewnia szczegółowe monitorowanie kontenera. Możesz łatwo monitorować kontener 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 .
| Wymagane | Nazwa | Typ danych | Opis |
|---|---|---|---|
| Nie | InstrumentationKey |
Ciąg | Klucz instrumentacji wystąpienia usługi Application Insights, do którego są wysyłane dane telemetryczne dla kontenera. Aby uzyskać więcej informacji, zobacz Application Insights for ASP.NET Core (Usługa Application Insights dla 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.
To ustawienie można znaleźć w następującym miejscu:
- Azure Portal: Przegląd języka z etykietą
Endpoint
| Wymagane | Nazwa | Typ danych | Opis |
|---|---|---|---|
| Tak | Billing |
Ciąg | Identyfikator URI punktu końcowego rozliczeń. Aby uzyskać więcej informacji na temat uzyskiwania identyfikatora URI rozliczeń, zobacz zbieranie wymaganych parametrów. Aby uzyskać więcej informacji i pełną listę regionalnych punktów końcowych, zobacz Niestandardowe nazwy poddomeny dla usług Azure AI. |
Ustawienie Umowy Licencyjnej
Ustawienie Eula wskazuje, że zaakceptowano licencję dla kontenera. Musisz określić wartość dla tego ustawienia konfiguracji, a wartość musi być ustawiona na acceptwartość .
| Wymagane | Nazwa | Typ danych | Opis |
|---|---|---|---|
| Tak | Eula |
Ciąg | Akceptacja licencji Przykład: Eula=accept |
Kontenery usług Azure AI są licencjonowane na mocy umowy dotyczącej korzystania z platformy Azure. Jeśli nie masz istniejącej umowy rządzącej korzystaniem 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 akceptujesz również dodatkowe warunki użytkowania 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 .
| Nazwa | Typ danych | Opis |
|---|---|---|
Host |
Ciąg | Adres IP lub nazwa hosta DNS serwera Fluentd. |
Port |
Liczba całkowita | Port serwera Fluentd. Wartość domyślna to 24224. |
HeartbeatMs |
Liczba całkowita | 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 |
Liczba całkowita | Miejsce buforu sieciowego w bajtach przydzielone do operacji wysyłania. Wartość domyślna to 32768 bajtów (32 kilobajty). |
TlsConnectionEstablishmentTimeoutMs |
Liczba całkowita | Przekroczenie limitu 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 wykonywania żądań wychodzących, użyj tych dwóch argumentów:
| Nazwa | Typ danych | Opis |
|---|---|---|
| HTTP_PROXY | ciąg | Serwer proxy do użycia, na przykład http://proxy:8888<proxy-url> |
| HTTP_PROXY_CREDS | ciąg | Wszelkie poświadczenia wymagane do uwierzytelnienia względem serwera proxy, na przykład username:password. Ta wartość musi być w małych literach. |
<proxy-user> |
ciąg | Użytkownik serwera proxy. |
<proxy-password> |
ciąg | 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 logowania
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órego używasz dla aplikacji ASP.NET Core.
Następujący dostawcy rejestrowania są obsługiwani przez kontener:
| Dostawca | Przeznaczenie |
|---|---|
| Konsola | Dostawca rejestrowania ASP.NET CoreConsole. Obsługiwane są wszystkie ustawienia konfiguracji ASP.NET Core i wartości domyślne dla tego dostawcy rejestrowania. |
| Debug | Dostawca rejestrowania ASP.NET CoreDebug. Obsługiwane są wszystkie ustawienia konfiguracji ASP.NET Core i wartości domyślne dla tego dostawcy rejestrowania. |
| Dysk | 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 o debugowaniu z prefiksem dbug, podczas 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:
| Nazwa | Typ danych | Opis |
|---|---|---|
Format |
Ciąg | Format danych wyjściowych dla plików dziennika. Uwaga: Tę wartość należy ustawić, aby json włączyć dostawcę rejestrowania. Jeśli ta wartość jest określona bez określania instalacji wyjściowej podczas tworzenia wystąpienia kontenera, wystąpi błąd. |
MaxFileSize |
Liczba całkowita | 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 wartość -1, rozmiar pliku dziennika jest ograniczony tylko przez maksymalny rozmiar pliku, jeśli istnieje, dla instalacji wyjściowej. Wartość domyślna to 1. |
Aby uzyskać więcej informacji na temat konfigurowania obsługi rejestrowania ASP.NET Core, zobacz Konfiguracja pliku ustawień.
Ustawienia instalacji
Użyj instalacji powiązanych, 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 .
analiza tekstu dla kontenerów kondycji nie używają instalacji wejściowych ani wyjściowych do przechowywania danych szkoleniowych ani 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.
| Opcjonalne | Nazwa | Typ danych | Opis |
|---|---|---|---|
| Niedozwolone | Input |
Ciąg | analiza tekstu dla kontenerów kondycji nie są używane. |
| Opcjonalne | Output |
Ciąg | 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 |