Share via

Créer un environnement à l’aide de l’Azure Developer CLI

  • Article

Dans cet article, vous installez l’Azure Developer CLI (AZD), créez un environnement de déploiement en approvisionnant votre infrastructure d’application dans les Environnements de déploiement Azure et déployez votre code d’application sur l’environnement de déploiement approvisionné.

Azure Developer CLI (AZD) est un outil open source qui accélère le délai nécessaire pour passer votre application de l’environnement de développement local vers Azure. AZD propose des commandes faciles à utiliser pour les développeurs et qui correspondent aux meilleures pratiques. Ces commandes effectuent un mappage sur les étapes clés de votre workflow, que vous travailliez dans le terminal, dans votre éditeur, dans votre environnement de développement intégré (IDE, integrated development environment) ou dans l’intégration continue et livraison continue (CI/CD, continuous integration/continuous deployment).

Pour savoir comment configurer AZD pour utiliser des Environnements de déploiement Azure, consultez Utiliser Azure Developer CLI avec les Environnements de déploiement Azure.

Prérequis

Vous devriez :

Se préparer à travailler avec AZD

Lorsque vous travaillez pour la première fois avec AZD, vous devez effectuer certaines tâches de configuration ponctuelles. Ces tâches incluent l’installation d’Azure Developer CLI, la connexion à votre compte Azure et l’activation de la prise en charge d’AZD pour les Environnements de déploiement Azure.

Installer l’extension Azure Developer CLI pour Visual Studio Code

Lorsque vous installez azd, les outils azd sont installés dans une étendue azd plutôt que globalement, et sont supprimés si azd est désinstallé. Vous pouvez installer azd dans Visual Studio Code ou à partir de la ligne de commande.

Pour activer les fonctionnalités Azure Developer CLI dans Visual Studio Code, installez l’extension Azure Developer CLI, version v0.8.0-alpha.1-beta.3173884. Sélectionnez l’icône Extensions dans la barre d’Activité, recherchez Azure Developer CLI et sélectionnez Installer.

Capture d’écran de Visual Studio Code montrant la commande de connexion dans la palette de commandes.

Se connecter avec Azure Developer CLI

Accédez à vos ressources Azure en vous connectant. Lorsque vous lancez une connexion, une fenêtre de navigateur s’ouvre et vous invite à vous connecter à Azure. Une fois connecté, le terminal affiche un message indiquant que vous êtes connecté à Azure.

Connectez-vous à AZD avec la palette de commandes :

Capture d’écran de Visual Studio Code montrant le volet Extensions avec Azure Developer CLI et Install mis en surbrillance.

La sortie des commandes émises à partir de la palette de commandes s’affiche dans un terminal azd dev, comme dans l’exemple suivant :

Capture d’écran du terminal développeur AZD montrant le message indiquant d’appuyer sur n’importe quelle touche pour fermer.

Activer la prise en charge d’AZD pour ADE

Vous pouvez configurer AZD pour approvisionner et déployer des ressources dans vos environnements de déploiement à l’aide de commandes standard telles que azd up ou azd provision. Quand platform.type est défini sur devcenter, l’état et l’approvisionnement de l’environnement distant AZD utilisent les composants du centre de développement. AZD utilise l’un des modèles d’infrastructure définis dans votre catalogue du centre de développement pour approvisionner les ressources. Dans cette configuration, le dossier infra de vos modèles locaux n’est pas utilisé.

Capture d’écran de Visual Studio Code montrant la commande Enable support dans la palette de commandes.

Créer un environnement à partir de code existant

Vous êtes maintenant prêt à créer un environnement dans lequel vous pouvez travailler. Vous pouvez commencer par du code dans un dossier local ou vous pouvez cloner un référentiel existant. Dans cet exemple, vous créez un environnement en utilisant du code dans un dossier local.

Initialiser une nouvelle application

L’initialisation d’une nouvelle application crée les fichiers et dossiers requis pour qu’AZD fonctionne avec votre application.

