Essayer Azure AI Video Indexer activé par Arc

Article
04/01/2024

Azure AI Video Indexer activé par Arc est un service avec extension Azure Arc qui exécute l’analyse vidéo et audio sur les appareils de périphérie. La solution est conçue pour s’exécuter sur Kubernetes avec Azure Arc et prend en charge de nombreux formats vidéo, notamment MP4 et d’autres formats courants. Elle prend en charge plusieurs langages dans tous les modèles audio de base. Il part du principe qu’une ressource Video Indexer est mappée à une extension.

Cet article vous guide tout au long des étapes nécessaires pour activer Video Indexer en tant qu’extension Arc sur votre infrastructure actuelle.

Exemple de déploiement

Voici un diagramme de blocs montrant Azure AI Video Indexer s’exécutant sur Azure Arc. Il existe trois types :

Le type de magasin A utilise à la fois les présélections vision et audio.
Le type de magasin B utilise uniquement les présélections de vision. Il a également un modèle personnalisé. Pour plus d’informations sur l’utilisation d’un modèle personnalisé avec Azure AI Video Indexer activé par Arc, consultez Bring Your Own AI Model.
Le Store C utilise uniquement les présélections audio.

L’extension est stockée sur chaque appareil edge et chaque appareil est associé à un seul compte AI Video Indexer qui s’interface avec Azure Arc et le cloud.

Prérequis

Important

Pour déployer correctement l’extension Azure AI Video Indexer, il est obligatoire que votre ID d’abonnement Azure soit approuvé à l’avance. Vous devez d’abord vous inscrire à l’aide de ce formulaire.

Créez un abonnement Azure avec des autorisations pour créer des ressources Azure.
Créez un compte Azure AI Video Indexer. Utilisez le didacticiel Créer un compte Video Indexer.
Créez un cluster Kubernetes avec Arc.
Téléchargez l’exemple de vidéo.

Pour utiliser l’extension Video Indexer, vous devez disposer d’un point de terminaison externe, qui peut être un nom DNS ou une adresse IP. Le point de terminaison doit être défini comme protocole de transfert sécurisé (https:\\) et est utilisé comme point de terminaison de l’API d’extension, mis en forme comme https:\\{endpointUri}/swagger/index.html. Il est également utilisé par le portail web Video Indexer pour communiquer avec l’extension. Il est recommandé d’utiliser un contrôle d’entrée pour gérer le point de terminaison.

Remarque

Si le point de terminaison n’est pas accessible publiquement, vous ne pourrez pas effectuer d’actions sur l’extension à partir du portail web.

Important

Le cluster AKS contient l’extension Video Indexer doit se trouver dans la région USA Est.

Configuration matérielle minimale requise pour ce guide de démarrage rapide

Ce guide de démarrage rapide est conçu pour vous permettre de voir l’extension en action, de sorte que des tailles de ressources plus petites ont été choisies pour vous permettre d’utiliser dans un environnement de test . Pour ce guide de démarrage rapide, la configuration matérielle minimale requise est la suivante :

Processeur : 16 cœurs
Mémoire : 16 Go

Pour connaître la configuration matérielle minimale requise dans un environnement de production , consultez la configuration matérielle minimale requise dans l’article de vue d’ensemble.

Configuration logicielle minimale requise

Composant	Configuration minimale requise
Système d'exploitation	Ubuntu 22.04 LTS ou tout système d’exploitation compatible Linux
Kubernetes	1,26
Azure CLI	2.48.0

Définitions des paramètres

Paramètre	Default	Description
release-namespace	Oui	Espace de noms Kubernetes dans lequel l’extension est installée
cluster-name		Nom de l’instance Kubernetes Azure Arc
resource-group		Nom du groupe de ressources Kubernetes Azure Arc
version	Oui	Version de l’extension Video Indexer, laissez vide pour la dernière version
speech.endpointUri		Point de terminaison d’URL du service Speech (lien)
speech.secret		Secret de l’instance speech (lien)
translate.endpointUri		Point de terminaison d’URL du service de traduction (lien)
translate.secret		Secret du service de traduction (lien)
ocr.endpointUri		Point de terminaison d’URL du service OCR (lien)
ocr.secret		Secret du service OCR (lien)
videoIndexer.accountId		ID de compte Video Indexer
videoIndexer.endpointUri		Nom dns ou adresse IP à utiliser comme point de terminaison externe d’extension.

Préparer le déploiement

Pendant le déploiement, le script demande des valeurs spécifiques à l’environnement. Faites en sorte que ces valeurs soient prêtes pour que vous puissiez les copier et les coller lorsque le script les demande.

Question	Valeur	Détails
Qu’est-ce que l’ID de compte Video Indexer pendant le déploiement ?	GUID	ID de votre compte Video Indexer
Qu’est-ce que l’ID d’abonnement Azure pendant le déploiement ?	GUID	VOTRE ID d’abonnement Azure
Quel est le nom du groupe de ressources Video Indexer pendant le déploiement ?	string	Nom du groupe de ressources de votre compte Video Indexer
Quel est le nom du compte Video Indexer pendant le déploiement ?	string	Nom de votre compte Video Indexer

