Démarrage rapide : Déployer une application web Python (Django, Flask ou FastAPI) sur Azure App Service

Article
09/13/2024

Remarque

Depuis le 1er juin 2024, toutes les applications App Service nouvellement créées ont la possibilité de générer un nom d’hôte par défaut unique en utilisant la convention d’affectation de noms <app-name>-<random-hash>.<region>.azurewebsites.net. Les noms d’application existants restent inchangés.

Exemple : myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Pour plus d’informations, reportez-vous à Nom d’hôte par défaut unique pour les ressources App Service.

Dans ce guide de démarrage rapide, vous déployez une application web Python (Django, Flask ou FastAPI) sur Azure App Service. Azure App Service est un service d’hébergement web complètement managé qui prend en charge les applications Python hébergées dans un environnement serveur Linux.

Pour effectuer ce démarrage rapide, les éléments suivants sont requis :

Compte Azure avec un abonnement actif. Créez un compte gratuitement.
Python 3.9 ou version ultérieure installé localement.

Notes

Cet article contient des instructions à jour sur le déploiement d’une application web Python à l’aide d’Azure App Service. Python sur Windows n’est plus pris en charge.

Exemple d’application

Ce guide de démarrage rapide peut être effectué en utilisant Flask, Django ou FastAPI. Un exemple d’application dans chaque framework est fourni pour vous aider à suivre ce guide de démarrage rapide. Téléchargez ou clonez l’exemple d’application sur votre station de travail locale.

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

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

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

Pour exécuter l’application localement :

Accédez au dossier de l’application :

cd msdocs-python-flask-webapp-quickstart

Créez un environnement virtuel pour l’application :

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

Installez les dépendances :
```
pip install -r requirements.txt
```
Exécutez l’application :
```
flask run
```
Accédez à l’exemple d’application disponible à l’adresse http://localhost:5000 dans un navigateur web.

Vous rencontrez des problèmes ? Faites-le nous savoir.

Accédez au dossier de l’application :

cd msdocs-python-django-webapp-quickstart

Créez un environnement virtuel pour l’application :

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

Installez les dépendances :
```
pip install -r requirements.txt
```
Exécutez l’application :
```
python manage.py runserver
```
Accédez à l’exemple d’application disponible à l’adresse http://localhost:8000 dans un navigateur web.

Vous rencontrez des problèmes ? Faites-le nous savoir.

Accédez au dossier de l’application :

cd msdocs-python-fastapi-webapp-quickstart

Créez un environnement virtuel pour l’application :

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

Installez les dépendances :
```
pip install -r requirements.txt
```
Exécutez l’application :
```
uvicorn main:app --reload
```
Accédez à l’exemple d’application disponible à l’adresse http://localhost:8000 dans un navigateur web.

Vous rencontrez des problèmes ? Faites-le nous savoir.

Créer une application web dans Azure

Pour héberger votre application dans Azure, vous avez besoin de créer une application web Azure App Service dans Azure. Vous pouvez créer une application web à l’aide d’Azure CLI, de VS Code, du Pack d’extension Azure Tools ou du Portail Azure.

Les commandes Azure CLI peuvent être exécutées sur un ordinateur sur lequel l’interface Azure CLI est installée.

Azure CLI a une commande az webapp up qui crée les ressources nécessaires et déploie votre application en une seule étape.

Si nécessaire, connectez-vous à Azure à l’aide d’az login.

az login

Créez l’application web et les autres ressources, puis déployez votre code dans Azure en utilisant la commande az webapp up.

az webapp up --runtime PYTHON:3.9 --sku B1 --logs

Le paramètre --runtime spécifie la version de Python que votre application exécute. Cet exemple utilise Python 3.9. Pour lister tous les runtimes disponibles, utilisez la commande az webapp list-runtimes --os linux --output table.
Le paramètre --sku définit la taille (UC, mémoire) et le coût du plan App service. Cet exemple utilise le plan de service B1 (De base), qui entraîne un coût réduit dans votre abonnement Azure. Pour obtenir la liste complète des plans App Service, consultez la page de Tarification App Service.
L’indicateur --logs configure la journalisation par défaut nécessaire pour activer la consultation du flux de journal immédiatement après le lancement de l’application web.
Vous pouvez éventuellement spécifier un nom avec l’argument --name <app-name>. Si vous n’en fournissez pas, le nom est généré automatiquement.
Vous pouvez éventuellement inclure l’argument --location <location-name> où <location_name> est une région Azure disponible. Vous pouvez récupérer une liste de régions autorisées pour votre compte Azure en exécutant la commande az appservice list-locations.

