Delen via

Docker-containers Vertalen configureren

  • Artikel

Azure AI-services bieden elke container een gemeenschappelijk configuratieframework. U kunt uw Vertalen-containers eenvoudig configureren om Vertalen toepassingsarchitectuur te bouwen die is geoptimaliseerd voor robuuste cloudmogelijkheden en randlocatie.

De Vertalen containerruntimeomgeving wordt geconfigureerd met behulp van de docker run opdrachtargumenten. Deze container heeft zowel vereiste als optionele instellingen. De vereiste containerspecifieke instellingen zijn de factureringsinstellingen.

Configuratie-instellingen

De container heeft de volgende configuratie-instellingen:

Vereist Instelling Purpose
Ja ApiKey Houdt factureringsgegevens bij.
Nee ApplicationInsights Hiermee kunt u telemetrische ondersteuning voor Azure-toepassing Insights toevoegen aan uw container.
Ja Facturering Hiermee geeft u de eindpunt-URI van de serviceresource in Azure op.
Ja OVEREENKOMST Geeft aan dat u de gebruiksrechtovereenkomst (EULA) voor de container hebt geaccepteerd.
Nee Fluentd Hiermee schrijft u logboekgegevens en eventueel metrische gegevens naar een Fluentd-server.
Nee HTTP-proxy Hiermee configureert u een HTTP-proxy voor het maken van uitgaande aanvragen.
Nee Logboekregistratie Biedt ondersteuning voor ASP.NET Core-logboekregistratie voor uw container.
Ja Mounts Leest en schrijft gegevens van de hostcomputer naar de container en van de container terug naar de hostcomputer.

Belangrijk

De APIKey-, facturerings- en GEBRUIKSRECHTOVEREENKOMST-instellingen worden samen gebruikt en u moet geldige waarden opgeven voor alle drie. Anders wordt uw container niet gestart. Voor meer informatie over het gebruik van deze configuratie-instellingen om een container te instantiëren.

ApiKey-configuratie-instelling

Met ApiKey de instelling geeft u de Azure-resourcesleutel op die wordt gebruikt om factureringsgegevens voor de container bij te houden. U moet een waarde opgeven voor de ApiKey en de waarde moet een geldige sleutel zijn voor de Vertalen resource die is opgegeven voor de Billing configuratie-instelling.

Deze instelling vindt u op de volgende plaats:

  • Azure Portal: Vertalen resourcebeheer onder Sleutels

ApplicationInsights-instelling

Met de ApplicationInsights instelling kunt u Azure-toepassing insights-telemetrieondersteuning toevoegen aan uw container. Application Insights biedt uitgebreide bewaking van uw container. U kunt uw container eenvoudig controleren op beschikbaarheid, prestaties en gebruik. U kunt ook snel fouten in uw container identificeren en diagnosticeren.

In de volgende tabel worden de configuratie-instellingen beschreven die worden ondersteund in de ApplicationInsights sectie.

Vereist Naam Gegevenstype Beschrijving
Nee InstrumentationKey String De instrumentatiesleutel van het Application Insights-exemplaar waarnaar telemetriegegevens voor de container worden verzonden. Zie Application Insights voor ASP.NET Core voor meer informatie.

Voorbeeld:
InstrumentationKey=123456789

Configuratie-instelling voor facturering

De Billing instelling geeft de eindpunt-URI op van de Vertalen-resource in Azure die wordt gebruikt om factureringsgegevens voor de container te meten. U moet een waarde opgeven voor deze configuratie-instelling en de waarde moet een geldige eindpunt-URI zijn voor een Vertalen-resource in Azure. De container rapporteert ongeveer om de 10 tot 15 minuten het gebruik.

Deze instelling vindt u op de volgende plaats:

  • Azure Portal: Vertalen overzichtspagina met het labelEndpoint
Vereist Naam Gegevenstype Beschrijving
Ja Billing String Eindpunt-URI voor facturering. Zie het verzamelen van vereiste parameters voor meer informatie over het verkrijgen van de facturerings-URI. Zie Aangepaste subdomeinnamen voor Azure AI-services voor meer informatie en een volledige lijst met regionale eindpunten.

EULA-instelling

De Eula instelling geeft aan dat u de licentie voor de container hebt geaccepteerd. U moet een waarde opgeven voor deze configuratie-instelling en de waarde moet worden ingesteld op accept.

Vereist Naam Gegevenstype Beschrijving
Ja Eula String Licentie-acceptatie

Voorbeeld:
Eula=accept

Azure AI-servicescontainers worden in licentie gegeven onder uw overeenkomst voor uw gebruik van Azure. Als u geen bestaande overeenkomst hebt voor uw gebruik van Azure, gaat u ermee akkoord dat uw overeenkomst voor het gebruik van Azure de Microsoft Online-abonnementsovereenkomst is, die de voorwaarden voor onlineservices bevat. Voor previews gaat u ook akkoord met de aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews. Door de container te gebruiken, gaat u akkoord met deze voorwaarden.

Fluentd-instellingen

