FAQ relative aux conteneurs Azure Cognitive Services

Questions générales

Qu’est-ce qui est disponible ?

Les conteneurs Azure Cognitive Services permettent aux développeurs d’utiliser les mêmes API intelligentes que celles disponibles dans Azure, avec les avantages de la mise en conteneur. Certains conteneurs sont disponibles sous la forme d’une préversion contrôlée, dont l’accès peut nécessiter une application. D’autres conteneurs sont disponibles publiquement en préversion non contrôlée, ou sont mises en disponibilité générale. Pour obtenir la liste complète des conteneurs et leur disponibilité, consultez l’article Prise en charge des conteneurs dans Azure Cognitive Services. Vous pouvez également afficher les conteneurs dans Docker Hub.

Existe-t-il des différences entre le cloud Cognitive Services et les conteneurs Cognitive Services ?

Les conteneurs Cognitive Services sont une alternative au cloud Cognitive Services. Les conteneurs offrent les mêmes fonctionnalités que les services cloud correspondants. Les clients peuvent déployer les conteneurs localement ou dans Azure. La technologie IA de base, les niveaux tarifaires, les clés API et la signature d’API sont les mêmes pour le conteneur et les services cloud correspondants. Il existe des fonctionnalités et des avantages à choisir les conteneurs par rapport aux services cloud équivalents.

Comment accéder à un conteneur en préversion contrôlée et l’utiliser ?

Précédemment, les conteneurs de préversion contrôlés étaient hébergés sur le référentiel containerpreview.azurecr.io. À compter du 22 septembre 2020, ces conteneurs sont hébergés sur Microsoft Container Registry. Pour les télécharger, vous n’avez pas besoin d’utiliser la commande docker login. Vous pouvez exécuter un conteneur de préversion limitée si votre ressource Azure a été créée avec l’ID d’abonnement Azure approuvé. Vous ne pourrez pas exécuter le conteneur si votre abonnement Azure n’a pas été approuvé après avoir rempli le formulaire de demande.

Les conteneurs seront-ils disponibles pour toutes les offres Cognitive Services et quels sont les ensembles de conteneurs à venir ?

Nous souhaitons proposer davantage d’offres Cognitive Services sous la forme de conteneurs. Contactez votre gestionnaire local de compte Microsoft pour recevoir des informations sur la publication de nouveaux conteneurs et d’autres annonces concernant Cognitive Services.

Quel sera le Contrat de niveau de service (SLA) des conteneurs Cognitive Services ?

Important

Pour en savoir plus sur les Contrats de niveau de service pour Cognitive Services, visitez notre page consacrée aux contrats SLA.

Cognitive Services fournit des contrats SLA qui peuvent être affichés sur notre page dédiée aux contrats SLA sur le lien fourni ci-dessus.

Toutefois, Cognitive Services dans les conteneurs ne fournit pas de contrat SLA. Les clients contrôlent les configurations des ressources des conteneurs Cognitive Services. Microsoft ne proposera donc pas de contrat SLA pour la disponibilité générale. Les clients sont libres de déployer des conteneurs localement et de définir les environnements hôtes.

Ces conteneurs sont-ils disponibles dans les clouds souverains ?

Les conteneurs Cognitive Services peuvent être utilisés dans les clouds souverains. Les conteneurs peuvent être exécutés et peuvent se connecter au point de terminaison de facturation dans ces clouds, mais les images conteneur doivent être extraites du registre de conteneurs de cloud public.

Contrôle de version

Comment les conteneurs sont-ils mis à jour avec la dernière version ?

Les clients peuvent choisir à quel moment mettre à jour les conteneurs qu’ils ont déployés. Les conteneurs sont marqués à l’aide d’étiquettes Docker standard telles que latest pour indiquer la version la plus récente. Nous encourageons les clients à récupérer les versions les plus récentes des conteneurs dès leur publication. Pour plus d’informations sur la réception de notifications lorsqu’une image est mise à jour, consultez Webhooks Azure Container Registry.

Quelles sont les versions qui seront prises en charge ?

La version actuelle et la dernière version principale du conteneur seront prises en charge. Toutefois, nous encourageons les clients à rester à jour pour bénéficier des dernières technologies.