La commande peut prendre quelques minutes. Quand la commande est exécutée, elle fournit des messages sur la création du groupe de ressources, du plan App Service et de la ressource d’application, sur la configuration de la journalisation et sur le déploiement ZIP. Elle affiche ensuite le message « Vous pouvez lancer l’application sur http://<app-name>.azurewebsites.net », qui est l’URL de l’application sur Azure.

The webapp '<app-name>' doesn't exist
Creating Resource group '<group-name>' ...
Resource group creation complete
Creating AppServicePlan '<app-service-plan-name>' ...
Creating webapp '<app-name>' ...
Configuring default logging for the app, if not already enabled
Creating zip with contents of dir /home/cephas/myExpressApp ...
Getting scm site credentials for zip deployment
Starting zip deployment. This operation can take a while to complete ...
Deployment endpoint responded with status code 202
You can launch the app at http://<app-name>.azurewebsites.net
{
  "URL": "http://<app-name>.azurewebsites.net",
  "appserviceplan": "<app-service-plan-name>",
  "location": "centralus",
  "name": "<app-name>",
  "os": "<os-type>",
  "resourcegroup": "<group-name>",
  "runtime_version": "python|3.9",
  "runtime_version_detected": "0.0",
  "sku": "FREE",
  "src_path": "<your-folder-location>"
}

Notes

La commande az webapp up exécute les actions suivantes :

Créer un groupe de ressources par défaut.
Créer un plan App Service par défaut.
Créer une application avec le nom spécifié.
Décompresser tous les fichiers à partir du répertoire de travail actuel, avec l’automatisation de build activée.
Mettre en cache les paramètres localement dans le fichier .azure/config afin de ne pas avoir à les spécifier à nouveau lors du déploiement ultérieur avec des commandes az webapp up ou az webapp à partir du dossier de projet. Les valeurs mises en cache sont utilisées automatiquement par défaut.

Pour créer des ressources Azure dans VS Code, vous devez avoir installé le pack d’extension Azure Tools et être connecté à Azure à partir de VS Code.

Télécharger le pack d’extension Azure Tools

Dans le dossier de l’application, ouvrez VS Code :

code .

Instructions	Capture d'écran
Recherchez l’icône Azure dans la barre d’outils située à gauche. Sélectionnez-la pour faire apparaître l’extension Azure Tools pour VS Code. Si vous ne voyez pas l’icône Azure Tools, vérifiez que l’extension Azure Tools pour VS Code est installée.
Dans l’extension Azure Tools for VS Code : Recherchez la section RESOURCES et sélectionnez votre abonnement. Sélectionnez + (Créer une ressource...)
Choisissez l’option Créer une application web App Service.
Entrez le nom msdocs-python-webapp-quickstart-XYZ pour cette application web, où XYZ représente trois caractères uniques. Lors du déploiement, ce nom est utilisé comme nom de votre application sous la forme `https://<app-name>.azurewebsites.net`.
Sélectionnez la pile d’exécution de l’application. Dans cet exemple, sélectionnez Python 3.9.
Sélectionnez le plan App Service (niveau tarifaire) de cette application web. Le plan App Service contrôle le nombre de ressources (processeur/mémoire) disponibles pour votre application et le prix que vous devez payer. Pour cet exemple, sélectionnez le niveau tarifaire De base (B1). Ce plan est facturé à un coût réduit par rapport à votre abonnement Azure. Il est recommandé pour obtenir de meilleures performances par rapport au plan Gratuit (F1).
Sélectionnez le bouton Déployer dans la notification « Création d’une nouvelle application web ».
Sélectionnez le dossier de démarrage rapide dans lequel vous travaillez comme celui à déployer.
Répondez Oui pour mettre à jour votre configuration de build et améliorer les performances de déploiement.
Une fois le déploiement terminé, une notification s’affiche dans le coin inférieur droit de VS Code. Vous pouvez utiliser cette notification pour accéder à votre application web.

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

