Installeren en uitvoeren van de Face-containersInstall and run Face containers

Azure Cognitive Services Face biedt een gestandaardiseerde Linux-container voor Docker die menselijke gezichten in afbeeldingen detecteert.Azure Cognitive Services Face provides a standardized Linux container for Docker that detects human faces in images. Het identificeert ook kenmerken, waaronder gezichtsoriëntatiepunten, zoals hartstukken en onder ogen krijgt, geslacht, leeftijd en andere machine voorspeld gezichtskenmerken.It also identifies attributes, which include face landmarks such as noses and eyes, gender, age, and other machine-predicted facial features. Naast detectie, kunt Face controleren als twee gezichten in dezelfde afbeelding of andere installatiekopieën dezelfde met een betrouwbaarheidsscore zijn.In addition to detection, Face can check if two faces in the same image or different images are the same by using a confidence score. Face kunt ook gezichten op een database om te zien of er al een gezicht gelijkende of identieke bestaat vergelijken.Face also can compare faces against a database to see if a similar-looking or identical face already exists. Deze kunt ook vergelijkbare gezichten in groepen indelen met behulp van gedeelde visuele kenmerken.It also can organize similar faces into groups by using shared visual traits.

Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

VereistenPrerequisites

U moet voldoen aan de volgende vereisten voordat u de Face-API-containers gebruiken.You must meet the following prerequisites before you use the Face API containers.

VereistRequired DoelPurpose
Docker-EngineDocker Engine De Docker-Engine moet zijn geïnstalleerd op een hostcomputer.The Docker Engine must be installed on a host computer. Docker biedt pakketten die de Docker-omgeving configureren op macOS, Windows, en Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Zie voor een uitleg van de basisprincipes van Docker en containers, de dockeroverzicht.For a primer on Docker and container basics, see the Docker overview.

Docker moet worden geconfigureerd, zodat de containers om te verbinden met en facturering gegevens verzenden naar Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

Op Windows, worden Docker ook geconfigureerd ter ondersteuning van Linux-containers.On Windows, Docker also must be configured to support Linux containers.

Vertrouwd zijn met DockerFamiliarity with Docker Moet u een basiskennis hebt van Docker-kernconcepten zoals registers, -opslagplaatsen, containers en containerinstallatiekopieën.You need a basic understanding of Docker concepts, such as registries, repositories, containers, and container images. U moet ook kennis van basic docker opdrachten.You also need knowledge of basic docker commands.
Azure Cognitive Services resourceAzure Cognitive Services resource Voor het gebruik van de container, moet u het volgende hebben:To use the container, you must have:

Een Azure Cognitive Services-resource en de bijbehorende facturering sleutel en de facturering URI van het eindpunt.An Azure Cognitive Services resource and the associated billing key and the billing endpoint URI. Beide waarden zijn beschikbaar op de overzicht en sleutels pagina's voor de resource.Both values are available on the Overview and Keys pages for the resource. Deze moeten de container te starten.They're required to start the container. Voeg de face/v1.0 routering naar het eindpunt-URI, zoals wordt weergegeven in het volgende BILLING_ENDPOINT_URI-voorbeeld:Add the face/v1.0 routing to the endpoint URI, as shown in the following BILLING_ENDPOINT_URI example:

{BILLING_KEY} : bronsleutel{BILLING_KEY}: resource key

{BILLING_ENDPOINT_URI} : voorbeeld van de eindpunt-URI is https://westus.api.cognitive.microsoft.com/face/v1.0{BILLING_ENDPOINT_URI}: endpoint URI example is https://westus.api.cognitive.microsoft.com/face/v1.0

Aanvraag voor toegang tot de privécontainerregisterRequest access to the private container registry

Invullen en verzenden de Cognitive Services beeld Containers aanvraagformulier toegang vragen tot de container.Fill out and submit the Cognitive Services Vision Containers Request form to request access to the container. Het formulier vraagt om informatie over u, uw bedrijf en het scenario voor gebruikers waarvoor u de container gebruikt.The form requests information about you, your company, and the user scenario for which you'll use the container. Nadat u het formulier hebt verzonden, controleert het team van Azure Cognitive Services om er zeker van te zijn dat u voldoet aan de criteria voor toegang tot de persoonlijke container registry.After you submit the form, the Azure Cognitive Services team reviews it to make sure that you meet the criteria for access to the private container registry.

Belangrijk

U moet een e-mailadres dat is gekoppeld aan een Microsoft-Account (MSA) of Azure Active Directory (Azure AD)-account in het formulier.You must use an email address associated with either a Microsoft Account (MSA) or an Azure Active Directory (Azure AD) account in the form.

