Probeer Azure AI Video Indexer ingeschakeld door Arc

Artikel
04/01/2024

Azure AI Video Indexer ingeschakeld door Arc is een azure Arc-extensieservice die video- en audioanalyse uitvoert op edge-apparaten. De oplossing is ontworpen om te worden uitgevoerd op Kubernetes met Azure Arc en ondersteunt veel video-indelingen, waaronder MP4 en andere veelgebruikte indelingen. Het ondersteunt verschillende talen in alle eenvoudige audiogerelateerde modellen. Hierbij wordt ervan uitgegaan dat één Video Indexer-resource is toegewezen aan één extensie.

In dit artikel worden de stappen beschreven die nodig zijn om Video Indexer in te schakelen als een Arc-extensie voor uw huidige infrastructuur.

Voorbeeldimplementatie

Hier volgt een blokdiagram met Azure AI Video Indexer die wordt uitgevoerd in Azure Arc. Er zijn drie typen:

Winkeltype A maakt gebruik van zowel visuele als audio-voorinstellingen.
Winkeltype B maakt alleen gebruik van vooraf ingestelde visuele instellingen. Het heeft ook een aangepast model. Zie Bring Your Own AI-model voor meer informatie over het gebruik van een aangepast model waarvoor Azure AI Video Indexer is ingeschakeld door Arc.
Store C maakt alleen gebruik van audio-voorinstellingen.

De extensie wordt op elk edge-apparaat opgeslagen en elk apparaat is gekoppeld aan één AI Video Indexer-account dat interfaces heeft met Azure Arc en de cloud.

Vereisten

Belangrijk

Als u de Azure AI Video Indexer-extensie wilt implementeren, is het verplicht dat uw Azure-abonnements-id vooraf wordt goedgekeurd. U moet zich eerst registreren met dit formulier.

Maak een Azure-abonnement met machtigingen voor het maken van Azure-resources.
Maak een Azure AI Video Indexer-account. Gebruik de zelfstudie Video Indexer-account maken.
Een Kubernetes-cluster met Arc maken.
Download de voorbeeldvideo.

Als u de Video Indexer-extensie wilt gebruiken, moet u een extern gericht eindpunt hebben. Dit kan een DNS-naam of EEN IP-adres zijn. Het eindpunt moet worden ingesteld als een beveiligd overdrachtsprotocol (https:\\) en wordt gebruikt als het eindpunt van de extensie-API, opgemaakt als https:\\{endpointUri}/swagger/index.html. Het wordt ook gebruikt door de Video Indexer-webportal om te communiceren met de extensie. Het is raadzaam om een toegangsbeheerobjectbeheer te gebruiken om het eindpunt te beheren.

Notitie

Als het eindpunt niet openbaar toegankelijk is, kunt u geen acties uitvoeren op de extensie vanuit de webportal.

Belangrijk

Het AKS-cluster bevat de Video Indexer-extensie moet zich in de regio VS - oost bevinden.

Minimale hardwarevereisten voor deze quickstart

Deze quickstart is ontworpen om u in staat te stellen de extensie in actie te zien, zodat er kleinere resourcegrootten zijn gekozen waarmee u in een testomgeving kunt werken. Voor deze quickstart zijn de minimale hardwarevereisten:

CPU: 16 kernen
Geheugen: 16 GB

Zie het artikel Minimumhardwarevereisten in het overzichtsartikel voor de minimale hardwarevereisten in een productieomgeving.

Minimale softwarevereisten

Onderdeel	Minimale vereisten
Besturingssysteem	Ubuntu 22.04 LTS of een linux-compatibel besturingssysteem
Kubernetes	1,26
Azure-CLI	2.48.0

Parameterdefinities