Instructions	Capture d'écran
Dans le portail Azure : Entrez app services dans la barre de recherche située en haut du portail Azure. Sélectionnez l’élément intitulé App Services sous le titre Services dans le menu qui apparaît sous la barre de recherche.
Dans la page App Services , sélectionnez + Créer, puis + Application web dans le menu déroulant.
Dans la page Créer une application web, renseignez le formulaire comme suit. Groupe de ressources → Sélectionnez Créer et utilisez le nom msdocs-python-webapp-quickstart. Nom → msdocs-python-webapp-quickstart-XYZ où XYZ représente trois caractères aléatoires. Ce nom doit être unique au sein d’Azure. Pile d’exécution → Python 3.9. Région → Toute région Azure près de chez vous. App Service Plan → Sous Plan tarifaire, sélectionnez Explorer les plans tarifaires pour sélectionner un autre plan de App Service.
Le plan App Service contrôle le montant de ressources (UC/mémoire) disponibles pour votre application et le coût de ces ressources. Pour cet exemple, sous Dev/Test, sélectionnez le plan B1 de base . Le plan de base B1 est facturé à un coût réduit par rapport à votre compte Azure. Il est recommandé pour obtenir de meilleures performances par rapport au plan F1 (Gratuit). Lorsque vous avez terminé, sélectionnez Sélectionner pour appliquer vos modifications.
Dans la page principale Créer une application web, sélectionnez Vérifier + créer au bas de l’écran. Vous accédez ainsi à la page Vérifier. Sélectionnez Créer pour créer votre service d’application.

Vous rencontrez des problèmes ? Faites-le nous savoir.

Déployer votre code d’application sur Azure

Azure App Service prend en charge plusieurs méthodes de déploiement de votre code d’application sur Azure, notamment GitHub Actions et tous les principaux outils de CI/CD. Cet article se concentre sur le déploiement de votre code à partir de votre station de travail locale vers Azure.

Étant donné que la commande az webapp up a créé les ressources nécessaires et déployé votre application en une seule étape, vous pouvez passer à l’étape suivante.

Vous pouvez déployer votre code d’application à partir d’un référentiel Git local vers Azure en configurant un dépôt Git distant dans votre référentiel local qui pointe vers le référentiel auquel vous souhaitez envoyer le code. L’URL du dépôt distant et les informations d’identification Git nécessaires à la configuration peuvent être récupérées à l’aide du portail Azure ou d’Azure CLI.

Azure portal
Azure CLI

Instructions	Capture d'écran
Accédez au service d’application de votre application. Entrez le nom de votre service d’application dans la zone de recherche en haut de l’écran. Sous l’en-tête Ressources, sélectionnez App Service pour y accéder.
Dans la page de l’instance App Service : Sélectionnez Centre de déploiement dans le menu situé à gauche de l’écran. Sélectionnez Git local dans la liste déroulante intitulée Source. Sélectionnez Enregistrer.
Après avoir enregistré la page, celle-ci s’actualise et affiche l’adresse du dépôt Git distant. Copiez la valeur de l’URI de Git Clone, car cette valeur sera utilisée pour configurer un dépôt Git distant dans une étape ultérieure.
Dans la page Centre de déploiement : Accédez à l’onglet Informations d’identification FTPS/Git local. Localisez le nom d’utilisateur et le mot de passe du git local sous les informations d’identification Étendue de l’application. Gardez cet écran ouvert afin de pouvoir copier ces informations d’identification momentanément lorsque vous déployez votre code sur le dépôt distant. Veillez à copier le nom d’utilisateur Git local, qui commence par un `$`, par exemple `$msdocs-python-webapp-quickstart-123`. Lorsque vous envoyez (push) du code vers le dépôt Git distant pour la première fois, ces informations d’identification sont nécessaires pour vous authentifier auprès du dépôt distant.

Ensuite, dans le répertoire racine de votre application, configurez un Git distant qui pointe vers Azure à l’aide de l’URL Git du site distant Azure obtenue à l’étape précédente.

git remote add azure <git-deployment-url>

Vous pouvez désormais envoyer (push) du code de votre dépôt Git local vers Azure à l’aide du dépôt Git distant que vous venez de configurer. La branche de déploiement par défaut pour App Service est master, mais de nombreux référentiels Git abandonnent master et utilisent main. Vous pouvez spécifier le mappage du nom de la branche locale au nom de la branche distante dans l’envoi (comme indiqué ci-dessous) ou configurer le paramètre DEPLOYMENT_BRANCH de votre application.

