Face-containers installeren en uitvoerenInstall and run Face containers

Azure Cognitive Services gezicht 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. Er worden ook kenmerken geïdentificeerd, waaronder gezichts bezienswaardigheden zoals neus en ogen, geslacht, leeftijd en andere computer-voorspelde gezichts functies.It also identifies attributes, which include face landmarks such as noses and eyes, gender, age, and other machine-predicted facial features. Naast detectie kan het gezicht controleren of twee gezichten in dezelfde afbeelding of verschillende afbeeldingen hetzelfde zijn door gebruik te maken van een betrouwbaarheids Score.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. Gezicht kan ook gezichten vergelijken met een Data Base om te zien of er al een vergelijkbaar of identiek gezicht bestaat.Face also can compare faces against a database to see if a similar-looking or identical face already exists. Het kan ook vergelijk bare gezichten in groepen organiseren door gebruik te maken van gedeelde visuele elementen.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 gebruikt.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 voor het configureren van de docker-omgeving op macOS, Windowsen 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.

In Windows moet docker ook worden geconfigureerd voor de ondersteuning van Linux-containers.On Windows, Docker also must be configured to support Linux containers.

Vertrouwd met dockerFamiliarity with Docker U hebt een basis informatie nodig over docker-concepten, zoals registers, opslag plaatsen, containers en container installatie kopieën.You need a basic understanding of Docker concepts, such as registries, repositories, containers, and container images. U hebt ook kennis nodig van docker basis opdrachten.You also need knowledge of basic docker commands.
Gezichts bronFace resource Als u de container wilt gebruiken, hebt u het volgende nodig:To use the container, you must have:

Een Azure Face -resource en de bijbehorende API-sleutel en de EINDPUNT-URI.An Azure Face resource and the associated API key and the endpoint URI. Beide waarden zijn beschikbaar op het overzicht en op de pagina sleutels voor de resource.Both values are available on the Overview and Keys pages for the resource. Ze zijn verplicht om de container te starten.They're required to start the container.

{API_KEY} : Een van de twee beschik bare bron sleutels op de pagina sleutels{API_KEY}: One of the two available resource keys on the Keys page

{ENDPOINT_URI} : Het eind punt op de pagina overzicht{ENDPOINT_URI}: The endpoint as provided on the Overview page

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 het geheugen die moeten worden toegewezen voor elke Face-API-container.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 kern geheugen van 4 GB1 core, 4-GB memory 10, 2010, 20
  • Elke kern moet ten minste 2,6 GHz of sneller zijn.Each core must be at least 2.6 GHz or faster.
  • Trans acties per seconde (TPS).Transactions per second (TPS).

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

Container installatie kopie ophalen met docker-pullGet the container image with docker pull

Er zijn container installatie kopieën voor de Face-API 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
<image-id>       <repository-path/name>    <tag-name>

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 zich op de hostcomputerbevindt, gebruikt u het volgende proces om met de container te werken.After the container is on the host computer, use the following process to work with the container.

  1. Voer de container uit met de vereiste facturerings instellingen.Run the container with the required billing settings. Er zijn meer voor beelden van de docker run opdracht beschikbaar.More examples of the docker run command are available.
  2. Zoek het Voorspellings eindpunt van de containerop.Query the container's prediction endpoint.

De container uitvoeren met docker-uitvoeringRun the container with docker run

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

Tijdelijke aanduidingPlaceholder ValueValue
{API_KEY}{API_KEY} Deze sleutel wordt gebruikt om de container te starten en is beschikbaar op de Cognitive Services pagina met Azure- sleutels .This key is used to start the container and is available on the Azure Cognitive Services Keys page.
{ENDPOINT_URI}{ENDPOINT_URI} De waarde voor de URL van het facturerings eindpunt Cognitive Services is beschikbaar op de pagina overzicht van Azure.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 route ring toe aan de eindpunt-URI, zoals wordt weer gegeven in het voor gaande voor beeld van ENDPOINT_URI.Add the face/v1.0 routing to the endpoint URI, as shown in the preceding ENDPOINT_URI example.

