Déployer une application web Python (Django ou Flask) avec PostgreSQL dans Azure

• Compte Azure avec un abonnement actif. Si vous ne possédez pas de compte Azure, vous pouvez créer un compte gratuit.
• Connaissance du développement en Python avec Flask ou Python avec Django

• Compte Azure avec un abonnement actif. Si vous ne possédez pas de compte Azure, vous pouvez créer un compte gratuit.
• Azure Developer CLI installé. Vous pouvez suivre les étapes avec Azure Cloud Shell, car Azure Developer CLI est déjà installé.
• Connaissance du développement en Python avec Flask ou Python avec Django

1. Créer les instances App Service et PostgreSQL

Dans cette étape, vous créez les ressources Azure. La procédure indiquée dans ce tutoriel permet de créer un ensemble de ressources sécurisées par défaut qui incluent App Service et Azure DB pour PostgreSQL. Pour le processus de création, vous devez spécifier :

• Le nom de l’application web. Il s’agit du nom utilisé dans le cadre du nom DNS de votre application web sous la forme https://<app-name>.azurewebsites.net.
• La Région du monde où l’application sera physiquement exécutée.
• La Pile du runtime de l’application. C’est là que vous sélectionnez la version de Python à utiliser pour votre application.
• Le Plan d’hébergement de l’application. Il s’agit du niveau tarifaire qui inclut l’ensemble des fonctionnalités et la scalabilité de l’application.
• Le groupe de ressources pour l’application. Un groupe de ressources vous permet de regrouper (dans un conteneur logique) toutes les ressources Azure nécessaires à l’application.

Connectez-vous au portail Azure et procédez comme suit pour créer vos ressources Azure App Service.

2. Secrets de la connexion sécurisée

L’Assistant Création a déjà généré la chaîne de connectivité de base de données pour vous en tant que paramètre d’application. Toutefois, la meilleure pratique de sécurité consiste à éliminer complètement les secrets d’App Service. Vous déplacez vos secrets vers un coffre de clés, et remplacer votre paramètre d’application par une référence Key Vault à l’aide des connecteurs de service.

Pour résumer, le processus impliquait la récupération de la chaîne de connexion PostgreSQL à partir des variables d’environnement d’App Service, la création d’un coffre de clés Azure Key Vault pour sécuriser la gestion des secrets avec un accès privé et la mise à jour du connecteur de services pour stocker le mot de passe dans le coffre de clés. Une connexion sécurisée entre l’application App Service et le coffre de clés a été établie à l’aide d’une identité managée affectée par le système, et la configuration a été vérifiée en confirmant que la chaîne de connexion utilise une référence Key Vault.

Vous rencontrez des problèmes ? Examinez la section Résolution des problèmes.

3. Déployer l’exemple de code

Dans cette étape, vous allez configurer le déploiement GitHub avec GitHub Actions. Cette méthode fait partie des nombreuses façons de déployer sur App Service, mais elle permet également de bénéficier d’une intégration continue dans votre processus de déploiement. Par défaut, chaque git push dans votre dépôt GitHub lance l’action de build et de déploiement.

Vous rencontrez des problèmes ? Consultez le Guide de résolution des problèmes.

4. Générer le schéma de la base de données

5. Accéder à l’application

6. Diffuser les journaux de diagnostic

Azure App Service capture tous les messages qui s’affichent sur la console pour vous aider à diagnostiquer les problèmes liés à votre application. L’exemple d’application inclut des instructions print() pour montrer cette fonctionnalité, comme ci-dessous.

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

Apprenez-en davantage sur la journalisation dans les applications Python dans la série sur la configuration d’Azure Monitor pour votre application Python.

7. Nettoyer les ressources

Lorsque vous avez terminé, vous pouvez supprimer toutes les ressources de votre abonnement Azure en supprimant le groupe de ressources.

1. Créer des ressources Azure et déployer un exemple d’application

Dans cette étape, vous allez créer les ressources Azure et déployer un exemple d’application dans App Service sur Linux. La procédure indiquée dans ce tutoriel permet de créer un ensemble de ressources sécurisées par défaut qui incluent App Service et Azure DB pour PostgreSQL.

1. Si ce n’est déjà fait, clonez la branche starter-no-infra de l’exemple de référentiel dans un terminal local.

   • Flask
   • Django

   git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
   cd msdocs-flask-postgresql-sample-app
   

   Cette branche clonée est votre point de départ. Il contient une simple application Flask de lecteur de données.

2. Depuis la racine du référentiel, exécutez azd init.

   azd init --template python-app-service-postgresql-infra
   

3. Lorsque vous y êtes invité, fournissez les réponses suivantes :

   Question	Réponse
   Le répertoire actif n’est pas vide. Voulez-vous initialiser un projet ici dans «<votre-répertoire>» ?	Y
   Que souhaitez-vous faire de ces fichiers ?	Conserver mes fichiers existants inchangés
   Entrer un nom pour le nouvel environnement	Tapez un nom unique. Le modèle azd utilise ce nom dans le cadre du nom DNS de votre application web dans Azure (<app-name>.azurewebsites.net). Les caractères alphanumériques et les traits d’union sont autorisés.