Fluentd is een opensource-gegevensverzamelaar voor geïntegreerde logboekregistratie. De Fluentd instellingen beheren de verbinding van de container met een Fluentd-server . De container bevat een Fluentd-logboekregistratieprovider, waarmee uw container logboeken kan schrijven en, optioneel, metrische gegevens naar een Fluentd-server.

In de volgende tabel worden de configuratie-instellingen beschreven die worden ondersteund in de Fluentd sectie.

Naam Gegevenstype Beschrijving
Host String Het IP-adres of de DNS-hostnaam van de Fluentd-server.
Port Geheel getal De poort van de Fluentd-server.
De standaardwaarde is 24224.
HeartbeatMs Geheel getal Het heartbeatinterval, in milliseconden. Als er geen gebeurtenisverkeer is verzonden voordat dit interval verloopt, wordt een heartbeat verzonden naar de Fluentd-server. De standaardwaarde is 60000 milliseconden (1 minuut).
SendBufferSize Geheel getal De netwerkbufferruimte, in bytes, die is toegewezen voor verzendbewerkingen. De standaardwaarde is 32768 bytes (32 kilobytes).
TlsConnectionEstablishmentTimeoutMs Geheel getal De time-out, in milliseconden, om een SSL/TLS-verbinding tot stand te brengen met de Fluentd-server. De standaardwaarde is 10000 milliseconden (10 seconden).
Als UseTLS deze waarde is ingesteld op false, wordt deze waarde genegeerd.
UseTLS Booleaanse waarde Geeft aan of de container SSL/TLS moet gebruiken voor communicatie met de Fluentd-server. De standaardwaarde is false.

Instellingen voor HTTP/HTTPS-proxyreferenties

Als u een HTTP-proxy wilt configureren voor het maken van uitgaande aanvragen, gebruikt u deze twee argumenten:

Naam Gegevenstype Beschrijving
HTTPS_PROXY tekenreeks De proxy-URL, bijvoorbeeld 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>

Instellingen voor logboekregistratie

Vertalen containers ondersteunen de volgende logboekproviders:

Provider Doel
Console De ASP.NET Core-logboekregistratieprovider Console . Alle ASP.NET Core-configuratie-instellingen en standaardwaarden voor deze logboekregistratieprovider worden ondersteund.
Fouten opsporen De ASP.NET Core-logboekregistratieprovider Debug . Alle ASP.NET Core-configuratie-instellingen en standaardwaarden voor deze logboekregistratieprovider worden ondersteund.
schijf De JSON-logboekregistratieprovider. Deze logboekprovider schrijft logboekgegevens naar de uitvoerkoppeling.

  • De Logging instellingen beheren ASP.NET Core-logboekregistratieondersteuning voor uw container. U kunt dezelfde configuratie-instellingen en -waarden gebruiken voor uw container die u gebruikt voor een ASP.NET Core-toepassing.

  • Hiermee Logging.LogLevel geeft u het minimumniveau op dat moet worden vastgelegd. De ernst van de LogLevel reeksen varieert van 0 tot 6. Wanneer een LogLevel opgegeven is, wordt logboekregistratie ingeschakeld voor berichten op het opgegeven niveau en hoger: Trace = 0, Foutopsporing = 1, Informatie = 2, Waarschuwing = 3, Fout = 4, Kritiek = 5, Geen = 6.

  • Op dit moment hebben Vertalen containers de mogelijkheid om logboeken te beperken op waarschuwingslogboekniveau of hoger.

De algemene opdrachtsyntaxis voor logboekregistratie is als volgt:

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

Met de volgende opdracht wordt de Docker-container gestart met de LogLevel set waarschuwing en logboekregistratieprovider ingesteld op Console. Met deze opdracht worden afwijkende of onverwachte gebeurtenissen afgedrukt tijdens de toepassingsstroom naar de console:

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

Schijflogboekregistratie

De Disk logboekregistratieprovider ondersteunt de volgende configuratie-instellingen:

Naam Gegevenstype Beschrijving
Format String De uitvoerindeling voor logboekbestanden.
Opmerking: deze waarde moet worden ingesteld om json de logboekregistratieprovider in te schakelen. Als deze waarde is opgegeven zonder ook een uitvoerkoppeling op te geven tijdens het instantiëren van een container, treedt er een fout op.
MaxFileSize Geheel getal De maximale grootte, in megabytes (MB), van een logboekbestand. Wanneer de grootte van het huidige logboekbestand aan deze waarde voldoet of overschrijdt, start de logboekprovider een nieuw logboekbestand. Als -1 is opgegeven, wordt de grootte van het logboekbestand alleen beperkt door de maximale bestandsgrootte, indien aanwezig, voor de uitvoerkoppeling. De standaardwaarde is 1.

Voorbeeld van schijfprovider

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

Zie Instellingen bestandsconfiguratie voor meer informatie over het configureren van ondersteuning voor ASP.NET Core-logboekregistratie.

Instellingen koppelen

Gebruik bindingskoppelingen om gegevens naar en van de container te lezen en te schrijven. U kunt een invoerkoppeling of uitvoerkoppeling opgeven door de --mount optie op te geven in de opdracht docker-run .

Volgende stappen

Meer informatie over Azure AI-containers