Partager via

Vue d’ensemble des modèles web azd Python

Les modèles AZURE Developer CLI (azd) Web Python constituent le moyen le plus rapide et le plus simple de créer, configurer et déployer des applications web Python sur Azure. Cet article fournit des informations de contexte pour vous aider à comprendre les composants impliqués et comment les modèles simplifient le déploiement.

La meilleure façon de commencer consiste à suivre le guide de démarrage rapide pour créer votre première application web Python et la déployer dans Azure en quelques minutes avec des azd modèles. Si vous préférez ne pas configurer un environnement de développement local, vous pouvez suivre le guide de démarrage rapide à l’aide de GitHub Codespaces pour une expérience entièrement basée sur le cloud avec tous les outils préconfigurés.

Quels sont les modèles azd web Python ?

Les azd modèles sont conçus pour les développeurs web Python expérimentés qui souhaitent déployer des applications évolutives et prêtes pour le cloud sur Azure avec un temps d’installation minimal.

Ces modèles offrent le point de départ le plus simple possible pour la création et le déploiement d’applications web Python par :

  • Configurez rapidement un environnement de développement local complet et d’hébergement.
  • Automatisation de la création d’un environnement de déploiement Azure correspondant.
  • Utilisation d’un flux de travail CLI simple et mémorable.

Une fois vos environnements configurés, les modèles offrent le moyen le plus rapide de commencer à créer votre application web Python. Vous pouvez:

  • Modifiez les fichiers de code fournis pour qu’ils correspondent aux exigences de votre application.
  • Déployez des mises à jour avec un effort minimal à l’aide de commandes azd.
  • Étendez le modèle pour qu’il corresponde à votre architecture.

Ces modèles reflètent les modèles de conception éprouvés et les meilleures pratiques, ce qui vous permet de :

  • Construire avec confiance sur une base architecturale solide.
  • Suivez les instructions développées par les experts du secteur avec une expérience approfondie dans Python et Azure.
  • Assurez la maintenance, l’extensibilité et la sécurité dès le début.

Quelles tâches puis-je effectuer avec les modèles ?

Lorsque vous exécutez un modèle web azd Python, vous effectuez rapidement plusieurs tâches :

  • Créez une application de démarrage. Vous créez un site web pour une société fictive nommée Relecloud. Ce projet de démarrage comprend les éléments suivants :

    • Code bien organisé et prêt pour la production
    • Meilleures pratiques pour les infrastructures web Python (telles que Flask, Django).
    • Utilisation appropriée des dépendances, de la configuration et de la structure.

    Le modèle est conçu pour être un point de départ : vous pouvez personnaliser librement la logique et développer ou supprimer des ressources Azure pour qu’elles correspondent à votre projet.

  • Provisionner des ressources Azure. À l’aide de Bicep, un langage IaC (Infrastructure-as-code) moderne, le modèle provisionne toutes les ressources Azure nécessaires pour :

    • Hébergement de votre application web (par exemple, App Service, Container Apps)
    • Connexion à des bases de données (telles que PostgreSQL, Cosmos DB)

    Les fichiers Bicep sont entièrement modifiables : vous pouvez ajouter ou personnaliser des services Azure à mesure que votre application évolue. Comme pour la tâche précédente, vous pouvez modifier les modèles Bicep pour ajouter d’autres services Azure en fonction des besoins.

  • Déployez l’application de démarrage sur des ressources Azure approvisionnées. Une fois les ressources approvisionnées, votre application est automatiquement déployée dans l’environnement Azure. Vous pouvez désormais :

    • Consultez votre application s’exécutant dans le cloud en quelques minutes.
    • Testez son comportement.
    • Déterminez les fonctionnalités ou la configuration à mettre à jour ensuite.

  • (Facultatif) Configurer le dépôt GitHub et le pipeline CI/CD. Vous pouvez facultativement initialiser un dépôt GitHub avec un pipeline d'intégration continue et de livraison continue (CI/CD) utilisant GitHub Actions pour :

    • Automatisez les déploiements sur les modifications de code.
    • Collaborez avec les membres de l’équipe.
    • Envoyez des mises à jour à Azure en fusionnant dans la branche principale.

    Cette intégration vous aide à adopter les meilleures pratiques DevOps dès le début.

Où puis-je accéder aux modèles ?

