Partager via

Déployer une application web Flask ou FastAPI conteneurisée sur Azure App Service

  • Article

Ce tutoriel montre comment déployer une application web Python Flask ou FastAPI sur Azure App Service à l’aide de la fonctionnalité Web App pour conteneurs. Web App pour conteneurs fournit une rampe d’accès facile aux développeurs afin de tirer parti de la plateforme Azure App Service entièrement managée, mais qui souhaitent également disposer d’un seul artefact déployable contenant une application et toutes ses dépendances. Pour en savoir plus sur l’utilisation des conteneurs dans Azure, consultez Comparaison des options de conteneur Azure.

Dans ce tutoriel, vous utilisez l’interface Docker CLI et Docker pour éventuellement créer une image Docker et la tester localement. Vous utilisez l’interface Azure CLI pour créer une image Docker dans Azure Container Registry et la déployer sur Azure App Service. L’application web est configurée avec son identité managée affectée par le système (connexions sans mot de passe) et l’accès en fonction du rôle Azure pour extraire l’image Docker à partir d’Azure Container Registry pendant le déploiement. Vous pouvez également réaliser le déploiement avec Visual Studio Code avec l’extension Azure Tools installée.

Pour obtenir un exemple de conception et de création d’une image Docker à exécuter sur Azure Container Apps, consultez Déployer une application web Flask ou FastPI sur Azure Container Apps.

Remarque

Ce tutoriel montre comment créer une image Docker qui peut ensuite être exécutée sur App Service. Il n’est pas nécessaire pour utiliser App Service. Vous pouvez déployer du code directement à partir d’un espace de travail local sur App Service sans créer d’image Docker. Pour un exemple, consultez la section Démarrage rapide : déployer une application web Python (Django ou Flask) sur Azure App Service.

Prérequis

Pour terminer ce tutoriel, vous avez besoin de ce qui suit :

Obtenir l’exemple de code

Dans votre environnement local, obtenez le code.

git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart.git
cd msdocs-python-flask-webapp-quickstart

Ajouter des fichiers Dockerfile et .dockerignore

Ajoutez un fichier Dockerfile pour indiquer à Docker comment générer l’image. Le fichier Dockerfile spécifie l’utilisation de Gunicorn, un serveur web de niveau production qui transfère les requêtes web aux frameworks Flask et FastAPI. Les commandes ENTRYPOINT et CMD indiquent à Gunicorn de gérer les requêtes pour l’objet d’application.

# syntax=docker/dockerfile:1

FROM python:3.11

WORKDIR /code

COPY requirements.txt .

RUN pip3 install -r requirements.txt

COPY . .

EXPOSE 50505

ENTRYPOINT ["gunicorn", "app:app"]

Dans cet exemple, 50505 est utilisé pour le port de conteneur (interne), mais vous pouvez utiliser n’importe quel port gratuit.

Vérifiez le fichier requirements.txt pour vous assurer qu’il contient gunicorn.

Flask==2.2.2
gunicorn
Werkzeug==2.2.2

Ajoutez un fichier .dockerignore pour exclure les fichiers inutiles de l’image.