Parameter	Default	Beschrijving
release-naamruimte	ja	De Kubernetes-naamruimte waarnaar de extensie is geïnstalleerd
cluster-name		De naam van het Kubernetes Azure Arc-exemplaar
resource-group		De naam van de Kubernetes Azure Arc-resourcegroep
version	ja	Video Indexer Extension version, leave empty for latest
speech.endpointUri		Eindpunt van speech-service-URL (koppeling)
speech.secret		Speech Instance-geheim (koppeling)
translate.endpointUri		Eindpunt van vertaalservice-URL (koppeling)
translate.secret		Vertaalservicegeheim (koppeling)
ocr.endpointUri		EINDPUNT van OCR-service-URL (koppeling)
ocr.secret		OCR-servicegeheim (koppeling)
videoIndexer.accountId		Video Indexer-account-id
videoIndexer.endpointUri		Dns-naam of IP die moet worden gebruikt als het externe eindpunt van de extensie.

Implementatie voorbereiden

Tijdens de implementatie vraagt het script om omgevingsspecifieke waarden. Zorg ervoor dat deze waarden gereed zijn, zodat u ze kunt kopiëren en plakken wanneer het script erom vraagt.

Vraag	Weergegeven als	DETAILS
Wat is de account-id van Video Indexer tijdens de implementatie?	GUID	Uw Video Indexer-account-id
Wat is de Azure-abonnements-id tijdens de implementatie?	GUID	Uw Azure-abonnements-id
Wat is de naam van de Video Indexer-resourcegroep tijdens de implementatie?	tekenreeks	De naam van de resourcegroep van uw Video Indexer-account
Wat is de naam van het Video Indexer-account tijdens de implementatie?	tekenreeks	De naam van uw Video Indexer-account

Navigeer in Azure Portal naar uw met Azure Arc verbonden cluster.
Selecteer In het menu Extensies>+ Azure AI Video Indexer Arc-extensie toevoegen.>
Selecteer Maken. Het scherm Voor het maken van een AI Video Indexer-extensie wordt weergegeven.
Configureer de extensie in instantiedetails:
1. Selecteer het abonnement en de resourcegroep voor uw extensie.
2. Selecteer de regio en het verbonden k8-cluster.
3. Voer een naam in voor uw extensie.
4. Selecteer het Azure AI Video Indexer-account waarmee de extensie wordt verbonden.
5. Voer het clustereindpunt in, ofwel een IP- of DNS-naam die moet worden gebruikt als het API-eindpunt.
6. Geef de opslagklasse op die u wilt gebruiken voor de extensie die wordt ondersteund door uw Kubernetes-distributie. Als u bijvoorbeeld AKS gebruikt, kunt u dit gebruiken azurefile-cli. Zie Opslagklassen in AKS voor meer informatie over vooraf gedefinieerde opslagklassen die worden ondersteund door AKS. Als u andere Kubernetes-distributies gebruikt, raadpleegt u uw Kubernetes-distributiedocumentatie voor vooraf gedefinieerde opslagklassen die worden ondersteund of de manier waarop u uw eigen opslagklassen kunt opgeven.
Selecteer Controleren en maken en vervolgens Maken.

Handmatige implementatie

Volg deze stappen om de Video Indexer Arc-extensie te implementeren in uw Cluster met Arc K8S. Voordat u aan de slag gaat, moet u rekening houden met het volgende:

Opslagklasse - Video Indexer-extensie vereist dat een opslagvolume beschikbaar moet zijn in het Kubernetes-cluster. De opslagklasse moet worden ondersteund ReadWriteMany. Het is belangrijk te weten dat het indexeringsproces io-intensief is, dus de IOPS (invoer-/uitvoerbewerkingen per seconde) van het opslagvolume hebben een aanzienlijke invloed op de duur van het proces.
Beheerde AI-resources: sommige Azure AI-resources (Vertalen, transcriptie en OCR) worden gemaakt in de Microsoft-tenant. Deze resources zijn alleen voor uw abonnement en vallen onder een model voor betalen per gebruik. Als u al een AI Video Indexer Arc-resource in uw abonnement hebt, wordt deze gekoppeld aan bestaande Azure AI-resources.

Stap 1: Een Azure Arc Kubernetes-cluster maken en dit verbinden met uw cluster

Notitie

Bij de volgende opdracht wordt ervan uitgegaan dat u een Kubernetes-cluster hebt en dat de huidige context op uw ./kube/config-bestand ernaar verwijst.

