Fonctionnement d’Azure Developer CLI

Effectué

Azure Developer CLI (azd) s’appuie sur des commandes conviviales pour les développeurs et sur des modèles d’application fondamentaux. azd fournit un ensemble de commandes qui vous aident à intégrer et à gérer votre application sur Azure en utilisant des modèles de projet standardisés. Ces modèles incluent toutes les ressources de configuration et de code source nécessaires pour provisionner et déployer votre application sur Azure. Vous pouvez commencer à utiliser azd en travaillant à partir d’un des exemples de modèles existants et extensibles, ou en créant le vôtre.

Explorer les commandes azd

Azure Developer CLI comprend un ensemble accessible de commandes qui correspondent aux phases des workflows de développement courantes, comme le provisionnement et le déploiement de ressources. Certaines commandes azd, comme azd up, gèrent également plusieurs phases à la fois pour simplifier davantage ces tâches.

Par exemple, un workflow azd classique utilisant un modèle existant comprend les phases suivantes :

1. Exécutez la commande azd init avec le paramètre --template pour cloner un modèle existant et définir un nom d’environnement lors de l’invite.

   azd init --template todo-nodejs-mongo
   

2. Exécutez la commande azd auth login pour vous connecter à votre abonnement Azure.

   azd auth login
   

3. Exécutez la commande azd up pour provisionner et déployer les ressources de modèle sur Azure.

   azd up
   

4. Une fois votre environnement configuré dans Azure, vous pouvez modifier localement les fonctionnalités de l’application ou les modèles de ressources Azure, puis réexécuter azd up pour provisionner vos modifications.

D’autres commandes azd sont disponibles pour effectuer d’autres tâches et développer ce workflow. azd est conçu pour avoir un nombre minimal de commandes avec peu de paramètres pour faciliter son utilisation. Voici quelques-unes des commandes azd les plus courantes :

• azd init : initialiser une nouvelle application.
• azd up - provisionner des ressources Azure et déployer votre projet avec une seule commande.
• azd provision : provisionner les ressources Azure pour une application.
• azd deploy : déployer le code de l’application sur Azure.
• azd pipeline : (bêta) gérer et configurer vos pipelines de déploiement.
• azd auth : s’authentifier auprès d’Azure.
• azd config : gérer les configurations azd (par exemple, l’abonnement Azure par défaut, l’emplacement).
• azd down : supprimer les ressources Azure pour une application.

Explorer les modèles azd

Les commandes Azure Developer CLI sont conçues pour fonctionner avec des modèles de projet standardisés. Chaque modèle est un référentiel de code qui respecte des conventions de fichiers et de dossiers spécifiques. Les modèles contiennent les ressources nécessaires à azd pour provisionner des ressources Azure et éventuellement déployer le code source de l’application. Certains modèles risquent de ne pas inclure le code source de l’application, partant du principe que vous ajoutez le vôtre. Quand vous exécutez une commande comme azd up, l’outil utilise les ressources du modèle de projet pour exécuter différentes étapes du workflow, comme le provisionnement ou le déploiement de ressources sur Azure.

Il existe deux approches principales pour travailler avec des modèles azd :

• Étendre un modèle azd existant : une grande bibliothèque de modèles azd existe déjà pour couvrir les piles d’applications locales, les scénarios et les architectures courants. Vous pouvez parcourir un grand nombre de modèles sur le site de la bibliothèque de modèles awesome-azd. Si vous trouvez un modèle qui correspond à votre pile d’applications locale ou à l’architecture souhaitée, vous pouvez l’utiliser comme point de départ. Remplacez ensuite le répertoire de code source et modifiez les fichiers de configuration ou d’infrastructure pour répondre à vos besoins.

• Convertir votre propre application en modèle azd : vous pouvez aussi convertir une application existante en azd template, en suivant le guide Rendre votre projet compatible avec azd. La création de votre propre modèle demande souvent de travail au départ, mais permet plus de contrôle et produit une solution réutilisable pour le travail de développement futur sur l’application. Les étapes principales pour créer votre propre modèle sont les suivantes :

  • Initialiser le modèle de projet avec azd init.

  • Créer les fichiers d’infrastructure en tant que code en utilisant Bicep ou Terraform.

  • Mettre à jour le fichier azure.yaml pour lier les services d’application avec les ressources Azure.

  • Approvisionner et déployer avec azd up.

    

Quelle que soit l’approche choisie, la structure du modèle résultant est la même. Tous les modèles azd incluent les ressources suivantes :

• Dossier infra : contient l’ensemble de l’infrastructure Bicep ou Terraform en tant que fichiers de code pour le modèle azd. Une infrastructure en tant que code vous permet de définir des ressources et des configurations d’infrastructure dans des fichiers de définition déclaratifs, qui génèrent de façon fiable les mêmes environnements chaque fois qu’ils sont déployés. Terraform fonctionne sur plusieurs plateformes cloud, tandis que Bicep est spécifique à Azure. azd exécute ces fichiers pour créer les ressources Azure nécessaires à l’hébergement de votre application. Vous pouvez en savoir plus sur l’infrastructure en tant que code dans le module de formation Qu’est-ce que l’infrastructure en tant que code ?.

• Fichier azure.yaml : fichier de configuration qui définit un ou plusieurs services dans votre projet, et les mappe à des ressources Azure pour le déploiement. Par exemple, vous pouvez définir un service d’API et un service web front-end, chacun avec des attributs qui les mappent à différentes ressources Azure pour le déploiement.

• Dossier .azure : contient des configurations Azure et des variables d’environnement essentielles, comme l’emplacement de déploiement des ressources ou d’autres informations liées à l’abonnement.

• src folder : contient tout le code source de l’application déployable. Certains modèles azd fournissent seulement des ressources d’infrastructure et laissent le répertoire src vide pour vous permettre d’ajouter votre propre code d’application.

  

La plupart des modèles azd incluent aussi en option un ou plusieurs des dossiers suivants :

• Dossier .devcontainer : vous permet de configurer un environnement de conteneur de développement pour votre application. Une approche courante des environnements de développement qui n’est pas spécifique à azd.
• Dossier .github : contient les fichiers de workflow CI/CD pour GitHub Actions, fournisseur CI/CD par défaut pour azd.
• Dossier .azdo : si vous décidez d’utiliser Azure Pipelines pour CI/CD, définissez les fichiers de configuration de workflow dans ce dossier.