Als uw aanvraag is goedgekeurd, ontvangt u een e-mailbericht met instructies over het verkrijgen van uw referenties en toegang tot het privé-container-register.If your request is approved, you receive an email with instructions that describe how to obtain your credentials and access the private container registry.

Meld u aan bij de privé containerregisterLog in to the private container registry

Er zijn verschillende manieren om te verifiëren met de privécontainerregister voor Cognitive Services-containers.There are several ways to authenticate with the private container registry for Cognitive Services containers. Het is raadzaam dat u de methode via de opdrachtregel met behulp van gebruiken de Docker-Opdrachtregelinterface.We recommend that you use the command-line method by using the Docker CLI.

Gebruik de dockeraanmelding opdracht, zoals wordt weergegeven in het volgende voorbeeld, voor aanmelding bij containerpreview.azurecr.io, dit is de privécontainerregister voor Cognitive Services-containers.Use the docker login command, as shown in the following example, to log in to containerpreview.azurecr.io, which is the private container registry for Cognitive Services containers. Vervang <gebruikersnaam> met de naam van de gebruiker en <wachtwoord> met het wachtwoord dat is opgegeven in de referenties die u hebt ontvangen van de Azure Cognitive Services-team.Replace <username> with the user name and <password> with the password provided in the credentials you received from the Azure Cognitive Services team.

docker login containerpreview.azurecr.io -u <username> -p <password>

Als u uw referenties in een tekstbestand beveiligd, kunt u de inhoud van het tekstbestand op samenvoegen de docker login opdracht.If you secured your credentials in a text file, you can concatenate the contents of that text file to the docker login command. Gebruik de cat opdracht, zoals wordt weergegeven in het volgende voorbeeld.Use the cat command, as shown in the following example. Vervang <passwordFile> met het pad en de naam van het tekstbestand dat het wachtwoord bevat.Replace <passwordFile> with the path and name of the text file that contains the password. Vervang <gebruikersnaam> met de naam van de gebruiker opgegeven in uw referenties.Replace <username> with the user name provided in your credentials.

cat <passwordFile> | docker login containerpreview.azurecr.io -u <username> --password-stdin

De hostcomputerThe host computer

De host is een x64 64-computer met de Docker-container.The host is a x64-based computer that runs the Docker container. Er is een computer op uw locatie of een Docker-host-service in Azure, zoals:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Containervereisten en aanbevelingenContainer requirements and recommendations

De volgende tabel beschrijft de minimale en aanbevolen CPU-kernen en geheugen toewijzen voor elke container Face-API.The following table describes the minimum and recommended CPU cores and memory to allocate for each Face API container.

ContainerContainer MinimumMinimum AanbevolenRecommended Transacties per secondeTransactions per second
(Minimum, maximum)(Minimum, maximum)
FaceFace 1 core, 2 GB geheugen1 core, 2-GB memory 1 core, 4 GB geheugen1 core, 4-GB memory 10, 2010, 20
  • Elke core moet ten minste 2,6 GHz of sneller.Each core must be at least 2.6 GHz or faster.
  • Transacties per seconde (TPS).Transactions per second (TPS).

Kernen en geheugen komen overeen met de --cpus en --memory instellingen die worden gebruikt als onderdeel van de docker run opdracht.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

De installatiekopie van de container met docker pull ophalenGet the container image with docker pull

Containerinstallatiekopieën voor de Face-API zijn beschikbaar.Container images for the Face API are available.

ContainerContainer OpslagplaatsRepository
FaceFace containerpreview.azurecr.io/microsoft/cognitive-services-face:latest

Tip

U kunt de docker-installatiekopieën opdracht om een lijst van uw gedownloade containerinstallatiekopieën.You can use the docker images command to list your downloaded container images. De volgende opdracht worden bijvoorbeeld de ID, de opslagplaats en het label van elke gedownloade containerinstallatiekopie, opgemaakt als een tabel:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID            REPOSITORY              TAG
ebbee78a6baa       <container-name>         latest

Docker pull voor de Face-containerDocker pull for the Face container

docker pull containerpreview.azurecr.io/microsoft/cognitive-services-face:latest

De container gebruikenUse the container

Nadat de container wordt op de hostcomputer, de volgende procedure gebruiken om te werken met de container.After the container is on the host computer, use the following process to work with the container.

  1. Uitvoeren van de container facturering met de vereiste instellingen.Run the container with the required billing settings. Meer voorbeelden van de docker run opdrachten zijn beschikbaar.More examples of the docker run command are available.
  2. Query van de container voorspelling eindpunt.Query the container's prediction endpoint.

Uitvoeren van de container met docker uitvoerenRun the container with docker run

Gebruik de docker uitvoeren opdracht uit te voeren op een van de drie containers.Use the docker run command to run any of the three containers. De opdracht maakt gebruik van de volgende parameters.The command uses the following parameters.