Voer de volgende opdracht uit om verbinding te maken met uw cluster. Met deze opdracht worden de Azure Arc-agents geïmplementeerd in het cluster en wordt Helm v. 3.6.3 geïnstalleerd in de map .azure van de implementatiemachine. Deze Helm 3-installatie wordt alleen gebruikt voor Azure Arc en verwijdert of wijzigt geen eerder geïnstalleerde versies van Helm op de computer.

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

Tip

Volg het artikel over het verbinden van uw cluster met Azure Arc in Azure Docs voor een volledig overzicht van dit proces.

Stap 2: Azure Arc Video Indexer-extensie maken

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"

Stap 3: resourcesleutels maken en ophalen

AI-resourcessleutels maken

$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

Wanneer het antwoord op een aanvraag 'geaccepteerd' (202) is, betekent dit dat de resources momenteel worden gemaakt. Als u de inrichtingsstatus van deze resources wilt bijhouden, kunt u de locatieheader peilen die is geretourneerd in het antwoord van de vorige aanroep. Normaal gesproken moet dit proces ongeveer één minuut wachten.

Een reactie van het type 'conflict' (409) betekent dat de resources al bestaan voor het abonnement, gebruik de opdracht ophalen om de sleutels op te halen.

AI-resourcessleutels ophalen

$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

Antwoordindeling:

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

Optionele configuratie

De standaardinstellingen voor de extensie zijn ingesteld voor het afhandelen van de algemene werkbelastingen, voor specifieke gevallen, de volgende parameters kunnen worden gebruikt om de resourcetoewijzing te configureren:

Parameter	Default	Beschrijving
AI.nodeSelector	-	Het knooppuntkiezerlabel waaraan de AI-pods (spraak en vertalen) zijn toegewezen
speech.resource.requests.cpu	1	Het aangevraagde aantal kernen voor de spraakpod
speech.resource.requests.mem	2Gi	De aangevraagde geheugencapaciteit voor de spraakpod
speech.resource.limits.cpu	2	Het aantal kernen voor de spraakpod is beperkt. moet speech.resource.requests.cpu zijn >
speech.resource.limits.mem	3Gi	De geheugencapaciteit voor de spraakpod wordt beperkt. moet speech.resource.requests.mem zijn >
translate.resource.requests.cpu	1	Het aangevraagde aantal kernen voor de vertaalpod
translate.resource.requests.mem	16Gi	De aangevraagde geheugencapaciteit voor de vertaalpod
translate.resource.limits.cpu	--	Het aantal kerngeheugens voor de vertaalpod is beperkt. moet vertalen.resource.requests.cpu zijn >
translate.resource.limits.mem	--	De geheugencapaciteit voor de vertaalpod wordt beperkt. moet vertalen.resource.requests.mem zijn >
videoIndexer.webapi.resources.requests.cpu	0,5	Het aanvraagaantal kernen voor de web-API-pod
videoIndexer.webapi.resources.requests.mem	4Gi	De geheugencapaciteit van de aanvraag voor de web-API-pod
videoIndexer.webapi.resources.limits.cpu	1	Het aantal kerngeheugens voor de web-API-pod
videoIndexer.webapi.resources.limits.mem	6Gi	De geheugencapaciteit voor de web-API-pod beperkt
videoIndexer.webapi.resources.limits.mem	6Gi	De geheugencapaciteit voor de web-API-pod beperkt
storage.storageClass	""	De opslagklasse die moet worden gebruikt
storage.useExternalPvc	false	bepaalt of een extern PVC wordt gebruikt. indien waar, is de VideoIndexer PVC niet geïnstalleerd

Voorbeeld van implementatiescript

Hier volgt een voorbeeld van een implementatiescript:

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"\

Stap 4: Implementatie controleren

kubectl get pods -n video-indexer

De extensie bijwerken

De volgende opdracht kan worden gebruikt om de extensie bij te werken met een andere versie of met verschillende configuratieparameters, indien nodig. U moet de clusternaam en resourcegroepnaam opgeven.

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

Voorbeeld

Voorbeeldscript voor het implementeren van een AKS-cluster met Arc met de Video Indexer-extensie