De nombreux azd modèles sont disponibles dans la galerie de modèles CLI pour développeurs Azure impressionnants. Ces modèles fournissent des projets d’application web Python prêts à l’emploi avec une parité des fonctionnalités entre les combinaisons populaires de services Azure et de frameworks web Python.

Chaque modèle inclut les éléments suivants :

  • Exemple d’application avec du code propre et gérable.
  • Infrastructure préconfigurée en tant que code à l’aide de Bicep.
  • Flux de travail de déploiement transparents à l’aide de l’interface CLI développeur Azure.
  • Intégration CI/CD facultative via GitHub Actions

Les tableaux suivants répertorient les monikers de modèle web azd Python disponibles pour être utilisés avec la commande azd init. Les tables identifient les technologies implémentées dans chaque modèle et fournissent un lien vers le référentiel GitHub correspondant, où vous pouvez apporter des modifications.

Les modèles suivants azd sont disponibles pour l’infrastructure web Django.

Modèle Base de données Plateforme d’hébergement Dépôt GitHub
azure-django-postgres-flexible-aca Azure Database pour PostgreSQL – Serveur flexible Azure Container Apps https://github.com/Azure-Samples/azure-django-postgres-flexible-aca
azure-django-postgres-flexible-appservice Azure Database pour PostgreSQL – Serveur flexible Azure App Service https://github.com/Azure-Samples/azure-django-postgres-flexible-appservice
azure-django-cosmos-postgres-aca Azure Cosmos DB pour Azure Database pour PostgreSQL Azure Container Apps (Applications de Conteneur Azure) https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca
azure-django-cosmos-postgres-appservice Azure Cosmos DB pour Azure Database pour PostgreSQL Azure App Service https://github.com/Azure-Samples/azure-django-cosmos-postgres-appservice
azure-django-postgres-addon-aca Azure Container Apps avec Azure Database pour PostgreSQL Azure Container Apps (Applications de Conteneur Azure) https://github.com/Azure-Samples/azure-django-postgres-addon-aca

Comment utiliser les modèles ?

Chaque azd modèle comprend un référentiel GitHub qui contient le code d’application (code Python qui utilise une infrastructure web populaire) et les fichiers infrastructure-as-code (à savoir Bicep) pour créer les ressources Azure. Le modèle contient également la configuration requise pour configurer un dépôt GitHub avec un pipeline CI/CD.

Les composants clés de chaque modèle sont les suivants :

  • Code d’application : écrit en Python et créé à l’aide d’une infrastructure web populaire (par exemple Flask, Django, FastAPI). L’exemple d’application illustre les meilleures pratiques en matière de routage, d’accès aux données et de configuration.

  • Infrastructure-as-Code (IaC) : fourni via des fichiers Bicep pour définir et provisionner les ressources Azure requises, telles que :

    • App Service ou Container Apps
    • Bases de données Azure (comme PostgreSQL, Cosmos DB)
    • Services d’IA Azure, Stockage et bien plus encore

  • Configuration CI/CD (facultatif) : inclut des fichiers pour configurer un dépôt GitHub avec un pipeline CI/CD GitHub Actions, ce qui permet d’activer :

    • Déploiement automatique vers Azure sur chaque demande push ou pull vers la branche principale.
    • Intégration transparente dans votre workflow DevOps

    Ces modèles sont entièrement personnalisables, ce qui vous donne une base solide pour vous appuyer et s’adapter aux besoins spécifiques de votre projet.

Pour effectuer les tâches définies par un azd modèle web, vous utilisez différentes commandes Python azd . Pour obtenir des descriptions détaillées de ces commandes, consultez Démarrage rapide : Déployer un modèle Azure Developer CLI. Le guide de démarrage rapide vous guide tout au long des étapes permettant d’utiliser un modèle spécifique azd . Vous devez uniquement exécuter cinq instructions de ligne de commande essentielles pour l’environnement d’hébergement de production et l’environnement de développement local.

Le tableau suivant récapitule les cinq commandes essentielles :

Commande Description de la tâche
azd init --template <template name> Créez un projet à partir d’un modèle et créez une copie du code d’application sur votre ordinateur local. La commande vous invite à fournir un nom d’environnement (tel que « myapp ») utilisé comme préfixe dans le nommage des ressources déployées.
azd auth login Connectez-vous à Azure. La commande ouvre une fenêtre de navigateur dans laquelle vous pouvez vous connecter à Azure. Une fois connecté, la fenêtre du navigateur se ferme et la commande se termine. La azd auth login commande est requise uniquement la première fois que vous utilisez Azure Developer CLI (azd) par session.
azd up Provisionnez les ressources cloud et déployez l’application sur ces ressources.
azd deploy Déployez les modifications apportées au code source de l’application sur les ressources déjà approvisionnées par la azd up commande.
azd down Supprimez les ressources Azure et le pipeline CI/CD, s’il a été utilisé.