4. Exécutez la commande azd up pour provisionner les ressources Azure nécessaires et déployer le code de l’application. Si vous n’êtes pas déjà connecté à Azure, le navigateur s’ouvre et vous y invite. La commande azd up vous invite également à sélectionner l’abonnement et l’emplacement souhaités sur lesquels effectuer le déploiement.

   azd up
   

   L’exécution de la commande azd up peut prendre quelques instants. Il compile et déploie également le code de votre application, mais vous allez modifier votre code ultérieurement pour utiliser App Service. Pendant son exécution, la commande fournit des messages sur le processus d’approvisionnement et de déploiement, y compris un lien vers le déploiement dans Azure. Une fois l’opération terminée, la commande affiche également un lien vers l’application de déploiement.

   Ce modèle azd contient des fichiers (azure.yaml et le répertoire infra) qui génèrent une architecture sécurisée par défaut avec les ressources Azure suivantes :

   • Flask
   • Django

   • Groupe de ressources → Conteneur pour toutes les ressources créées.
   • Plan App Service → Définit les ressources de calcul pour App Service. Un plan Linux est spécifié dans le niveau B1.
   • App Service → Représente votre application et s’exécute dans le plan App Service.
   • Réseau virtuel → Intégré à l’application App Service, isole le trafic réseau principal.
   • Azure Database pour PostgreSQL - Serveur flexible → Accessible uniquement à partir du réseau virtuel. Une base de données et un utilisateur sont créés pour vous sur le serveur.
   • Zone DNS privée → active la résolution DNS du serveur PostgreSQL dans le réseau virtuel.
   • L’espace de travail Log Analytics → agit comme le conteneur cible de votre application pour expédier ses journaux d’activité, dans lequel vous pouvez également interroger les journaux.

2. Utiliser la chaîne de connexion de base de données

Le modèle azd utilisé a généré les variables de connectivité pour vous en tant que paramètres d’application et les restitue sur le terminal pour plus de facilité. Les paramètres d’application sont un moyen de préserver les secrets de connexion hors de votre référentiel de code.

1. Dans la sortie azd, retrouvez les paramètres de l’application et les paramètres AZURE_POSTGRESQL_CONNECTIONSTRING et AZURE_REDIS_CONNECTIONSTRING. Pour préserver la sécurité des secrets, seuls les noms des paramètres sont affichés. Ils ressemblent à ceci dans la sortie azd :

    App Service app has the following settings:
   
            - AZURE_POSTGRESQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - FLASK_DEBUG
            - SCM_DO_BUILD_DURING_DEPLOYMENT
            - SECRET_KEY
    

2. AZURE_POSTGRESQL_CONNECTIONSTRING contient la chaîne de connexion vers la base de données Postgres dans Azure et AZURE_REDIS_CONNECTIONSTRING contient la chaîne de connexion vers le cache Redis dans Azure. Vous devez les utiliser dans votre code pour vous y connecter. Ouvrez azureproject/production.py, supprimez les marques de commentaire dans les lignes suivantes et enregistrez le fichier :

   • Flask
   • Django

   conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
   conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}
   DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
       dbuser=conn_str_params['user'],
       dbpass=conn_str_params['password'],
       dbhost=conn_str_params['host'],
       dbname=conn_str_params['dbname']
   )
   

   Votre code d’application est désormais configuré pour se connecter à la base de données PostgreSQL dans Azure. Si vous le souhaitez, ouvrez app.py et voyez comment la variable d’environnement DATABASE_URI est utilisée.

3. Dans le terminal, exécutez azd deploy.

   azd deploy
   

4. Générer le schéma de la base de données

Avec la base de données PostgreSQL protégée par le réseau virtuel, le moyen le plus simple d’exécuter les migrations de base de données Flask est de le faire dans une session SSH avec le conteneur App Service.

5. Accéder à l’application

1. Dans la sortie azd, retrouvez l’URL de votre application et accédez-y dans le navigateur. L’URL ressemble à ceci dans la sortie AZD :

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>.azurewebsites.net/
    

2. Ajoutez quelques restaurants à la liste.

   • Flask
   • Django

   

   Félicitations, vous exécutez une application web Flask dans Azure App Service, avec une connectivité sécurisée vers Azure Database pour PostgreSQL.

6. Diffuser les journaux de diagnostic

Azure App Service peut capturer les journaux de la console pour vous aider à diagnostiquer les problèmes liés à votre application. Pour plus de facilité, le modèle azd a déjà activé la journalisation sur le système de fichiers local, ainsi que leur expédition vers un espace de travail Log Analytics.

L’exemple d’application contient des instructions print() pour montrer cette fonctionnalité, comme illustré dans l’extrait suivant.

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

Dans la sortie azd, retrouvez le lien pour diffuser en continu les journaux App Service et accédez-y dans le navigateur. Le lien ressemble à ceci dans la sortie azd :

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Apprenez-en davantage sur la journalisation dans les applications Python dans la série sur la configuration d’Azure Monitor pour votre application Python.

7. Nettoyer les ressources

Pour supprimer toutes les ressources Azure dans le présent environnement de déploiement, exécutez azd down.

azd down