git push azure main:master

La première fois que vous envoyez (push) du code vers Azure, Git vous demandera les informations d’identification de déploiement Azure que vous avez obtenues à l’étape précédente. Git mettra ensuite en cache ces informations d’identification afin que vous n’ayez pas à les entrer à nouveau lors des déploiements suivants.

Tout d’abord, configurez la source de déploiement pour votre application web en tant que Git local à l’aide de la commande az webapp deployment source. Cette commande génère l’URL du dépôt Git distant vers lequel vous allez envoyer (push) le code. Faites une copie de cette valeur, car vous en aurez besoin lors d’une étape ultérieure.

bash
Terminal PowerShell

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deployment source config-local-git \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --output tsv

# Change these values to the ones used to create the App Service.
$RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
$APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deployment source config-local-git `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME `
    --output tsv

Récupérez les informations d’identification de déploiement pour votre application. Git en a besoin pour s’authentifier auprès d’Azure lorsque vous envoyez du code à Azure dans une étape ultérieure.

bash
Terminal PowerShell

az webapp deployment list-publishing-credentials \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --query "{Username:publishingUserName, Password:publishingPassword}" \
    --output table

az webapp deployment list-publishing-credentials `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME `
    --query "{Username:publishingUserName, Password:publishingPassword}" `
    --output table

Ensuite, dans le répertoire racine de votre application, configurez un Git distant qui pointe vers Azure à l’aide de l’URL Git du site distant Azure obtenue à l’étape précédente.

git remote add azure <git-deployment-url>

git push azure main:master

Les applications peuvent être déployées sur Azure en créant un fichier ZIP du code d’application et en le chargeant sur Azure. Les fichiers ZIP peuvent être chargés sur Azure à l’aide d’Azure CLI ou d’un client HTTP comme cURL.

Activer l’automatisation de build

Lors du déploiement d’un fichier ZIP de votre code Python, vous avez besoin de définir un indicateur pour activer l’automatisation de build Azure. L’automatisation de build va permettre d’installer tous les prérequis nécessaires et d’empaqueter l’application pour qu’elle s’exécute sur Azure.

L’automatisation de build dans Azure est activée en définissant le paramètre d’application SCM_DO_BUILD_DURING_DEPLOYMENT dans le portail Azure ou Azure CLI.

Azure portal
Azure CLI

Instructions	Capture d'écran
Dans la page de l’application web dans le portail Azure : Sélectionnez Configuration sous l’en-tête Paramètres dans la barre d’outils de gauche pour afficher les paramètres d’application. Sous Paramètres de l’application, sélectionnez Nouveau paramètre d’application.
À l’aide de la boîte de dialogue, entrez un nouveau paramètre avec : Nom → SCM_DO_BUILD_DURING_DEPLOYMENT Valeur → true
Sélectionnez Enregistrer pour enregistrer vos paramètres.

Utilisez la commande az webapp config appsettings set pour définir le paramètre SCM_DO_BUILD_DURING_DEPLOYMENT sur la valeur true.

bash
Terminal PowerShell

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp config appsettings set \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $APP_SERVICE_NAME \
    --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp config appsettings set `
    --resource-group $resourceGroupName `
    --name $appServiceName `
    --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

Créer un fichier ZIP de votre application

Ensuite, créez un fichier ZIP de votre application. Vous avez uniquement besoin d’inclure les composants de l’application elle-même. Vous n’avez pas besoin d’inclure des fichiers ou des répertoires qui commencent par un point (.) comme .venv, .gitignore, .github ou .vscode.

Windows
macOS/Linux

Sur Windows, utilisez un programme tel que 7-Zip pour créer le fichier ZIP nécessaire au déploiement de l’application.

Sur macOS ou Linux, vous pouvez utiliser l’utilitaire zip intégré pour créer un fichier ZIP.

zip -r <file-name>.zip . -x '.??*'

Charger le fichier ZIP sur Azure

Une fois que vous disposez d’un fichier ZIP, vous pouvez le télécharger sur Azure à l’aide d’Azure CLI ou d’un client HTTP tel que cURL.

Azure CLI
cURL

La commande az webapp deploy peut être utilisée pour charger et déployer un fichier zip sur Azure.

