Installer et exécuter des conteneurs Form Recognizer v2.1 en préversion

Article
06/28/2022
18 minutes de lecture

Important

Les conteneurs Form Recognizer sont en préversion contrôlée. Pour les utiliser, vous devez envoyer une demande en ligne et recevoir une approbation. Pour plus d’informations, consultezla section Demande d’approbation pour l’exécution d’un conteneur, plus loin dans cet article.
Pour le formulaire de demande en ligne, vous devez fournir une adresse e-mail valide appartenant à l’organisation propriétaire de l’ID d’abonnement Azure et disposer ou bénéficier d’un accès à cet abonnement.

Azure Form Recognizer est un service d’IA appliquée qui vous permet de générer des logiciels de traitement de données automatisé à l’aide de la technologie machine learning. Form Recognizer vous permet d’identifier et d’extraire du texte, des paires clé/valeur, des marques de sélection, des données de tableau et plus encore de vos formulaires, et de générer des données structurées qui incluent les relations dans le fichier d’origine.

Dans cet article, vous allez apprendre à télécharger, installer et exécuter des conteneurs Form Recognizer. Les conteneurs vous permettent d’exécuter le service Form Recognizer dans votre propre environnement. Les conteneurs conviennent particulièrement bien à certaines exigences de sécurité et de gouvernance des données. Les fonctionnalités de Form Recognizer sont prises en charge par six conteneurs de fonctionnalités Form Recognizer : Disposition, Carte de visite, Document d’identité, Reçu, Facture et Personnalisé (pour les conteneurs Reçu, Carte de visite et Document d’identité, vous aurez également besoin du conteneur OCR Lire).

Prérequis

Pour commencer, vous avez besoin d’un compte Azure actif. Si vous n’en avez pas, vous pouvez créer un compte gratuit.

Vous avez également besoin des prérequis suivants pour pouvoir utiliser les conteneurs Form Recognizer :

Obligatoire	Objectif
Bonne connaissance de Docker	Vous devez comprendre les concepts de base liés à Docker (comme les registres, les référentiels, les conteneurs et les images conteneurs), et connaître les principaux termes et commandes utilisés pour `docker`.
Moteur Docker installé	Vous avez besoin d’un moteur Docker installé sur un ordinateur hôte. Docker fournit des packages qui configurent l’environnement Docker sur macOS, Windows et Linux. Pour apprendre les principes de base de Docker et des conteneurs, consultez la vue d’ensemble de Docker. Vous devez configurer Docker pour permettre aux conteneurs de se connecter à Azure et de lui envoyer des données de facturation. Sur Windows, vous devez également configurer Docker pour la prise en charge des conteneurs Linux.
Ressource Form Recognizer	Une ressource Azure Form Recognizer à service unique ou Cognitive Services multiservice dans le portail Azure. Pour utiliser ces conteneurs, vous devez disposer de la clé et de l’URI de point de terminaison associés. Ces deux valeurs sont disponibles dans la page Clés et point de terminaison de Form Recognizer dans le portail Azure : {FORM_RECOGNIZER_KEY} : une des deux clés de ressource disponibles. {FORM_RECOGNIZER_ENDPOINT_URI} : point de terminaison de la ressource utilisée pour effectuer le suivi des informations de facturation.
Ressource API Vision par ordinateur	Pour traiter des cartes de visite, des documents d’ID ou des reçus, vous avez besoin d’une ressource Vision par ordinateur. Vous pouvez accéder à la fonctionnalité Reconnaître le texte en tant que ressource Azure (API REST ou SDK) ou conteneurcognitive-services-Recognize-Text. Les frais de facturation habituels s’appliquent. Si vous utilisez le conteneur cognitive-services-recognize-text, assurez-vous que votre clé Vision par ordinateur pour le conteneur Form Recognizer est la clé spécifiée dans la commande `docker run` ou `docker compose` de Vision par ordinateur pour le conteneur cognitive-services-recognize-text et que votre point de terminaison de facturation est le point de terminaison du conteneur (par exemple, `http://localhost:5000`). Si vous utilisez le conteneur Vision par ordinateur et le conteneur Form Recognizer ensemble sur le même hôte, ceux-ci ne peuvent pas être démarrés tous les deux avec le port par défaut 5000. Transmettez la clé et les points de terminaison pour votre conteneur Cognitive Services ou cloud Azure Vision par ordinateur : {COMPUTER_VISION_KEY} : une des deux clés de ressource disponibles. {COMPUTER_VISION_ENDPOINT_URI} : point de terminaison de la ressource utilisée pour effectuer le suivi des informations de facturation.

Facultatif	Objectif
Azure CLI (interface de ligne de commande)	L’interface Azure CLI vous permet d’utiliser un ensemble de commandes en ligne pour créer et gérer des ressources Azure. Elle peut s’installer dans les environnements Windows, macOS et Linux, et s’exécuter dans un conteneur Docker et Azure Cloud Shell.

Demande d’approbation pour l’exécution du conteneur

Complétez et envoyez le formulaire d’application pour les services contrôlés pour demander l’approbation d’exécuter ce conteneur.

Le formulaire demande des informations sur vous, votre entreprise et le scénario d’utilisateur pour lequel vous allez utiliser le conteneur. Une fois le formulaire envoyé, l’équipe Cognitive Services Azure l’examinera et vous informera de sa décision par e-mail dans les 10 jours ouvrables.