Conseil / Astuce

Lorsque vous travaillez avec les azd commandes, surveillez les messages d'invite pour entrer plus d'informations. Après avoir exécuté la azd up commande, vous pouvez être invité à sélectionner un abonnement, si vous en avez plusieurs. Vous pouvez également être invité à spécifier votre région. Vous pouvez modifier les réponses aux invites en modifiant les variables d’environnement stockées dans le dossier /.azure/ du modèle.

Après avoir complété les tâches essentielles fournies par le azd modèle, vous disposez d'une copie personnelle du modèle d'origine dans lequel vous pouvez modifier n'importe quel fichier, si nécessaire.

  • Code d’application : personnalisez le code du projet Python pour implémenter votre propre conception, itinéraires et logique métier.
  • Infrastructure-as-Code (Bicep) : mettez à jour les fichiers Bicep pour approvisionner des services Azure supplémentaires, modifier des configurations ou supprimer des ressources inutiles.

Ce point de départ flexible vous permet de créer sur une base bien structurée tout en adaptant l’application à votre cas d’usage réel.

Vous pouvez également modifier la configuration d’infrastructure en tant que code si vous devez modifier les ressources Azure. Pour plus d’informations, consultez la section Que puis-je modifier ou supprimer plus loin dans cet article.

Tâches de modèle facultatives

En plus des cinq commandes essentielles, vous pouvez effectuer des tâches facultatives avec les azd modèles.

Reprovisionner et modifier des ressources Azure

Après avoir approvisionné des ressources Azure avec un azd modèle, vous pouvez modifier et reprovisionner une ressource.

Configurer un pipeline d'intégration continue (CI)/de livraison continue (CD)

Azure Developer CLI (azd) offre un moyen simple de configurer un pipeline CI/CD pour votre nouvelle application web Python. Lorsque vous fusionnez des validations ou des pull requests dans votre branche principale, le pipeline crée et publie automatiquement les modifications apportées à vos ressources Azure.

  • Pour configurer le pipeline CI/CD, vous désignez le référentiel GitHub et les paramètres souhaités pour activer le pipeline.
  • Pour créer le pipeline, utilisez la azd pipeline config commande.

Après avoir configuré le pipeline, chaque fois que des modifications de code sont fusionnées vers la branche principale du référentiel, le pipeline déploie les modifications apportées à vos services Azure approvisionnés.

Alternatives aux modèles

Si vous préférez ne pas utiliser les modèles web azd Python, il existe d’autres méthodes pour déployer des applications web Python sur Azure et approvisionner des ressources Azure.

Vous pouvez créer de nombreuses ressources et effectuer les étapes de déploiement à l’aide de plusieurs outils :

Vous pouvez également suivre un didacticiel de bout en bout qui propose des infrastructures de développement web Python :

Questions fréquentes

Les sections suivantes résument les réponses aux questions fréquemment posées sur l’utilisation des modèles web azd Python.

Dois-je utiliser dev Containers ?

Non. Les modèles web azd Python utilisent les conteneurs de développement Visual Studio Code par défaut. Les conteneurs de développement offrent de nombreux avantages, mais ils nécessitent certaines connaissances et logiciels requis. Si vous préférez ne pas utiliser les conteneurs de développement et utiliser plutôt votre environnement de développement local, consultez le fichier README.md dans le répertoire racine de l’exemple d’application pour obtenir des instructions de configuration de l’environnement.

Que puis-je modifier ou supprimer ?

Le contenu de chaque modèle web azd Python peut varier en fonction du type de projet et de la pile technologique sous-jacente utilisée. Les modèles identifiés dans cet article suivent une convention commune de dossier et de fichier, comme décrit dans le tableau suivant.

