Partager via

Vue d’ensemble des modèles Azure Developer CLI

Les modèles Azure Developer CLI (azd) sont des référentiels de code standard qui incluent des exemples de code d’application, ainsi que azd des fichiers de configuration et d’infrastructure. Les modèles azd vous permettent de provisionner des ressources Azure, de déployer votre application, de configurer des pipelines CI/CD, etc. Vous pouvez créer vos propres modèles ou commencer à utiliser un modèle existant à partir d’un référentiel de modèles tel que Awesome AZD. Cet article porte sur les concepts suivants :

  • Comment les modèles azd vous permettent de provisionner et de déployer des ressources d'application
  • Comment les modèles azd sont structurés
  • Comment décider s’il faut utiliser un modèle existant ou en créer un
  • Découverte des des modèles de démarrage azd existants

Pourquoi utiliser les modèles Azure Developer CLI ?

Les développeurs sont souvent confrontés à de nombreuses tâches fastidieuses et difficiles lors de la création d’applications correctement conçues et configurées prenant en charge l’environnement pour le cloud. Les équipes doivent prendre en compte de nombreuses problématiques différentes dans ces environnements, comme la création de ressources, l’application de configurations, la configuration de la supervision et de la journalisation, la création de pipelines CI/CD et d’autres tâches. Les modèles azd réduisent et rationalisent ces responsabilités pour aider le développeur dans son parcours, du développement local au déploiement réussi d'une application sur Azure.

Par exemple, supposons que vous travaillez dans une entreprise qui exploite une plateforme de gestion des tickets et de communication client, ce qui nécessite les ressources Azure suivantes :

  • Deux instances d'App Service et un plan App Service pour héberger une application web front-end et l’API back-end
  • Une instance Key Vault pour stocker les secrets d’application sécurisés
  • Une base de données Cosmos DB pour stocker les données d’application de manière permanente
  • Des ressources Azure Monitor comme les tableaux de bord Application Insights
  • Une instance Service Bus pour gérer une messagerie évolutive
  • Des pipelines CI/CD pour s’assurer que les modifications peuvent être déployées de façon fiable via un processus automatisé et reproductible.

Au lieu de partir de zéro, avec azd, vous pouvez tirer parti des modèles d'architecture existants pour provisionner et déployer la plupart des ressources à votre place. L’équipe de développement peut ensuite se concentrer sur la création de l’application et sur des ajustements mineurs de l’architecture du modèle.

Fonctionnement des modèles Azure Developer CLI

Les modèles Azure Developer CLI sont conçus pour fonctionner avec des commandes azd telles que azd init et azd up. Ces modèles incluent des fichiers de configuration et d’infrastructure en tant que code (IaC) que les commandes utilisent pour effectuer des tâches telles que le provisionnement de ressources Azure et le déploiement du code d’application sur ces dernières.

Par exemple, un flux de travail typique utilisant un modèle existant comprend les étapes suivantes :

  1. Exécutez la commande azd init avec le paramètre --template pour cloner un modèle existant à partir de GitHub.

    azd init --template todo-nodejs-mongo

  2. Exécutez la commande azd auth login pour vous authentifier auprès de 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. La commande azd up utilise les fichiers de configuration et d'infrastructure comme code (IaC) de votre modèle pour provisionner des ressources Azure et déployer votre application sur ces ressources.

    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.

Explorer la structure du modèle Azure Developer CLI

azd les modèles sont des référentiels de code standard avec des ressources supplémentaires incluses. Tous les azd modèles partagent une structure de fichiers similaire en fonction des azd conventions :

  • Dossier infra - Il contient l’ensemble des fichiers d'infrastructure en tant que code Bicep ou Terraform associés au modèle azd. azd exécute ces fichiers pour créer les ressources Azure nécessaires à l’hébergement de votre application.
  • azure.yaml fichier - Fichier de configuration qui effectue le mappage des dossiers de code source de votre projet vers les ressources Azure définies dans le dossier infra pour le déploiement. Par exemple, vous pouvez définir un service d’API et un service frontal web dans des dossiers distincts et les mapper à différentes ressources Azure pour le déploiement.
  • .azure Dossier - Contient des configurations essentielles pour Azure et des variables d'environnement, telles que l'emplacement pour déployer des ressources ou d'autres informations liées à l'abonnement.
  • src dossier - Contient l'intégralité du code source de l'application déployable. Certains modèles azd excluent le dossier src et fournissent uniquement les ressources d'infrastructure nécessaires pour vous permettre d’ajouter votre propre code d’application.

