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

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

1. Accédez au dossier de l’application :

   cd msdocs-python-flask-webapp-quickstart
   

2. Créez un environnement virtuel pour l’application :

   • Windows
   • macOS/Linux

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

3. Installez les dépendances :

   pip install -r requirements.txt
   

4. Exécutez l’application :

   flask run
   

5. 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.

1. Accédez au dossier de l’application :

   cd msdocs-python-django-webapp-quickstart
   

2. Créez un environnement virtuel pour l’application :

   • Windows
   • macOS/Linux

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

3. Installez les dépendances :

   pip install -r requirements.txt
   

4. Exécutez l’application :

   python manage.py runserver
   

5. 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.

1. Accédez au dossier de l’application :

   cd msdocs-python-fastapi-webapp-quickstart
   

2. Créez un environnement virtuel pour l’application :

   • Windows
   • macOS/Linux

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

3. Installez les dépendances :

   pip install -r requirements.txt
   

4. Exécutez l’application :

   uvicorn main:app --reload
   

5. 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.

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>"
}

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.

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.

É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.

Étant donné que l’étape précédente 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.

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.

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.

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.

# 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>

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

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

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.

App Service détecte automatiquement la présence d’une application Django. 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

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.

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

Utilisez Azure CLI ou le Portail Azure pour configurer la commande de démarrage.

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.

App Service détecte automatiquement la présence d’une application Django. 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.

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.

@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)

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.

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.

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"

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.

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.