bash
Terminal PowerShell

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deploy \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --src-path <zip-file-path>

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp deploy `
    --name $appServiceName `
    --resource-group $resourceGroupName `
    --src-path <zip-file-path>

Pour utiliser cURL afin de charger votre fichier ZIP sur Azure, vous avez besoin du nom d’utilisateur et du mot de passe de déploiement de votre instance App Service. Ces informations d’identification peuvent être obtenues à partir du portail Azure.

Dans la page de l’application web, sélectionnez Centre de déploiement dans le menu situé à gauche.
Sélectionnez l’onglet Informations d’identification FTPS.
Le nom d’utilisateur et le mot de passe sont indiqués sous le titre Étendue de l’application. Pour les déploiements de fichiers zip, utilisez uniquement la partie du nom d’utilisateur après le caractère \ qui commence par $, par exemple $msdocs-python-webapp-quickstart-123. Ces informations d’identification seront nécessaires dans la commande cURL.

Exécutez la commande curl suivante pour charger votre fichier zip sur Azure et déployer votre application. Le nom d’utilisateur correspond au nom d’utilisateur de déploiement obtenu à l’étape 3. Quand cette commande s’exécute, vous êtes invité à entrer le mot de passe de déploiement.

bash
Terminal PowerShell

curl -X POST \
    -H 'Content-Type: application/zip' \
    -u '<deployment-user>' \
    -T <zip-file-name> \
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

Pour PowerShell, veillez à placer le nom d’utilisateur entre guillemets simples afin que PowerShell n’essaie pas d’interpréter le nom d’utilisateur comme une variable PowerShell.

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

En fonction de la bande passante de votre réseau, le chargement des fichiers sur Azure prend généralement entre 10 et 30 secondes.

Vous rencontrez des problèmes ? Tout d’abord, reportez-vous au Guide de dépannage. Si cela n’aide pas, faites-nous savoir.

Configurer le script de démarrage

En fonction de la présence de certains fichiers dans un déploiement, App Service détecte automatiquement si une application est une application Django ou Flask et effectue les étapes par défaut pour exécuter votre application. Pour les applications basées sur d’autres infrastructures web tels que FastAPI, vous devez configurer un script de démarrage pour permettre à App Service d’exécuter votre application. Sinon, App Service exécute une application en lecture seule par défaut située dans le dossier opt/defaultsite.

Pour en savoir plus sur la façon dont App Service exécute des applications Python et comment vous pouvez configurer et personnaliser son comportement avec votre application, consultez Configurer une application Python Linux pour Azure App Service.

App Service détecte automatiquement la présence d’une application Flask. Aucune configuration supplémentaire n'est nécessaire pour ce guide de démarrage rapide.

Pour FastAPI, vous devez configurer une commande de démarrage personnalisée pour permettre à App Service d’exécuter votre application. La commande suivante démarre Gunicorn avec 2 processus Worker Uvicorn : gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Tout d’abord, configurez la commande de démarrage à l’aide de la commande az webapp config set.

az webapp config set \
    --startup-file "gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app" \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Ensuite, redémarrez l’application web à l’aide de la commande az webapp restart.

az webapp restart \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Instructions	Capture d'écran
Tout d’abord, configurez la commande de démarrage dans Azure App Service. Accédez à la page de l’instance App Service dans le portail Azure. Sélectionnez Configuration sous le titre Paramètres dans le menu situé à gauche de la page. Vérifiez que l’onglet Paramètres généraux est sélectionné. Dans le champ Commande de démarrage, entrez gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main :app. Cliquez sur Enregistrer pour enregistrer vos modifications. Attendez la notification indiquant que les paramètres sont mis à jour avant de continuer.
Ensuite, redémarrez l’application web. Sélectionnez Vue d’ensemble dans le menu situé à gauche de la page. Dans le menu supérieur, sélectionnez Redémarrer.

Instructions

Capture d'écran

Tout d’abord, configurez la commande de démarrage dans Azure App Service. Accédez à la page de l’instance App Service dans le portail Azure.

Sélectionnez Configuration sous le titre Paramètres dans le menu situé à gauche de la page.
Vérifiez que l’onglet Paramètres généraux est sélectionné.
Dans le champ Commande de démarrage, entrez gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main :app.
Cliquez sur Enregistrer pour enregistrer vos modifications.
Attendez la notification indiquant que les paramètres sont mis à jour avant de continuer.

Capture d’écran de l’emplacement sur le Portail Azure où vous configurez la commande de démarrage.

Ensuite, redémarrez l’application web.

Sélectionnez Vue d’ensemble dans le menu situé à gauche de la page.
Dans le menu supérieur, sélectionnez Redémarrer.

Capture d’écran montrant comment réinitialiser l’application web sur le Portail Azure.

Accéder à l’application

Accédez à l’application déployée à l’aide de votre navigateur web à l’URL http://<app-name>.azurewebsites.net. Si vous voyez s’afficher une page d’application par défaut, attendez une minute, puis actualisez le navigateur.

L’exemple de code Python exécute un conteneur Linux dans App Service avec une image intégrée.

Capture d’écran de l’application en cours d’exécution dans Azure

Félicitations ! Vous venez de déployer votre application Python sur App Service.

Vous rencontrez des problèmes ? Tout d’abord, reportez-vous au Guide de dépannage. Si cela n’aide pas, faites-nous savoir.

Diffuser les journaux d’activité en continu

Azure App Service capture tous les messages générés dans la console pour vous aider à diagnostiquer les problèmes liés à votre application. Les exemples d’applications incluent des instructions print() pour illustrer cette fonctionnalité.

@app.route('/')
def index():
   print('Request for index page received')
   return render_template('index.html')

@app.route('/favicon.ico')
def favicon():
    return send_from_directory(os.path.join(app.root_path, 'static'),
                               'favicon.ico', mimetype='image/vnd.microsoft.icon')

@app.route('/hello', methods=['POST'])
def hello():
   name = request.form.get('name')

   if name:
       print('Request for hello page received with name=%s' % name)
       return render_template('hello.html', name = name)
   else:
       print('Request for hello page received with no name or blank name -- redirecting')
       return redirect(url_for('index'))

def index(request):
    print('Request for index page received')
    return render(request, 'hello_azure/index.html')

@csrf_exempt
def hello(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        
        if name is None or name == '':
            print("Request for hello page received with no name or blank name -- redirecting")
            return redirect('index')
        else:
            print("Request for hello page received with name=%s" % name)
            context = {'name': name }
            return render(request, 'hello_azure/hello.html', context)
    else:

@app.get("/", response_class=HTMLResponse)
async def index(request: Request):
    print('Request for index page received')
    return templates.TemplateResponse('index.html', {"request": request})

@app.get('/favicon.ico')
async def favicon():
    file_name = 'favicon.ico'
    file_path = './static/' + file_name
    return FileResponse(path=file_path, headers={'mimetype': 'image/vnd.microsoft.icon'})

@app.post('/hello', response_class=HTMLResponse)
async def hello(request: Request, name: str = Form(...)):
    if name:
        print('Request for hello page received with name=%s' % name)
        return templates.TemplateResponse('hello.html', {"request": request, 'name':name})
    else:
        print('Request for hello page received with no name or blank name -- redirecting')
        return RedirectResponse(request.url_for("index"), status_code=status.HTTP_302_FOUND)

Vous pouvez vérifier le contenu des journaux de diagnostic App Service à l’aide d’Azure CLI, de VS Code ou du Portail Azure.

Tout d’abord, vous devez configurer Azure App Service de sorte à générer les journaux dans le système de fichiers App Service à l’aide de la commande az webapp log config.

bash
Terminal PowerShell

az webapp log config \
    --web-server-logging filesystem \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log config `
    --web-server-logging 'filesystem' `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Pour envoyer les journaux en streaming, exécutez la commande az webapp log tail.

bash
Terminal PowerShell

az webapp log tail \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log tail `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Actualisez la page d’accueil de l’application ou essayez d’autres requêtes pour générer des messages de journal. Le résultat doit être semblable à ce qui suit.