Comment les versions des mises à jour seront-elles gérées ?

La publication d’une nouvelle version principale indique un changement cassant avec la signature d’API. Nous pensons que cela coïncidera généralement avec la publication d’une nouvelle version principale de l’offre Cognitive Services correspondante dans le cloud. La publication d’une version mineure implique des correctifs de bogues, des mises à jour de modèles ou de nouvelles fonctionnalités qui ne constituent pas un changement cassant avec la signature d’API.

Questions techniques

Comment puis-je diagnostiquer les erreurs potentielles dans mon environnement de déploiement ?

Si vous rencontrez des problèmes lors de l’exécution d’un conteneur Cognitive Services, essayez d’utiliser le conteneur de diagnostics Microsoft. Utilisez ce conteneur pour diagnostiquer dans votre environnement de déploiement les erreurs courantes pouvant nuire au bon fonctionnement des conteneurs Cognitive Services.

Pour obtenir le conteneur, utilisez la commande docker pull suivante :

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Exécutez ensuite le conteneur. Remplacez {ENDPOINT_URI} par votre point de terminaison et {API_KEY} par la clé de votre ressource :

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Le conteneur teste la connectivité réseau avec le point de terminaison de facturation.

Comment dois-je exécuter les conteneurs Cognitive Services sur des appareils IoT ?

Que vous ne disposiez pas d’une connexion Internet fiable, que vous souhaitiez économiser sur le coût de la bande passante, que vous ayez des exigences de faible latence ou que vous ayez affaire à des données sensibles qui doivent être analysées sur place, Azure IoT Edge avec des conteneurs Azure Cognitive Services vous offre une cohérence avec le cloud.

Ces conteneurs sont-ils compatibles avec OpenShift ?

Nous ne testons pas les conteneurs avec OpenShift, mais, en général, les conteneurs Cognitive Services doivent pouvoir s’exécuter sur n’importe quelle plateforme prenant en charge les images Docker. Si vous utilisez OpenShift, nous vous recommandons d’exécuter les conteneurs en tant que root-user.

Comment indiquer des commentaires sur le produit et suggérer des fonctionnalités ?

Nous encourageons les clients à exprimer publiquement leurs préoccupations et à voter en faveur d’autres personnes qui ont fait de même lorsque des problèmes potentiels se recoupent. Vous pouvez utiliser l’outil des commentaires pour fournir des commentaires sur les produits et suggérer des fonctionnalités.

Quels sont les messages d’état et les erreurs renvoyés par les conteneurs Cognitive Services ?

Voici les messages d’état et les erreurs :

Statut Description
Valid Votre clé API est valide. Aucune action n'est nécessaire.
Invalid Votre clé d’API n’est pas valide. Vous devez fournir une clé API valide pour exécuter le conteneur. Recherchez votre clé API et votre région de service dans le portail Azure, dans la section Clés et points de terminaison de votre ressource Cognitive Services.
Mismatch Vous avez fourni une clé API ou un point de terminaison pour un autre type de ressource Cognitive Services. Recherchez votre clé API et votre région de service dans le portail Azure, dans la section Clés et points de terminaison de votre ressource Cognitive Services.
CouldNotConnect Le conteneur n’a pas pu se connecter au point de terminaison de facturation. Vérifiez la valeur Retry-After et attendez que cette période se termine avant d’effectuer d’autres requêtes.
OutOfQuota La clé API a dépassé le quota. Vous pouvez soit mettre à niveau votre niveau tarifaire, soit attendre qu’un quota supplémentaire soit disponible. Recherchez votre niveau dans le portail Azure, dans la section Niveau tarifaire de votre ressource Cognitive Services.
BillingEndpointBusy Le point de terminaison de facturation est actuellement occupé. Vérifiez la valeur Retry-After et attendez que cette période se termine avant d’effectuer d’autres requêtes.
ContainerUseUnauthorized La clé API fournie n’est pas autorisée à être utilisée avec ce conteneur. Vous utilisez probablement un conteneur contrôlé. Vous devez donc vous assurer que votre ID d’abonnement Azure est approuvé en envoyant une demande en ligne.
Unknown Le serveur ne peut pas traiter les demandes de facturation pour le moment.