Dossier/fichier(s) Objectif Descriptif
/ Répertoire racine Le dossier racine de chaque modèle contient de nombreux types de fichiers et de dossiers différents à des fins différentes.
/.azur azd fichiers de configuration Le dossier .azure est créé après avoir exécuté la azd init commande. Le dossier stocke les fichiers de configuration des variables d’environnement utilisées par les azd commandes. Vous pouvez modifier les valeurs des variables d’environnement pour personnaliser l’application et les ressources Azure. Pour plus d’informations, consultez le fichier .env spécifique à l’environnement.
/.devcontainer Fichiers de configuration du conteneur de développement Les conteneurs de développement vous permettent de créer un environnement de développement basé sur des conteneurs avec toutes les ressources dont vous avez besoin pour le développement logiciel à l’intérieur de Visual Studio Code. Le dossier .devcontainer est créé après que Visual Studio Code génère un fichier de configuration de conteneur de développement en réponse à une commande de modèle.
/.github Fichiers de configuration GitHub Actions Ce dossier contient des paramètres de configuration pour le pipeline CI/CD GitHub Actions facultatif, le linting et les tests. Si vous ne souhaitez pas configurer le pipeline GitHub Actions à l’aide azd pipeline config de la commande, vous pouvez modifier ou supprimer le fichier azure-dev.yaml .
/infra Fichiers Bicep Le dossier infra contient les fichiers de configuration Bicep. Bicep vous permet de déclarer les ressources Azure que vous souhaitez déployer dans votre environnement. Vous devez uniquement modifier les fichiers main.bicep et web.bicep . Pour plus d’informations, consultez Démarrage rapide : Mise à l’échelle des services déployés avec les modèles web Python azd à l’aide de Bicep.
/src Fichiers de code de projet de démarrage Le dossier src contient différents fichiers de code requis pour préparer le projet de démarrage. Les exemples de fichiers incluent les modèles requis par l’infrastructure web, les fichiers statiques, les fichiers Python (.py) pour la logique de code et les modèles de données, un fichier requirements.txt , etc. Les fichiers spécifiques dépendent du framework web, de l’infrastructure d’accès aux données, et ainsi de suite. Vous pouvez modifier ces fichiers en fonction des besoins de votre projet.
/.cruft.json Fichier de génération de modèle Le fichier JSON .cruft est utilisé en interne pour générer les modèles web azd Python. Vous pouvez supprimer ce fichier en toute sécurité, si nécessaire.
/.gitattributes Fichier avec les paramètres d’attribut pour git Ce fichier fournit git avec des paramètres de configuration importants pour la gestion des fichiers et des dossiers. Vous pouvez modifier ce fichier en fonction des besoins.
/.gitignore Fichier avec des éléments ignorés pour git Le fichier .gitignore informe git sur les fichiers et dossiers à exclure (ignorer) lors de l’écriture dans le référentiel GitHub pour le modèle. Vous pouvez modifier ce fichier en fonction des besoins.
/azure.yaml azd up fichier de configuration Ce fichier de configuration contient les paramètres de configuration de la azd up commande. Il spécifie les services et dossiers de projet à déployer. Important : ce fichier ne doit pas être supprimé.
/*.md Fichiers de format Markdown Un modèle peut inclure différents fichiers de format Markdown (.md) à des fins différentes. Vous pouvez supprimer en toute sécurité les fichiers Markdown.
/docker-compose.yml Paramètres de Docker Compose Ce fichier YML crée le package de conteneur pour l’application web Python avant le déploiement de l’application sur Azure.
/pyproject.toml Fichier de paramètres de construction Python Le fichier TOML contient la configuration système requise de build des projets Python. Vous pouvez modifier ce fichier pour identifier vos préférences d’outil, telles qu’un cadre de test unitaire ou un linter spécifique.
/requirements-dev.in Fichier de spécifications pip Ce fichier est utilisé pour créer une version d’environnement de développement des exigences à l’aide de la pip install -r commande. Vous pouvez modifier ce fichier pour inclure d’autres packages, si nécessaire.

Conseil / Astuce

Lorsque vous modifiez des fichiers de modèle pour votre programme, veillez à pratiquer un bon contrôle de version. Cette approche peut vous aider à restaurer votre référentiel vers une version de travail précédente, si de nouvelles modifications provoquent des problèmes de programme.

Comment puis-je gérer les erreurs de modèle ?

Si vous recevez une erreur lorsque vous utilisez un azd modèle, passez en revue les options décrites dans l’article Résoudre les problèmes liés à l’interface CLI pour développeurs Azure . Vous pouvez également signaler des problèmes sur le dépôt GitHub associé au azd modèle.

Contenu connexe

  • Last updated on