AZD utilise un fichier azure.yaml pour définir l’environnement. Le fichier azure.yaml définit et décrit les applications et types de ressources Azure utilisées par l’application. Pour en savoir plus sur azure.yaml, consultez Schéma Azure Developer CLI azure.yaml.

  1. Dans Visual Studio Code, ouvrez le dossier contenant le code de votre application.

  2. Ouvrez la palette de commandes et entrez Azure Developer CLI init, puis sélectionnez Azure Developer CLI (azd): init dans la liste.

    Capture d’écran de la palette de commandes Visual Studio Code avec Azure Developer CLI (azd): init mis en surbrillance.

  3. Pour continuer sans sélectionner de modèle dans la liste des modèles, appuyez deux fois sur ENTRÉE.

  4. Dans le terminal AZD, sélectionnez Utiliser du code dans le répertoire actuel.

    Capture d’écran du terminal AZD dans Visual Studio Code, montrant l’invite pour utiliser le code dans le répertoire actif.

  5. azd init identifie les services définis dans le code de votre application et vous invite à confirmer et à continuer, à supprimer un service ou à ajouter un service. Sélectionnez Confirmer et continuer à initialiser mon application.

    Capture d’écran montrant l’invite AZD init pour confirmer et continuer, supprimer un service ou ajouter un service.

  6. azd init continue de collecter des informations pour configurer votre application. Pour cet exemple d’application, vous êtes invité à entrer le nom de votre instance de base de données MongoDB et les ports sur utilisant les services.

    Capture d’écran montrant l’invite azd init pour fournir un nom de base de données.

  7. Entrez un nom pour votre environnement AZD local.

    Capture d’écran montrant l’invite azd init pour entrer un nouveau nom d’environnement.

  8. azd init affiche une liste des projets auquel vous avez accès. Sélectionnez le projet pour votre environnement

    Capture d’écran montrant l’invite azd init pour sélectionner un projet.

  9. azd init affiche une liste de définitions d’environnement dans le projet. Sélectionnez une définition d’environnement.

    Capture d’écran montrant l’invite azd init pour sélectionner des définitions d’environnement.

    AZD crée les ressources du projet, notamment un fichier azure.yaml à la racine de votre projet.

Approvisionner de l’infrastructure dans un Environnement de déploiement Azure

Lorsque vous êtes prêt, vous pouvez approvisionner votre environnement local dans un environnement distant d’Environnements de déploiement Azure dans Azure. Ce processus approvisionne l’infrastructure et les ressources définies dans la définition d’environnement de votre catalogue du centre de développement.

  1. Dans Explorer, cliquez avec le bouton droit sur azure.yaml, puis sélectionnez Azure Developer CLI (azd)>Approvisionner des ressources Azure (provision).

    Capture d’écran de Visual Studio Code avec azure.yaml mis en surbrillance, ainsi que le menu contextuel AZD avec Azure Developer CLI et l’option pour approvisionner l’environnement mis en surbrillance.

  2. AZD analyse les Environnements de déploiement Azure pour trouver des projets auxquels vous avez accès. Dans le terminal AZD, sélectionnez ou entrez les informations suivantes :

    1. Project
    2. Définition d'environnement
    3. Type d’environnement
    4. Emplacement

  3. AZD charge ADE de créer un environnement en fonction des informations que vous avez fournies à l’étape précédente.

  4. Vous pouvez afficher les ressources créées dans le Portail Azure ou dans le portail des développeurs.

Lister les environnements existants (facultatif)

Vérifiez que votre environnement est bien créé en listant les environnements existants.

  1. Dans Explorer, cliquez avec le bouton droit sur azure.yaml, puis sélectionnez Azure Developer CLI (azd)>Afficher les environnements locaux et distants (env list).

    Capture d’écran de Visual Studio Code avec azure.yaml mis en surbrillance, ainsi que le menu contextuel AZD avec Azure Developer CLI et l’option pour afficher les environnements locaux et distants mis en surbrillance.

    Vous êtes invité à sélectionner un projet et une définition d’environnement.

Déployer du code dans des Environnements de déploiement Azure

Lorsque votre environnement est approvisionné, vous pouvez déployer votre code dans l’environnement.

  1. Dans Explorer, cliquez avec le bouton droit sur azure.yaml, puis sélectionnez Azure Developer CLI (azd)>Déployer des ressources Azure (deploy).

    Capture d’écran de Visual Studio Code avec azure.yaml mis en surbrillance, ainsi que le menu contextuel AZD avec Azure Developer CLI et l’option de déploiement vers Azure mis en surbrillance.

  2. Vous pouvez vérifier que votre code est déployé en sélectionnant les URL des points de terminaison listées dans le terminal AZD.

Nettoyer les ressources

Une fois que vous en avez terminé avec votre environnement, vous pouvez supprimer les ressources Azure.

Dans Explorer, cliquez avec le bouton droit sur azure.yaml, puis sélectionnez Azure Developer CLI (azd)>Supprimer le déploiement et les ressources (down).

Capture d’écran de Visual Studio Code avec azure.yaml mis en surbrillance, ainsi que le menu contextuel AZD avec Azure Developer CLI et l’option de suppression du déploiement et des ressources (vers le bas) mis en surbrillance.

Confirmez que vous souhaitez supprimer l’environnement en entrant y quand vous y êtes invité.

Contenu connexe