Tijdelijke aanduidingPlaceholder ValueValue
{BILLING_KEY}{BILLING_KEY} Deze sleutel wordt gebruikt voor het starten van de container en is beschikbaar op de Azure Cognitive Services sleutels pagina.This key is used to start the container and is available on the Azure Cognitive Services Keys page.
{BILLING_ENDPOINT_URI}{BILLING_ENDPOINT_URI} Het eindpunt van de facturering URI-waarde is beschikbaar op de Azure Cognitive Services overzicht pagina.The billing endpoint URI value is available on the Azure Cognitive Services Overview page. Een voorbeeld is https://westus.api.cognitive.microsoft.com/face/v1.0.An example is https://westus.api.cognitive.microsoft.com/face/v1.0.

Voeg de face/v1.0 routering naar het eindpunt-URI, zoals wordt weergegeven in het voorgaande voorbeeld van BILLING_ENDPOINT_URI.Add the face/v1.0 routing to the endpoint URI, as shown in the preceding BILLING_ENDPOINT_URI example.

Deze parameters vervangen door uw eigen waarden in de volgende docker run opdracht:Replace these parameters with your own values in the following docker run command example:

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
containerpreview.azurecr.io/microsoft/cognitive-services-face \
Eula=accept \
Billing={BILLING_ENDPOINT_URI} \
ApiKey={BILLING_KEY}

Met deze opdracht:This command:

  • Hiermee wordt een container face installatiekopie van de container.Runs a face container from the container image.
  • Één CPU-kern en 4 GB geheugen worden toegewezen.Allocates one CPU core and 4 GB of memory.
  • Gebruikt TCP-poort 5000 en wijst er een pseudo TTY voor de container.Exposes TCP port 5000 and allocates a pseudo TTY for the container.
  • De container worden automatisch verwijderd nadat deze is afgesloten.Automatically removes the container after it exits. De containerinstallatiekopie is nog steeds beschikbaar op de hostcomputer.The container image is still available on the host computer.

Meer voorbeelden van de docker run opdrachten zijn beschikbaar.More examples of the docker run command are available.

Belangrijk

De Eula, Billing, en ApiKey opties moeten worden opgegeven voor het uitvoeren van de container of de container start niet.The Eula, Billing, and ApiKey options must be specified to run the container or the container won't start. Zie voor meer informatie, facturering.For more information, see Billing.

Meerdere containers op dezelfde host worden uitgevoerdRun multiple containers on the same host

Als u van plan bent om uit te voeren van meerdere containers met blootgestelde poorten, zorg ervoor dat elke container uitvoeren met een andere poort weergegeven.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Bijvoorbeeld: de eerste container op poort 5000- en de tweede container uitvoeren op poort 5001.For example, run the first container on port 5000 and the second container on port 5001.

U kunt deze container en een andere Azure Cognitive Services-container wordt uitgevoerd op de HOST bij elkaar hebben.You can have this container and a different Azure Cognitive Services container running on the HOST together. U kunt ook meerdere containers van de dezelfde Cognitive Services-container die wordt uitgevoerd hebben.You also can have multiple containers of the same Cognitive Services container running.

Query uitvoeren op het eindpunt voorspelling van de containerQuery the container's prediction endpoint

De container biedt eindpunt van de voorspelling query op basis van REST API's.The container provides REST-based query prediction endpoint APIs.

Gebruikmaken van de host https://localhost:5000, voor de container met API's.Use the host, https://localhost:5000, for container APIs.

Valideren dat een container wordt uitgevoerdValidate that a container is running

Er zijn verschillende manieren om te valideren dat de container wordt uitgevoerd.There are several ways to validate that the container is running.

AanvragenRequest DoelPurpose
http://localhost:5000/ De container biedt een startpagina.The container provides a home page.
http://localhost:5000/status Aangevraagd met GET, om te valideren dat de container wordt uitgevoerd zonder dat een eindpunt-query.Requested with GET, to validate that the container is running without causing an endpoint query. Deze aanvraag kan worden gebruikt voor Kubernetes liveness en gereedheid voor tests.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger De container biedt een volledige set met documentatie voor de eindpunten en een Try it now functie.The container provides a full set of documentation for the endpoints and a Try it now feature. Met deze functie kunt u uw instellingen invoeren in een web gebaseerde HTML-formulier en de query te maken zonder code te schrijven.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Nadat de query retourneert, wordt een voorbeeld van de CURL-opdracht opgegeven om te demonstreren dat de HTTP-headers en hoofdtekst van de indeling die is vereist.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

Startpagina van de container

De container stoppenStop the container

Als u wilt afsluiten van de container, in de opdrachtregelomgeving waarop de container wordt uitgevoerd, selecteert u Ctrl + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

Problemen oplossenTroubleshooting