Dans le formulaire, vous devez utiliser une adresse e-mail associée à un ID d’abonnement Azure. La ressource Azure que vous utilisez pour exécuter le conteneur doit avoir été créée avec l’ID d’abonnement Azure approuvé. Vérifiez votre adresse e-mail (boîtes de réception et dossiers de courrier indésirable) pour obtenir des mises à jour sur l’état de votre application auprès de Microsoft. Une fois approuvé, vous pourrez exécuter le conteneur après l’avoir téléchargé à partir de Microsoft Container Registry, décrit plus loin dans cet article.

Ordinateur hôte requis

L’hôte est un ordinateur x64 qui exécute le conteneur Docker. Il peut s’agir d’un ordinateur local ou d’un service d’hébergement Docker dans Azure, comme :

Azure Kubernetes Service.
Azure Container Instances.
Un cluster Kubernetes déployé sur Azure Stack. Pour plus d’informations, consultez Déployer Kubernetes sur Azure Stack.

Exigences et suggestions relatives au conteneur

Conteneurs requis

Le tableau suivant liste le ou les conteneurs de prise en charge pour chaque conteneur Form Recognizer que vous téléchargez. Pour plus d’informations, consultez la section Facturation.

Conteneur de fonctionnalités	Conteneur(s) de prise en charge
Disposition	Aucune
Carte de visite	Vision par ordinateur – Lire
Document d’ID	Vision par ordinateur – Lire
Facture	Disposition
Réception	Vision par ordinateur – Lire
Personnalisée	API personnalisée, Supervisé personnalisé, Disposition

Cœurs de processeur et mémoire recommandés

Notes

Les valeurs minimale et recommandée sont basées sur les limites de Docker, pas sur les ressources de la machine hôte.

Conteneurs Lire, Disposition et Prédéfinis

Conteneur	Minimum	Recommandé
Read 3.2	8 cœurs, 16 Go de mémoire	8 cœurs, 24 Go de mémoire
Disposition 2.1 (préversion)	8 cœurs, 16 Go de mémoire	8 cœurs, 24 Go de mémoire
Carte de visite 2.1 (préversion)	2 cœurs, 4 Go de mémoire	4 cœurs, 4 Go de mémoire
Document d’ID 2.1 (préversion)	1 cœur, 2 Go de mémoire	2 cœurs, 2 Go de mémoire
Facture 2.1 (préversion)	4 cœurs, 8 Go de mémoire	8 cœurs, 8 Go de mémoire
Reçu 2.1 (préversion)	4 cœurs, 8 Go de mémoire	8 cœurs, 8 Go de mémoire

Conteneurs personnalisés

Les ordinateurs hôtes requis suivants sont applicables aux demandes d’entraînement et d’analyse :

Conteneur	Minimum	Recommandé
API personnalisée	0,5 cœur, 0,5 Go de mémoire	1 cœur, 1 Go de mémoire
Supervisé personnalisé	4 cœurs, 2 Go de mémoire	8 cœurs, 4 Go de mémoire

Chaque cœur doit être cadencé à au moins 2,6 gigahertz (GHz).
Le nombre de cœurs et la quantité de mémoire correspondent aux paramètres --cpus et --memory, qui sont utilisés dans le cadre de la commande docker compose ou docker run.

Conseil

Vous pouvez utiliser la commande docker images pour lister vos images conteneurs téléchargées. Par exemple, la commande suivante liste l’ID, le référentiel et la balise de chaque image conteneur téléchargée dans un tableau :

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

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Exécuter le conteneur à l’aide de la commande docker-compose up

Remplacez les valeurs {ENDPOINT_URI} et {API_KEY} par votre URI de point de terminaison de ressource et la clé dans la page de ressources Azure.
Assurez-vous que la valeur CLUF est définie sur « accepter ».
Vous devez spécifier les valeurs EULA, Billing et Key ; sinon, le conteneur ne démarrera pas.

Important

Les clés sont utilisées pour accéder à votre ressource Form Recognizer. Ne partagez pas vos clés. Stockez-les en toute sécurité, par exemple, à l’aide de Azure Key Vault. Nous vous recommandons également de régénérer ces clés régulièrement. Une seule clé est nécessaire pour effectuer un appel d’API. Lors de la régénération de la première clé, vous pouvez utiliser la deuxième clé pour un accès continu au service.

Vous trouverez ci-dessous un exemple docker compose autonome permettant d’exécuter le conteneur Disposition de Form Recognizer. Avec docker compose, vous utilisez un fichier YAML pour configurer les services de votre application. Ensuite, avec la commande docker-compose up, vous créez et démarrez tous les services à partir de votre configuration. Entrez les valeurs {FORM_RECOGNIZER_ENDPOINT_URI} et {FORM_RECOGNIZER_KEY} pour votre instance de conteneur Disposition.

version: "3.9"
services:
azure-cognitive-service-layout:
    container_name: azure-cognitive-service-layout
    image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout
    environment:
      - EULA=accept
      - billing={FORM_RECOGNIZER_ENDPOINT_URI}
      - apiKey={FORM_RECOGNIZER_KEY}
    ports:
      - "5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge