Utiliser Stockage Blob Azure pour la conversion de modèle
Le service de conversion de modèle nécessite l’accès à Stockage Blob Azure pour pouvoir récupérer les données d’entrée et stocker les données de sortie. Cet article explique comment effectuer les étapes les plus courantes.
Préparer les comptes de stockage Azure
- Créez un compte de stockage (StorageV2).
- Créez un conteneur d’objets Blob d’entrée dans le compte de stockage (nommé « arrinput », par exemple).
- Créez un conteneur d’objets Blob de sortie dans le compte de stockage (nommé « arroutput », par exemple).
Conseil
Pour obtenir des instructions pas à pas sur la configuration de votre compte de stockage, consultez le guide de démarrage rapide : Convertir un modèle pour le rendu
La création du compte de stockage et des conteneurs d’objets Blob peut être effectuée à l’aide de l’un des outils suivants :
- Azure portal
- Ligne de commande az
- Azure Storage Explorer
- SDK (C#, Python, etc.)
Vérifier qu’Azure Remote Rendering peut accéder à votre compte de stockage
Azure Remote Rendering doit pouvoir récupérer les données du modèle à partir de votre compte de stockage et les réécrire dans le compte.
Vous pouvez accorder à Azure Remote Rendering l’accès à votre compte de stockage à l’aide des deux méthodes suivantes :
Connexion de votre compte de stockage Azure à votre compte Azure Remote Rendering
Suivez les étapes décrites dans la section Créer un compte.
Récupération de SAS pour les conteneurs de stockage
Les signatures d’accès stockées (SAS) sont utilisées afin d’accorder l’accès en lecture pour l’entrée et l’accès en écriture pour la sortie. Nous recommandons de générer de nouveaux URI chaque fois qu’un modèle est converti. Les URI expirent après un certain temps. Votre application peut donc s’arrêter de manière inattendue si vous les conservez plus longtemps.
Pour plus d’informations sur les SAS, consultez la documentation SAS.
Vous pouvez générer un URI SAS à l’aide de l’une des méthodes suivantes :
- Module Az PowerShell
- Consultez les exemples de scripts PowerShell.
- Ligne de commande az
- Azure Storage Explorer
- Cliquez avec le bouton droit sur le conteneur « Obtenir une signature d’accès partagé » (accès en lecture et liste pour le conteneur d’entrée, accès en écriture pour le conteneur de sortie).
- SDK (C#, Python, etc.)
Le fichier Conversion.ps1 des exemples de scripts PowerShell offre un exemple d’utilisation de signatures d’accès partagé pour la conversion des ressources.
Important
Lors de la configuration du compte de stockage, ne spécifiez pas de plage d’adresses IP autorisées, même lorsqu’elle répertorie toutes les adresses IP :
Avec une plage d’adresses IP spécifiée, le jeton SAP peut ne pas fonctionner avec ARR et le chargement du modèle peut échouer.
Charger un modèle d’entrée
Pour commencer à convertir un modèle, vous devez le charger à l’aide de l’une des méthodes suivantes :
- Explorateur Stockage Azure : une interface utilisateur pratique pour charger/télécharger/gérer des fichiers sur un stockage Blob Azure
- Ligne de commande Azure
- Module Azure PowerShell
- Consultez les exemples de scripts PowerShell.
- Utilisation d’un SDK de stockage (Python, C#, etc.)
- Utilisation des API REST Stockage Azure
- À l’aide d’Azure Remote Rendering Toolkit (ARRT)
Pour obtenir un exemple illustrant comment charger des données pour la conversion, reportez-vous au fichier Conversion.ps1 des exemples de scripts PowerShell.
Remarque
Lors du chargement d’un modèle d’entrée, veillez à éviter les noms de fichiers et/ou les structures de dossiers trop longs afin d’éviter les problèmes de limite de longueur de chemin d’accès Windows sur le service.
Obtenir un URI SAS pour le modèle converti
Cette étape est similaire à celle permettant de récupérer une SAS pour les conteneurs de stockage. Cependant, vous devez cette fois récupérer un URI SAS pour le fichier de modèle, qui a été écrit dans le conteneur de sortie.
Par exemple, pour récupérer un URI SAS à l’aide de l’Explorateur Stockage Azure, cliquez avec le bouton droit sur le fichier de modèle et sélectionnez « Obtenir une signature d’accès partagé ».
Une signature d’accès partagé (SAS) est nécessaire pour charger les modèles si vous n’avez pas connecté votre compte de stockage à votre compte Azure Remote Rendering. Pour savoir comment connecter votre compte, consultez Créer un compte.