Dans le portail Azure, accédez à votre cluster connecté Azure Arc.
Dans le menu, sélectionnez Extensions>+ Ajouter l’extension> Azure AI Video Indexer Arc.
Sélectionnez Créer. L’écran Créer une extension AI Video Indexer s’affiche.
Configurez l’extension dans les détails de l’instance :
1. Sélectionnez l’abonnement et le groupe de ressources pour votre extension.
2. Sélectionnez la région et le cluster k8 connecté .
3. Entrez un nom pour votre extension.
4. Sélectionnez le compte Azure AI Video Indexer auquel l’extension sera connectée.
5. Entrez le point de terminaison du cluster, une adresse IP ou un nom DNS à utiliser comme point de terminaison d’API.
6. Fournissez la classe de stockage que vous souhaitez utiliser pour l’extension prise en charge par votre distribution Kubernetes. Par exemple, si vous utilisez AKS, vous pouvez utiliser azurefile-cli. Pour plus d’informations sur les classes de stockage prédéfinies qu’AKS prend en charge, consultez Classes de stockage dans AKS. Si vous utilisez d’autres distributions Kubernetes, consultez la documentation de votre distribution Kubernetes pour connaître les classes de stockage prédéfinies prises en charge ou la manière dont vous pouvez fournir les vôtres.
Sélectionnez Vérifier + créer, puis Créer.

Déploiement manuel

Suivez ces étapes pour déployer l’extension Video Indexer Arc sur votre cluster Arc K8S Activé. Avant de commencer, voici quelques points à garder à l’esprit :

Stockage classe - L’extension Video Indexer nécessite qu’un volume de stockage soit disponible sur le cluster Kubernetes. La classe de stockage doit prendre en charge ReadWriteMany. Il est important de noter que le processus d’indexation est gourmand en E/S. Par conséquent, les E/S par seconde (opérations d’entrée/sortie) du volume de stockage auront un impact significatif sur la durée du processus.
Ressources d’IA managée : certaines ressources Azure AI (Traducteur, Transcription et OCR) sont créées sur le locataire Microsoft. Ces ressources concernent uniquement votre abonnement et sont sous un modèle de paiement à l’utilisation. Si vous disposez déjà d’une ressource avec Ai Video Indexer Arc dans votre abonnement, elle est associée aux ressources Azure AI existantes.

Étape 1 : créer un cluster Kubernetes Azure Arc et le connecter à votre cluster

Remarque

La commande suivante suppose que vous disposez d’un cluster Kubernetes et que le contexte actuel de votre fichier ./kube/config pointe vers celui-ci.

Exécutez la commande suivante pour vous connecter à votre cluster. Cette commande déploie les agents Azure Arc sur le cluster et installe Helm v. 3.6.3 dans le dossier .azure de la machine de déploiement. Cette installation de Helm 3 est utilisée uniquement pour Azure Arc et ne supprime ni ne modifie les versions de Helm précédemment installées sur la machine.

az connectedk8s connect --name myAKSCluster --resource-group myResourceGroup

Conseil

Suivez l’article sur la connexion de votre cluster à Azure Arc sur Azure Docs pour une procédure pas à pas complète de ce processus.

Étape 2 - Créer une extension Azure Arc Video Indexer

az k8s-extension create --name videoindexer \
    --extension-type Microsoft.videoindexer \
    --scope cluster \
    --release-namespace ${namespace} \
    --cluster-name ${connectedClusterName} \
    --resource-group ${connectedClusterRg} \
    --cluster-type connectedClusters \
    --version ${version} \
    --auto-upgrade-minor-version false \
    --config-protected-settings "speech.endpointUri=${speechUri}" \
    --config-protected-settings "speech.secret=${speechSecret}" \
    --config-protected-settings "translate.endpointUri=${translateUri}" \
    --config-protected-settings "translate.secret=${translateSecret}" \
    --config-protected-settings "ocr.endpointUri=$($csResourcesData.ocrCognitiveServicesEndpoint)" `
    --config-protected-settings "ocr.secret=$($csResourcesData.ocrCognitiveServicesPrimaryKey)" `
    --config "videoIndexer.accountId=${viAccountId}" \
    --config "frontend.endpointUri=${dnsName}" \
    --config "storage.storageClass=azurefile-csi"

Étape 3 : Créer et obtenir des clés de ressource

Créer des clés de ressources IA

$Subscription="<your subscription ID>"
$ResourceGroup="<your resource group name"
$AccountName="<your account name>"

az rest --method post --verbose --uri https://management.azure.com/subscriptions/${Subscription}/resourceGroups/${ResourceGroup}/providers/Microsoft.VideoIndexer/accounts/${AccountName}/CreateExtensionDependencies?api-version=2023-06-02-preview