Als u de container wordt uitgevoerd met een uitvoer koppelen en logboekregistratie is ingeschakeld, wordt de container genereert logboekbestanden die tot het oplossen van problemen die optreden tijdens het starten of uitvoeren van de container.If you run the container with an output mount and logging is enabled, the container generates log files that are helpful to troubleshoot issues that happen while you start or run the container.

FactureringBilling

De Face-API-containers voor het verzenden van factureringsgegevens naar Azure met behulp van een resource Face-API voor uw Azure-account.The Face API containers send billing information to Azure by using a Face API resource on your Azure account.

Query's naar de container in rekening gebracht volgens de prijscategorie van de Azure-resource die wordt gebruikt voor de <ApiKey>.Queries to the container are billed at the pricing tier of the Azure resource used for the <ApiKey>.

Azure Cognitive Services-containers worden niet gelicentieerd voor het uitvoeren zonder verbinding met het factuuradres eindpunt voor het meten.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. U moet de containers om te communiceren factureringsgegevens met het eindpunt van de facturering te allen tijde inschakelen.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services-containers verzenden geen gegevens van de klant, zoals de afbeelding of tekst die wordt geanalyseerd, naar Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Verbinding maken met AzureConnect to Azure

De container moet de facturering argumentwaarden om uit te voeren.The container needs the billing argument values to run. Deze waarden kunnen de container verbinding maken met het eindpunt van de facturering.These values allow the container to connect to the billing endpoint. Gebruik de container rapporteert over elke 10 tot 15 minuten.The container reports usage about every 10 to 15 minutes. Als de container geen verbinding met Azure binnen de toegestane periode maken, de container blijft om uit te voeren, maar niet query's leveren totdat het eindpunt van de facturering is hersteld.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. De verbinding wordt geprobeerd 10 keer met de dezelfde tijdsinterval van 10 tot 15 minuten.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Als er geen verbinding met het eindpunt van de facturering in het 10 probeert, de container niet meer werkt.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

Facturering-argumentenBilling arguments

Alle drie van de volgende opties moet worden opgegeven met geldige waarden voor de docker run opdracht om te beginnen de container.All three of the following options must be specified with valid values in order for the docker run command to start the container.

OptieOption DescriptionDescription
ApiKey De API-sleutel van de Cognitive Services-resource die is gebruikt voor het bijhouden van informatie over facturering.The API key of the Cognitive Services resource used to track billing information.
De waarde van deze optie moet worden ingesteld op een API-sleutel voor de ingerichte resource die is opgegeven Billing.The value of this option must be set to an API key for the provisioned resource specified in Billing.
Billing Het eindpunt van de Cognitive Services-resource die is gebruikt voor het bijhouden van informatie over facturering.The endpoint of the Cognitive Services resource used to track billing information.
De waarde van deze optie moet worden ingesteld op de URI van een ingerichte Azure-resource van het eindpunt.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Geeft aan dat u de licentie voor de container hebt geaccepteerd.Indicates that you accepted the license for the container.
De waarde van deze optie moet worden ingesteld op accept.The value of this option must be set to accept.

Zie voor meer informatie over deze opties containers configureren.For more information about these options, see Configure containers.

SamenvattingSummary

In dit artikel hebt u geleerd concepten en werkstroom voor het downloaden, installeren en uitvoeren van de Face-API-containers.In this article, you learned concepts and workflow for how to download, install, and run Face API containers. Samenvatting:In summary:

  • De Face-API biedt drie Linux-containers voor Docker sleuteltermextractie, taaldetectie en sentimentanalyse.The Face API provides three Linux containers for Docker that provide key phrase extraction, language detection, and sentiment analysis.
  • Containerinstallatiekopieën worden gedownload van Azure Container Registry.Container images are downloaded from the Azure Container Registry.
  • Containerinstallatiekopieën uitvoeren in Docker.Container images run in Docker.
  • U kunt de REST-API of de SDK gebruiken om aan te roepen van bewerkingen in containers Face-API door de host-URI van de container op te geven.You can use either the REST API or the SDK to call operations in Face API containers by specifying the host URI of the container.
  • Wanneer u een container, moet u informatie over facturering opgeven.You must specify billing information when you instantiate a container.

Belangrijk

Cognitive Services-containers worden niet gelicentieerd voor het uitvoeren zonder verbinding met Azure voor het meten.Cognitive Services containers aren't licensed to run without being connected to Azure for metering. Klanten moeten de containers om te communiceren factureringsgegevens met de softwarelicentiecontrole-service te allen tijde inschakelen.Customers must enable the containers to communicate billing information with the metering service at all times. Cognitive Services-containers verzenden geen gegevens van de klant, zoals de afbeelding of tekst die wordt geanalyseerd, naar Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Volgende stappenNext steps