Comment bénéficier d’un support ?

Les canaux du service clientèle sont les mêmes que ceux des API informatiques de Cognitive Services. Tous les conteneurs Cognitive Services incluent des fonctionnalités de journalisation qui aideront Microsoft et la communauté à offrir une assistance aux clients. Voici des options pour plus de support :

Comment fonctionne la facturation ?

Comme dans le cloud Cognitive Services, les clients sont facturés en fonction de la consommation. Les conteneurs doivent être configurés pour envoyer des données de contrôle à Azure, et les transactions seront facturées en conséquence. Les ressources utilisées à travers les services hébergés et locaux s’ajouteront au quota unique avec une tarification échelonnée, comptant pour les deux utilisations. Pour plus d’informations, consultez les pages de tarification suivantes :

Important

La licence ne prévoit pas que les conteneurs Cognitives Services soient exécutés sans être connectés à Azure, et ce à des fins de contrôle. Les clients doivent configurer les conteneurs de manière à ce qu’ils communiquent les informations de facturation au service de contrôle à tout moment. Les conteneurs Cognitive Services n’envoient pas de données client à Microsoft.

Voici un exemple d’informations que le conteneur communique pour le contrôle :

{
  "SubscriptionId": "Customer subscription ID",
  "apiType": "textanalytics",
  "id": "billing id",
  "containerType": "keyphrase",
  "containerVersion": "1.1.00864.0001",
  "containerId": "dep--keyphrase-",
  "meter": {
    "name": "CognitiveServices.TextAnalytics.Container.BatchScoring",
    "quantity": 10.0
  },
  "RequestTime": "The time at which the billing record was created"
}

Quelle est la garantie actuelle en matière de prise en charge des conteneurs ?

Les préversions ne bénéficient d’aucune garantie. La garantie standard de Microsoft pour les logiciels d’entreprise s’appliquera une fois les conteneurs formellement annoncés comme étant en disponibilité générale.

Qu’advient-il des conteneurs Cognitive Services quand la connectivité Internet est perdue ?

La licence ne prévoit pas que les conteneurs Cognitives Services soient exécutés sans être connectés à Azure, et ce à des fins de contrôle. Les clients doivent configurer les conteneurs de manière à ce qu’ils communiquent avec le service de contrôle à tout moment.

Combien de temps le conteneur peut-il fonctionner sans être connecté à Azure ?

La licence ne prévoit pas que les conteneurs Cognitives Services soient exécutés sans être connectés à Azure, et ce à des fins de contrôle. Les clients doivent configurer les conteneurs de manière à ce qu’ils communiquent avec le service de contrôle à tout moment.

Quel est le matériel nécessaire pour exécuter ces conteneurs ?

Les conteneurs Cognitive Services sont des conteneurs x64 qui peuvent exécuter n’importe quel appareil de périphérie, machine virtuelle ou nœud Linux compatible prenant en charge les conteneurs Docker Linux x64. Ils nécessitent tous des processeurs. Vous trouverez sur ces pages les configurations minimales et recommandées pour chaque offre de conteneur :

Ces conteneurs sont-ils actuellement pris en charge sur Windows ?

Les conteneurs Cognitive Services sont des conteneurs Linux, mais Windows offre un certain niveau de prise en charge. Pour plus d’informations sur les conteneurs Linux sous Windows, consultez la documentation Docker.

Quelles sont les différences entre les conteneurs Cognitive Services et les offres AWS et Google ?

Microsoft est le premier fournisseur de cloud à déplacer ses modèles d’IA préformés dans des conteneurs avec une facturation simple par transaction, similaire à l’utilisation d’un service cloud. Microsoft est convaincue qu’un cloud hybride offre plus de choix aux clients.

De quelles certifications de conformité font l’objet les conteneurs ?

Les conteneurs Cognitive Services n’ont aucune certification de conformité.

Dans quelles régions les conteneurs Cognitive Services sont-ils disponibles ?

Les conteneurs peuvent être exécutés n’importe où dans n’importe quelle région, mais ils ont besoin d’une clé et doivent appeler Azure à des fins de contrôle. Toutes les régions prises en charge pour le service cloud sont prises en charge pour l’appel de contrôle des conteneurs.