Lorsque la réponse à une demande est « acceptée » (202), cela signifie que les ressources sont en cours de création. Pour suivre l’état d’approvisionnement de ces ressources, vous pouvez interroger l’en-tête d’emplacement retourné dans la réponse de l’appel précédent. En règle générale, ce processus nécessite une attente d’environ une minute.

Une réponse de type « conflit » (409) signifie que les ressources existent déjà pour l’abonnement, utilisez la commande get pour récupérer les clés.

Obtenir des clés de ressources IA

$Subscription="<your subscription ID>"
$ResourceGroup="<your resource group name"
$AccountName="<your account name>" 

az rest --method post --uri  https://management.azure.com/subscriptions/${Subscription}/resourceGroups/${ResourceGroup}/providers/Microsoft.VideoIndexer/accounts/${AccountName}/ListExtensionDependenciesData?api-version=2023-06-02-preview

Format de la réponse :

{
    "speechCognitiveServicesPrimaryKey": "<key>",
    "speechCognitiveServicesSecondaryKey": "<key>",
    "translatorCognitiveServicesPrimaryKey": "<key>",
    "translatorCognitiveServicesSecondaryKey": "<key>",
    "speechCognitiveServicesEndpoint": "<uri>",
    "translatorCognitiveServicesEndpoint": "<uri>",
    "ocrCognitiveServicesPrimaryKey": "<key>",
    "ocrCognitiveServicesSecondaryKey": "<key>",
    "ocrCognitiveServicesEndpoint": "<uri>"
}

Configuration facultative

Les paramètres par défaut de l’extension sont définis pour gérer les charges de travail courantes, pour des cas spécifiques, les paramètres suivants peuvent être utilisés pour configurer l’allocation de ressources :

Paramètre	Default	Description
AI.nodeSelector	-	Étiquette de sélecteur de nœud sur laquelle les pods IA (reconnaissance vocale et traduction) sont affectés à
speech.resource.requests.cpu	1	Nombre demandé de cœurs pour le pod speech
speech.resource.requests.mem	2Gi	Capacité de mémoire demandée pour le pod speech
speech.resource.limits.cpu	2	Nombre limite de cœurs pour le pod speech. doit être > speech.resource.requests.cpu
speech.resource.limits.mem	3Gi	Limite la capacité de mémoire pour le pod speech. doit être > speech.resource.requests.mem
translate.resource.requests.cpu	1	Nombre demandé de cœurs pour le pod de traduction
translate.resource.requests.mem	16Gi	Capacité de mémoire demandée pour le pod de traduction
translate.resource.limits.cpu	--	Nombre limite de cœurs pour le pod de traduction. doit être > translate.resource.requests.cpu
translate.resource.limits.mem	--	Limite la capacité de mémoire du pod de traduction. doit être > translate.resource.requests.mem
videoIndexer.webapi.resources.requests.cpu	0,5	Nombre de cœurs de requête pour le pod d’API web
videoIndexer.webapi.resources.requests.mem	4Gi	Capacité de mémoire de requête pour le pod d’API web
videoIndexer.webapi.resources.limits.cpu	1	Nombre limite de cœurs pour le pod d’API web
videoIndexer.webapi.resources.limits.mem	6Gi	Limite la capacité de mémoire pour le pod d’API web
videoIndexer.webapi.resources.limits.mem	6Gi	Limite la capacité de mémoire pour le pod d’API web
storage.storageClass	""	Classe de stockage à utiliser
storage.useExternalPvc	false	détermine si un PVC externe est utilisé. si la valeur est true, le PVC VideoIndexer n’est pas installé

Exemple de script de déploiement

Voici un exemple de script de déploiement :

az k8s-extension create --name videoindexer \
    --extension-type Microsoft.videoindexer \
    .......
    --config AI.nodeSelector."beta\\.kubernetes\\.io/os"=linux
    --config "speech.resource.requests.cpu=500m" \
    --config "speech.resource.requests.mem=2Gi" \
    --config "speech.resource.limits.cpu=1" \
    --config "speech.resource.limits.mem=4Gi" \
    --config "videoIndexer.webapi.resources.requests.mem=4Gi"\
    --config "videoIndexer.webapi.resources.limits.mem=8Gi"\
    --config "videoIndexer.webapi.resources.limits.cpu=1"\

Étape 4 - Vérifier le déploiement

kubectl get pods -n video-indexer

Mise à jour de l’extension

La commande suivante peut être utilisée pour mettre à jour l’extension avec une autre version ou avec différents paramètres de configuration, si nécessaire. Vous devez spécifier le nom du cluster et le nom du groupe de ressources.

az k8s-extension update --name videoindexer \
    --cluster-name ${connectedClusterName} \
    --resource-group ${connectedClusterRg} \
    --cluster-type connectedClusters \
    --version ${version} \

Exemple

Exemple de script pour déployer un cluster AKS avec Arc avec l’extension Video Indexer