Prise en main rapide : Déployer un modèle Azure Developer CLI
Article
Dans cette prise en main rapide, vous apprendrez à approvisionner et déployer des ressources d’application sur Azure en utilisant un modèle Azure Developer CLI (azd) et seulement quelques commandes azd. Les modèles azd sont des référentiels de code standard qui incluent le code source de votre application ainsi que des fichiers azd de configuration et d’infrastructure pour approvisionner les ressources Azure. Pour en savoir plus sur les modèles azd et comment ils peuvent accélérer votre processus d’approvisionnement et de déploiement Azure, veuillez consulter la section Qu’est-ce que les modèles Azure Developer CLI ?.
Sélectionner et déployer le modèle
Pour les étapes suivantes, vous utiliserez le modèle suivant pour approvisionner et déployer une application sur Azure :
Vous pouvez également sélectionner un modèle qui correspond à vos préférences sur le site de la galerie de modèles Awesome AZD. Quel que soit le modèle que vous utilisez, vous obtiendrez le code du modèle dans votre environnement de développement et vous pourrez exécuter des commandes pour construire, redéployer et surveiller l’application sur Azure.
Sélectionnez votre environnement préféré pour continuer :
Un environnement de développement local est un excellent choix pour les flux de travail de développement traditionnels. Vous clonerez le référentiel du modèle sur votre appareil et exécuterez des commandes sur une installation locale de azd.
Dans l’Explorateur de fichiers ou un terminal, créez un nouveau répertoire vide et accédez-y.
Exécutez la commande azd init et spécifiez le modèle que vous souhaitez utiliser comme paramètre :
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Saisissez un nom d’environnement lorsque cela vous est demandé, tel que azdquickstart, ce qui définit un préfixe de nom pour le groupe de ressources qui sera créé pour contenir les ressources Azure. Qu’est-ce qu’un nom d’environnement dans azd?
Après avoir spécifié l’environnement, azd clone le projet de modèle sur votre machine et initialise le projet.
Approvisionner et déployer les ressources de l’application
Exécutez la commande azd auth login et azd lance un navigateur pour que vous complétiez le processus de connexion.
azd auth login
Exécutez la commande azd up :
azd up
Une fois que vous êtes connecté à Azure, vous serez invité à fournir les informations suivantes :
Paramètre
Description
Azure Location
L’emplacement Azure où vos ressources seront déployées.
Azure Subscription
L’abonnement Azure où vos ressources seront déployées.
Sélectionnez les valeurs souhaitées et appuyez sur Entrée. La commande azd up prend en charge les tâches suivantes pour vous en utilisant les fichiers de configuration et d’infrastructure du modèle :
Crée et configure toutes les ressources Azure nécessaires (azd provision), y compris :
Stratégies d’accès et rôles pour votre compte
Communication de service à service avec Managed Identities
Emballe et déploie le code (azd deploy)
Lorsque la commande azd up s’exécute avec succès, la CLI affiche deux liens pour afficher les ressources créées :
Application API ToDo
Frontend de l’application web ToDo
Remarque
Vous pouvez appeler azd up autant de fois que vous le souhaitez pour à la fois approvisionner et déployer des mises à jour de votre application.
Le déploiement peut échouer en raison d’une ressource non redéployable dans la région sélectionnée. Étant donné qu’il s’agit d’une prise en main rapide, vous pouvez supprimer en toute sécurité le répertoire .azure et essayer azd up à nouveau. Lorsque cela vous est demandé, sélectionnez une autre région. Dans un scénario plus avancé, vous pourriez modifier sélectivement les fichiers dans le répertoire .azure pour changer de région.
Les Codespaces sont une excellente option pour les développeurs qui préfèrent travailler dans des environnements cloud conteneurisés et éviter d’installer des outils ou des dépendances localement.
Une fois votre Codespace créé, faites un clic droit sur azure.yaml dans le répertoire racine. Dans les options, sélectionnez up (approvisionner les ressources et déployer le code sur Azure).
Lorsque vous exécutez la commande azd up, vous serez invité à fournir les informations suivantes et à vous connecter en utilisant un navigateur web et un code d’authentification :
Paramètre
Description
Environment Name
Préfixe pour le groupe de ressources qui sera créé pour contenir toutes les ressources Azure. Qu’est-ce qu’un nom d’environnement dans azd? Vous pouvez toujours créer un nouvel environnement avec azd env new.
Azure Location
L’emplacement Azure où vos ressources seront déployées.
Azure Subscription
L’abonnement Azure où vos ressources seront déployées.
Ce processus peut prendre du temps à se terminer, car la commande azd up gère les tâches suivantes :
Crée et configure toutes les ressources Azure nécessaires (azd provision).
Configure les politiques d’accès et les rôles pour votre compte.
Implémente la communication de service à service avec Managed Identities.
Emballe et déploie le code (azd deploy).
Une fois que vous avez fourni les paramètres nécessaires et que la commande azd up s’est exécutée, le terminal CodeSpaces affiche deux liens vers le portail Azure pour afficher les ressources créées :
L’application a été construite et déployée sur Azure. En utilisant l’URL de l’application web générée par la commande azd up, vous pouvez accéder à l’application entièrement fonctionnelle.
Remarque
Vous pouvez appeler azd up autant de fois que vous le souhaitez pour à la fois approvisionner et déployer votre application.
L’exécution et le débogage nécessitant le lancement d’un navigateur web ne sont actuellement pas pris en charge en raison d’une limitation connue avec GitHub Codespaces. Pour une meilleure expérience, nous vous recommandons d’utiliser Codespaces sur Desktop.
Un DevContainer est une image Docker qui inclut toutes les conditions préalables dont vous avez besoin pour travailler avec le modèle azd sur votre machine locale. Ils constituent un excellent choix pour les développeurs qui préfèrent des environnements conteneurisés fonctionnant toujours sur un appareil local plutôt que sur un service cloud comme GitHub Codespaces.
Ouvrez un terminal, créez un nouveau répertoire vide et accédez-y.
Exécutez la commande ci-dessous pour initialiser le projet :
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Lorsque vous exécutez la commande azd init, vous serez invité à fournir les informations suivantes :
Paramètre
Description
Environment Name
Préfixe pour le groupe de ressources qui sera créé pour contenir toutes les ressources Azure. Qu’est-ce qu’un nom d’environnement dans azd? Vous pouvez toujours créer un nouvel environnement avec azd env new.
Ouvrir le DevContainer
Ouvrez le projet dans VS Code.
Appuyez sur F1 et choisissez : Remote-Containers: Rebuild and Reopen in Container
Exécutez la commande up
Exécutez la commande suivante :
azd up
Lorsque vous exécutez la commande azd up, vous serez invité à fournir les informations suivantes :
Paramètre
Description
Azure Location
L’emplacement Azure où vos ressources seront déployées.
Azure Subscription
L’abonnement Azure où vos ressources seront déployées.
La commande azd up peut prendre du temps à s’exécuter, car elle accomplit les étapes suivantes :
Crée et configure toutes les ressources Azure nécessaires (azd provision), y compris :
Stratégies d’accès et rôles pour votre compte
Communication de service à service avec Managed Identities
Emballe et déploie le code (azd deploy)
Une fois que vous avez fourni les paramètres nécessaires et que la commande azd up s’est exécutée, la CLI affiche deux liens vers le portail Azure pour afficher les ressources créées :
Application API ToDo
Frontend de l’application web ToDo
Remarque
Vous pouvez exécuter azd up autant de fois que vous le souhaitez pour à la fois approvisionner et déployer votre application dans la même région et avec les mêmes valeurs de configuration que vous avez fournies lors de la première exécution.
Nettoyer les ressources
Lorsque vous n’avez plus besoin des ressources créées dans cet article, exécutez la commande suivante pour arrêter l’application :
azd down
Si vous souhaitez redéployer dans une autre région, supprimez le répertoire .azure avant d’exécuter à nouveau azd up. Dans un scénario plus avancé, vous pourriez modifier sélectivement les fichiers dans le répertoire .azure pour changer de région.
Demander de l’aide
Pour savoir comment signaler un bogue, demander de l'aide ou proposer une nouvelle fonctionnalité pour Azure Developer CLI, veuillez consulter la page Dépannage et assistance.