Starting Live Log Stream ---

2021-12-23T02:15:52.740703322Z Request for index page received
2021-12-23T02:15:52.740740222Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET / HTTP/1.1" 200 1360 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.841043070Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.884541951Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:53.043211176Z 169.254.130.1 - - [23/Dec/2021:02:15:53 +0000] "GET /favicon.ico HTTP/1.1" 404 232 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

2021-12-23T02:16:01.304306845Z Request for hello page received with name=David
2021-12-23T02:16:01.304335945Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "POST /hello HTTP/1.1" 200 695 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.398399251Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.430740060Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

Instructions	Capture d'écran
Tout d’abord, vous devez activer le streaming des journaux dans Azure App Service. Dans la section App Service de l’extension Azure Tools for VS Code, cliquez avec le bouton droit sur votre instance App Service et sélectionnez Commencer le streaming des journaux dans le menu.
Les journaux de la console s’affichent dans la fenêtre Sortie de VS Code. Actualisez la page d’accueil de l’application ou essayez d’autres requêtes pour générer des messages de journal. Vous verrez tous les messages de journal générés par votre application ainsi que les autres messages générés par le service dans la sortie.

Instructions	Capture d'écran
Tout d’abord, vous devez activer le streaming des journaux dans Azure App Service. Accédez à la page de l’instance App Service dans le portail Azure. Sélectionnez Journaux App Service sous le titre Supervision dans le menu situé à gauche de la page. Faites passer la propriété Journalisation des applications de Désactivé à Système de fichiers. Entrez une période de rétention de 30 jours pour les journaux. Cliquez sur Enregistrer pour enregistrer vos modifications.
Sélectionnez Flux de journal dans la section Surveillance dans le volet de navigation à gauche. Actualisez la page d’accueil de l’application ou essayez d’autres requêtes pour générer des messages de journal. Vous verrez tous les messages de journal générés par votre application et les messages générés par le service dans la sortie.