Vervang deze para meters door uw eigen waarden in docker run het volgende voor beeld van de 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={ENDPOINT_URI} \
ApiKey={API_KEY}

Deze opdracht:This command:

  • Voert een face-container uit vanuit de container installatie kopie.Runs a face container from the container image.
  • Wijst één CPU-kern en 4 GB aan geheugen toe.Allocates one CPU core and 4 GB of memory.
  • Beschrijft TCP-poort 5000 en wijst een pseudo-TTY voor de container toe.Exposes TCP port 5000 and allocates a pseudo TTY for the container.
  • Verwijdert de container automatisch nadat deze is afgesloten.Automatically removes the container after it exits. De container installatie kopie is nog steeds beschikbaar op de hostcomputer.The container image is still available on the host computer.

Er zijn meer voor beelden van de docker run opdracht beschikbaar.More examples of the docker run command are available.

Belangrijk

De Eulaopties Billing, enApiKey moeten worden opgegeven om de container uit te voeren 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 prediction-eind punt van de containerQuery the container's prediction endpoint

De container bevat op REST gebaseerde query Voorspellings eindpunt-Api's.The container provides REST-based query prediction endpoint APIs.

Gebruik de host, https://localhost:5000voor container-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.

AanvraagRequest 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 uitvoert met een uitvoer koppeling en logboek registratie is ingeschakeld, genereert de container logboek bestanden die handig zijn om problemen op te lossen 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.

BillingBilling

De Face-API-containers verzenden facturerings gegevens naar Azure met behulp van een Face-API resource in 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 that's 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

Voor de docker run opdracht om te beginnen de container, moeten alle drie van de volgende opties worden opgegeven met geldige waarden:For the docker run command to start the container, all three of the following options must be specified with valid values:

OptieOption DescriptionDescription
ApiKey De API-sleutel van de Cognitive Services-resource die wordt gebruikt voor het bijhouden van informatie over facturering.The API key of the Cognitive Services resource that's used to track billing information.
De waarde van deze optie moet worden ingesteld op een API-sleutel voor de ingerichte resource die opgegeven in Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Het eindpunt van de Cognitive Services-resource die wordt gebruikt voor het bijhouden van informatie over facturering.The endpoint of the Cognitive Services resource that's 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 accepteren.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.

BlogberichtenBlog posts

Voorbeelden voor ontwikkelaarsDeveloper samples

Voorbeelden voor ontwikkelaars zijn beschikbaar op onze GitHub-opslagplaats.Developer samples are available at our GitHub repository.

Webinar bekijkenView webinar

Deelnemen aan de webinar voor meer informatie over:Join the webinar to learn about:

  • Cognitive Services implementeren op elke machine met behulp van DockerHow to deploy Cognitive Services to any machine using Docker
  • Cognitive Services implementeren naar AKSHow to deploy Cognitive Services to AKS

SamenvattingSummary

In dit artikel hebt u concepten en werk stromen geleerd om Face-API containers te downloaden, te installeren en uit te voeren.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 die belang rijke woord extractie, taal detectie en sentiment analyse bieden.The Face API provides three Linux containers for Docker that provide key phrase extraction, language detection, and sentiment analysis.
  • Container installatie kopieën worden gedownload van de 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 bewerkingen in Face-API containers aan te roepen door de URI van de host op te geven van de container.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.
  • U moet de facturerings gegevens opgeven wanneer u een container maakt.You must specify billing information when you instantiate a container.

Belangrijk

Cognitive Services-containers mogen niet worden uitgevoerd zonder te zijn verbonden met Azure voor meting.Cognitive Services containers aren't licensed to run without being connected to Azure for metering. Klanten moeten de containers in staat stellen om de facturerings gegevens te allen tijde met de meet service te communiceren.Customers must enable the containers to communicate billing information with the metering service at all times. Cognitive Services containers verzenden geen klant gegevens, zoals de afbeelding of de tekst die wordt geanalyseerd, naar micro soft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Volgende stappenNext steps