.git*
**/*.pyc
.venv/

Configurer gunicorn

Gunicorn peut être configuré avec un fichier gunicorn.conf.py. Lorsque le fichier gunicorn.conf.py se trouve dans le même répertoire où gunicorn est exécuté, il n’est pas nécessaire de spécifier son emplacement dans le fichier Dockerfile. Pour en savoir plus sur la spécification du fichier de configuration, consultez les paramètres Gunicorn.

Dans ce tutoriel, le fichier de configuration suggéré configure gunicorn pour augmenter son nombre de Workers en fonction du nombre de cœurs de processeur disponibles. Pour en savoir plus sur les paramètres du fichier gunicorn.conf.py, consultez la configuration de Gunicorn.

# Gunicorn configuration file
import multiprocessing

max_requests = 1000
max_requests_jitter = 50

log_file = "-"

bind = "0.0.0.0:50505"

workers = (multiprocessing.cpu_count() * 2) + 1
threads = workers

timeout = 120

Générer et exécuter l’image localement

Générer l’image localement.

docker build --tag flask-demo .

Remarque

Si la commande docker build renvoie une erreur, vérifiez que le démon Docker est en cours d’exécution. Sous Windows, assurez-vous que Docker Desktop est en cours d’exécution.

Exécutez l’image localement dans un conteneur Docker.

docker run --detach --publish 5000:50505 flask-demo

Ouvrez l’URL http://localhost:5000 dans votre navigateur pour voir l’application web s’exécutant localement.

L’option --detach exécute le conteneur en arrière-plan. L’option --publish mappe le port du conteneur à un port sur l’hôte. Le port de l’hôte (externe) est le premier de la paire, et le port du conteneur (interne) est le second. Pour plus d’informations, consultez Informations de référence sur l’exécution de Docker.

Créez un groupe de ressources et un Azure Container Registry.

  1. Exécutez la commande az login pour vous connecter à Azure.

    az login

  2. Exécutez la commande az upgrade pour vous assurer que votre version d’Azure CLI est en vigueur.

    az upgrade

  3. Créez un groupe avec la commande az group create.

    az group create --name web-app-simple-rg --location eastus

    Un groupe de ressources Azure est un conteneur logique dans lequel les ressources Azure sont déployées et gérées. Lors de la création d’un groupe de ressources, vous spécifiez un emplacement, tel que eastus.

  4. Créez un Azure Container Registry à l’aide de la commande az acr create.

    az acr create --resource-group web-app-simple-rg \
--name webappacr123 --sku Basic

    Remarque

    Le nom du registre doit être unique dans Azure. Si vous obtenez un message d’erreur, essayez avec un autre nom. Les noms de registre peuvent comporter 5 à 50 caractères alphanumériques. Les traits d’union et les traits de soulignement ne sont pas autorisés. Pour en savoir plus, consultez les règles de nom d’Azure Container Registry. Si vous utilisez un autre nom, veillez à utiliser votre nom plutôt que webappacr123 dans les commandes qui référencent le registre et les artefacts de registre dans les sections suivantes.

    Un Azure Container Registry est un registre Docker privé qui stocke les images à utiliser dans Azure Container Instances, Azure App Service, Azure Kubernetes Service et d’autres services. Lors de la création d’un registre, vous spécifiez un nom, une référence SKU et un groupe de ressources.

Générer l’image dans Azure Container Registry

Générez l’image Docker dans Azure à l’aide de la commande az acr build. La commande utilise le fichier Dockerfile dans le répertoire actif et envoie l’image au registre.

az acr build \
  --resource-group web-app-simple-rg \
  --registry webappacr123 \
  --image webappsimple:latest .

L’option --registry spécifie le nom du registre et l’option --image le nom de l’image. Le nom de l’image est au format suivant : registry.azurecr.io/repository:tag.

Déployer l’application web sur Azure

  1. Créez un plan App Service avec la commande az appservice plan.

    az appservice plan create \
--name webplan \
--resource-group web-app-simple-rg \
--sku B1 \
--is-linux

  2. Définissez une variable d’environnement pour votre ID d’abonnement. Elle est utilisée dans le paramètre --scope dans la commande suivante.

    SUBSCRIPTION_ID=$(az account show --query id --output tsv)

    La commande permettant de créer la variable d’environnement s’affiche pour l’interpréteur de commandes Bash. Modifiez la syntaxe appropriée pour d’autres environnements.

  3. Créez l’application web avec la commande azure webapp create.

    az webapp create \
--resource-group web-app-simple-rg \
--plan webplan --name webappsimple123 \
--assign-identity [system] \
--role AcrPull \
--scope /subscriptions/$SUBSCRIPTION_ID/resourceGroups/web-app-simple-rg \
--acr-use-identity --acr-identity [system] \
--container-image-name webappacr123.azurecr.io/webappsimple:latest

    Remarques :

    • Le nom de l’application web doit être unique dans Azure. Si vous obtenez un message d’erreur, essayez avec un autre nom. Le nom peut se composer de caractères alphanumériques et de traits d’union, mais ne peut pas commencer ou se terminer par un trait d’union. Pour en savoir plus, consultez les règles de nom Microsoft.Web.

    • Si vous utilisez un nom autre que webappacr123 pour votre Azure Container Registry, veillez à mettre à jour le paramètre --container-image-name de manière appropriée.

    • Les paramètres --assign-identity, --role et --scope activent l’identité managée affectée par le système sur l’application web et lui attribuent le rôle AcrPull sur le groupe de ressources. Cela permet à l’identité managée d’extraire des images de n’importe quel Azure Container Registry dans le groupe de ressources.

    • Les paramètres --acr-use-identity et --acr-identity configurent l’application web pour qu’elle utilise son identité managée affectée par le système afin d’extraire des images d’Azure Container Registry.

    • La création de l’application web peut prendre plusieurs minutes. Vous pouvez vérifier les journaux de déploiement avec la commande az webapp log tail. Par exemple : az webapp log tail --resource-group web-app-simple-rg --name webappsimple123. Si vous voyez des entrées contenant « préchauffage », le conteneur est en cours de déploiement.

    • L’URL de l’application web est <web-app-name>.azurewebsites.net, par exemple, https://webappsimple123.azurewebsites.net.

Mettre à jour et redéployer

Après avoir modifié le code, vous pouvez redéployer vers App Service avec les commandes az acr build et az webapp update.

Nettoyage

Toutes les ressources Azure créées dans ce tutoriel se trouvent dans le même groupe de ressources. Supprimer le groupe de ressources permet de supprimer toutes les ressources qu’il contient. Cette méthode est la plus rapide pour supprimer toutes les ressources Azure utilisées pour votre application.

Pour supprimer des ressources, utilisez la commande az group delete.

az group delete --name web-app-simple-rg

Vous pouvez également supprimer le groupe dans le Portail Azure ou dans Visual Studio Code et l’extension Azure Tools.

Étapes suivantes

Pour plus d’informations, consultez les ressources suivantes :