Par exemple, un modèle azd courant peut correspondre à la structure de dossier suivante :

A screenshot showing an Azure Developer CLI template structure.Capture d’écran montrant la structure d'un modèle Azure Developer CLI.

Les modèles azd incluent également en option un ou plusieurs des dossiers suivants :

  • .githubDossier - Contient les fichiers de workflow CI/CD pour GitHub Actions, qui est le fournisseur CI/CD par défaut pour azd.
  • .azdo Dossier - Si vous décidez d’utiliser Azure Pipelines pour CI/CD, définissez les fichiers de configuration de workflow dans ce dossier.
  • Dossier.devcontainer- Permet de configurer un environnement de conteneur de développement pour votre application.

Démarrer avec un modèle existant ou créer votre propre modèle

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

  • Démarrer avec un azd modèle existant.
    • Il s'agit d'un choix judicieux si vous débutez avec azd ou si vous cherchez un modèle pour développer une nouvelle application avec une architecture et des frameworks similaires.
  • Convertissez un projet existant en modèle azd.
    • C'est un bon choix lorsque vous avez déjà une application existante, mais que vous souhaitez la rendre compatible avec azd.

Les sections suivantes fournissent des informations supplémentaires sur ces deux options.

Démarrer avec un modèle existant

Un large choix de modèles azd sont disponibles dans la galerie de modèles awesome-azd . Ces modèles fournissent du code d’infrastructure et d’application pour différents scénarios de développement, frameworks de langage et services Azure. Si vous trouvez un modèle conforme à votre pile d’applications locale ou à l’architecture souhaitée, vous pouvez étendre et remplacer le code du modèle par le vôtre.

Par exemple, les modèles azd suivants fournissent des points de départ pour les architectures et frameworks d'application courants :

Modèle Hôte d’application Pile technique
Application web React avec l'API C# et MongoDB sur Azure Azure App Service Azure Cosmos DB pour NoSQL, Bicep
Application web React avec l’API C# et SQL Database sur Azure Azure App Service Azure SQL Database, Bicep
Application web React statique + Functions avec l’API C# et SQL Database sur Azure Azure Static Web Apps, Azure Functions Azure SQL Database, Bicep

Créez un nouveau azd modèle pour votre application

Vous pouvez également convertir une application existante en azd modèle pour enrichir le référentiel avec des capacités de provisionnement et de déploiement. Cette approche est celle qui permet d'exercer le plus de contrôle et de produire une solution réutilisable pour les futurs travaux de développement de l'application. Les grandes étapes pour créer votre propre modèle sont les suivantes :

  • Initialisez le modèle de projet avec azd init.
  • Créer les fichiers de l’infrastructure en tant que code Bicep ou Terraform dans le dossier infra.
  • Mettre à jour le fichier azure.yaml pour relier les services de l'application aux ressources Azure.
  • Approvisionner et déployer avec azd up.

Les ressources suivantes fournissent plus d'informations sur la création de vos propres modèles :

Directives pour l’utilisation des modèles azd

Notez que chaque modèle que vous utilisez avec Azure Developer CLI est concédé sous licence par son propriétaire respectif (qui peut ou non être Microsoft) dans le cadre du contrat qui accompagne le modèle. Il vous incombe de déterminer quelle licence s’applique au modèle que vous choisissez d’utiliser.

Microsoft n'est pas responsable des modèles non Microsoft et n'examine pas ces modèles du point de vue de la sécurité, de la confidentialité, de la compatibilité ou des performances. Les modèles que vous utilisez avec Azure Developer CLI, y compris ceux fournis par Microsoft, ne sont pas pris en charge par un programme ou un service de support Microsoft. Tous les modèles fournis par Microsoft sont fournis EN L’ÉTAT sans garantie d’aucune sorte.

Étapes suivantes

Sélectionner et déployer un modèle

  • Last updated on