Instructions

Capture d'écran

Tout d’abord, vous devez activer le streaming des journaux dans Azure App Service. Accédez à la page de l’instance App Service dans le portail Azure.

Sélectionnez Journaux App Service sous le titre Supervision dans le menu situé à gauche de la page.
Faites passer la propriété Journalisation des applications de Désactivé à Système de fichiers.
Entrez une période de rétention de 30 jours pour les journaux.
Cliquez sur Enregistrer pour enregistrer vos modifications.

Capture d’écran de l’emplacement dans le portail Azure où vous pouvez activer les journaux de diffusion en continu.

Sélectionnez Flux de journal dans la section Surveillance dans le volet de navigation à gauche. Actualisez la page d’accueil de l’application ou essayez d’autres requêtes pour générer des messages de journal.

Vous verrez tous les messages de journal générés par votre application et les messages générés par le service dans la sortie.

Capture d’écran montrant la façon d’afficher les journaux dans le portail Azure.

Vous rencontrez des problèmes ? Tout d’abord, reportez-vous au Guide de dépannage. Si cela n’aide pas, faites-nous savoir.

Nettoyer les ressources

Lorsque vous en avez terminé avec l’exemple d’application, vous pouvez supprimer d’Azure toutes les ressources pour l’application. La suppression du groupe de ressources garantit que vous n’avez pas de frais supplémentaires et vous permet de conserver votre abonnement Azure non limité. Supprimer le groupe de ressources permet également de supprimer toutes les ressources qu’il contient. Cette méthode est la plus rapide pour supprimer toutes les ressources Azure de votre application.

Supprimez le groupe de ressources à l’aide de la commande az group delete.

az group delete \
    --name msdocs-python-webapp-quickstart \
    --no-wait

Avec l’argument --no-wait, la commande peut retourner une sortie avant la fin de l’opération.

Instructions	Capture d'écran
Dans l’extension Azure Tools for VS Code : Recherchez la section RESOURCES. Sélectionnez l’icône Regrouper par, puis sélectionnez Regrouper par groupe de ressources.
Dans la liste des ressources, recherchez le groupe de ressources à supprimer, cliquez dessus avec le bouton droit, puis sélectionnez Supprimer le groupe de ressources.... Vous serez invité à confirmer la suppression en entrant le nom du groupe de ressources dans la boîte de dialogue.

Effectuez ces étapes lors de la connexion au portail Azure pour supprimer un groupe de ressources.

Instructions	Capture d'écran
Accédez au groupe de ressources sur le portail Azure. Entrez le nom de votre groupe de ressources dans la barre de recherche en haut de la page. Sous le titre Groupes de ressources, sélectionnez le nom du groupe de ressources auquel vous voulez accéder.
Sélectionnez le bouton Supprimer le groupe de ressources en haut de la page.
Dans la boîte de dialogue de confirmation, entrez le nom du groupe de ressources pour confirmer la suppression. Sélectionnez Supprimer pour supprimer le groupe de ressources.