Quickstart: Een Python-web-app (Django, Flask of FastAPI) implementeren in Azure-app Service

mkdir flask-quickstart
cd flask-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
azd up

mkdir django-quickstart
cd django-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart
azd up

mkdir fastapi-quickstart
cd fastapi-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart
azd up

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. Ga naar de applicatiemap:

   cd msdocs-python-flask-webapp-quickstart
   

2. Maak een virtuele omgeving voor de app:

   • Windows
   • macOS/Linux

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

3. De afhankelijkheden installeren:

   pip install -r requirements.txt
   

4. De app uitvoeren:

   flask run
   

5. Blader naar de voorbeeldtoepassing in http://localhost:5000 een webbrowser.

   

Ondervindt u problemen? Laat het ons weten.

1. Ga naar de applicatiemap:

   cd msdocs-python-django-webapp-quickstart
   

2. Maak een virtuele omgeving voor de app:

   • Windows
   • macOS/Linux

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

3. De afhankelijkheden installeren:

   pip install -r requirements.txt
   

4. De app uitvoeren:

   python manage.py runserver
   

5. Blader naar de voorbeeldtoepassing in http://localhost:8000 een webbrowser.

   

Ondervindt u problemen? Laat het ons weten.

1. Ga naar de applicatiemap:

   cd msdocs-python-fastapi-webapp-quickstart
   

2. Maak een virtuele omgeving voor de app:

   • Windows
   • macOS/Linux

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

3. De afhankelijkheden installeren:

   pip install -r requirements.txt
   

4. De app uitvoeren:

   uvicorn main:app --reload
   

5. Blader naar de voorbeeldtoepassing in http://localhost:8000 een webbrowser.

   

Ondervindt u problemen? Laat het ons weten.

Azure CLI-opdrachten kunnen worden uitgevoerd op een computer waarop de Azure CLI is geïnstalleerd.

Maak de Azure-resources aan en deploy vervolgens je applicatie met aparte Azure CLI-commando's.

Meld u zo nodig aan bij Azure met az login.

az login

Vervang <app-name> door een wereldwijd unieke naam. Maak een resourcegroep en een App Service-plan aan, en maak vervolgens de webapp aan met az webapp create.

az group create --name myResourceGroup --location eastus
az appservice plan create --name myAppServicePlan --resource-group myResourceGroup --sku P0v3 --is-linux
az webapp create --name <app-name> --resource-group myResourceGroup --plan myAppServicePlan --runtime "PYTHON:3.14"
az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

• Gebruik de parameter --runtime om de versie van Python aan te geven waarop je app draait. Dit voorbeeld gebruikt Python 3.14. Om ondersteunde Python-runtimes weer te geven, gebruik az webapp list-runtimes --os-type linux --runtime python --output table.
• Gebruik de --sku parameter om de grootte (CPU en geheugen) en kosten van het App Service-plan te definiëren. Dit voorbeeld gebruikt het P0v3 (Premium v3) serviceplan, wat kosten met zich meebrengt in je Azure-abonnement. Zie App Service-prijzen voor een volledige lijst met App Service-abonnementen.
• Vervang eastus door je voorkeursregio. Om beschikbare regio's te vermelden, voer az account list-locations uit met --output table.
• De SCM_DO_BUILD_DURING_DEPLOYMENT instelling maakt de Oryx-build mogelijk, inclusief de installatie van de afhankelijkheden in requirements.txt, wanneer je het bronarchief uitrolt.

Maak een ZIP-bestand aan met de applicatiebestanden, inclusief requirements.txt, in de hoofdmap van het archief. Sluit lokale bestanden uit zoals .venv, .git en .env. Voor platformspecifieke instructies, zie Een ZIP-bestand van je applicatie maken op het tabblad Implementeren met een ZIP-bestand. Implementeer vervolgens het archief met az webapp deploy:

az webapp deploy --name <app-name> --resource-group myResourceGroup --src-path <zip-file-path> --type zip

De uitrol kan een paar minuten duren. Ga naar https://<app-name>.azurewebsites.net om je app te bekijken. Om logs te streamen, schakel je ze in door te draaien az webapp log config --name <app-name> --resource-group myResourceGroup --docker-container-logging filesystem, en voer vervolgens az webapp log tail --name <app-name> --resource-group myResourceGroup uit.

Als u Azure-resources wilt maken in VS Code, moet het Azure Tools-extensiepakket zijn geïnstalleerd en zijn aangemeld bij Azure vanuit VS Code.

Open VS Code in de toepassingsmap:

code .

Instructies	Schermafbeelding
Zoek het Azure-pictogram op de werkbalk aan de linkerkant. Selecteer deze om de Azure Tools for VS Code-extensie weer te geven. Als u het pictogram Azure Tools niet ziet, controleert u of de Azure Tools-extensie voor VS Code is geïnstalleerd.
In de Azure Tools-extensie voor VS Code: Zoek de sectie RESOURCES en selecteer uw abonnement. Selecteren + (Resource maken...)
Kies de optie App Service-web-app maken...
Voer de naam msdocs-python-webapp-quickstart-XYZ in voor deze web-app, waarbij XYZ uit drie unieke tekens bestaat. Wanneer deze wordt geïmplementeerd, wordt deze naam gebruikt als uw app-naam.
Selecteer de runtimestack voor de toepassing. In dit voorbeeld selecteert u Python 3.14.
Selecteer het App Service-plan (prijscategorie) voor deze web-app. Het App Service-plan bepaalt hoeveel resources (CPU/geheugen) beschikbaar zijn voor uw app en hoeveel u betaalt. Selecteer voor dit voorbeeld de prijscategorie Basic (B1 ). Voor dit abonnement worden kleine kosten in rekening gebracht voor uw Azure-abonnement, maar wordt aanbevolen voor betere prestaties ten opzichte van de gratis laag (F1).
Selecteer de knop Implementeren in de melding Nieuwe web-app gemaakt.
Selecteer de snelstartmap waarin u werkt als de map die u wilt implementeren.
Antwoord Ja om de buildconfiguratie bij te werken en de implementatieprestaties te verbeteren.
Wanneer de implementatie is voltooid, wordt er een melding weergegeven in de rechterbenedenhoek van VS Code. U kunt deze melding gebruiken om naar uw web-app te bladeren.

Meld u aan bij Azure Portal en volg deze stappen om uw Azure-app Service-resources te maken.

Instructies	Schermafbeelding
In de Azure-portal: Voer app-services in de zoekbalk boven aan Azure Portal in. Selecteer het item met het label App Services onder de kop Services in het menu dat onder de zoekbalk wordt weergegeven.
Op de pagina App Services, selecteer + Maken en selecteer vervolgens + Web-app in de vervolgkeuzelijst.
Vul het formulier als volgt in op de pagina Web-app maken. Resourcegroep → Selecteer Nieuwe maken en gebruik de naam msdocs-python-webapp-quickstart. Naam → msdocs-python-webapp-quickstart-XYZ waarbij XYZ uit drie willekeurige tekens bestaat. Deze naam moet uniek zijn binnen Azure. Runtimestack → Python 3.14. Regio → Elke Azure-regio bij u in de buurt. App Service-plan → Onder prijsplan selecteert u Prijsplannen verkennen om een ander App Service-plan te selecteren.
Het App Service-plan bepaalt de hoeveelheid resources (CPU/geheugen) die beschikbaar zijn voor uw app en de kosten van deze resources. Voor dit voorbeeld selecteert u onder Dev/Test het Basic B1-abonnement . Voor het Basic B1-abonnement worden kleine kosten in rekening gebracht voor uw Azure-account, maar dit wordt aanbevolen voor betere prestaties ten opzichte van het gratis F1-abonnement. Wanneer u klaar bent, selecteert u Selecteren om uw wijzigingen toe te passen.
Selecteer op de hoofdpagina Create Web App de Beoordelen + maken-optie onder aan de pagina. Hiermee gaat u naar de beoordelingspagina. Selecteer Maken om uw App Service te maken.

De Azure CLI-commando's in de voorgaande stap creëerden de resources en deployeerden je applicatie. Je kunt doorgaan naar de volgende stap.

Aangezien in de vorige stap de benodigde resources zijn gemaakt en uw toepassing in één stap is geïmplementeerd, kunt u verdergaan met de volgende stap.

Toepassingen kunnen worden geïmplementeerd in Azure door een ZIP-bestand van de toepassingscode te maken en te uploaden naar Azure. ZIP-bestanden kunnen worden geüpload naar Azure met behulp van de Azure CLI of een HTTP-client zoals cURL.

Automatisering van build inschakelen

Wanneer u een ZIP-bestand van uw Python-code implementeert, moet u een vlag instellen om Azure-buildautomatisering in te schakelen. De buildautomatisering installeert alle vereiste vereisten en verpakt de toepassing die moet worden uitgevoerd in Azure.

Bouwautomatisering in Azure wordt ingeschakeld door de app-instelling SCM_DO_BUILD_DURING_DEPLOYMENT in azure portal of Azure CLI in te stellen.

• Azure-portal
• Azure-CLI

Instructies	Schermafbeelding
Op de pagina voor de web-app in Azure Portal: Selecteer Configuratie onder de kop Instellingen in de linkerwerkbalk om de toepassingsinstellingen weer te geven. Selecteer onder Toepassingsinstellingen de optie Nieuwe toepassingsinstelling.
Voer in het dialoogvenster een nieuwe instelling in met: Naam → SCM_DO_BUILD_DURING_DEPLOYMENT Waarde → waar
Selecteer opslaan om uw instellingen op te slaan.

Een ZIP-bestand van uw toepassing maken

Maak vervolgens een ZIP-bestand van uw toepassing. U hoeft alleen onderdelen van de toepassing zelf op te nemen. U hoeft geen bestanden of mappen op te nemen die beginnen met een punt (.) zoals .venv, .gitignore, .githubof .vscode.

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

Het ZIP-bestand uploaden naar Azure

Zodra u een ZIP-bestand hebt, kan het bestand worden geüpload naar Azure met behulp van Azure CLI of een HTTP-client zoals 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> \
    <URL>

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    <URL>

App Service detecteert automatisch de aanwezigheid van een Flask-app. Er is geen extra configuratie nodig voor deze quickstart.

App Service detecteert automatisch de aanwezigheid van een Django-app. Er is geen extra configuratie nodig voor deze quickstart.

Als je Python 3.14 of later gebruikt, detecteert en draait App Service automatisch je FastAPI-app. Voor deze quickstart is geen extra configuratie nodig.

Als je Python 3.13 of eerder gebruikt, moet je een aangepast opstartcommando instellen zodat App Service je app kan uitvoeren. Het volgende commando start Gunicorn met twee Uvicorn-werkprocessen: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Configureer eerst de opstartopdracht met behulp van de opdracht 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

Start vervolgens de web-app opnieuw met behulp van de opdracht az webapp restart .

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

App Service detecteert automatisch de aanwezigheid van een Flask-app. Er is geen extra configuratie nodig voor deze quickstart.

App Service detecteert automatisch de aanwezigheid van een Django-app. Er is geen extra configuratie nodig voor deze quickstart.

Als je Python 3.13 of eerder gebruikt, gebruik dan Azure CLI of het Azure-portaal om het opstartcommando te configureren.

App Service detecteert automatisch de aanwezigheid van een Flask-app. Er is geen extra configuratie nodig voor deze quickstart.

App Service detecteert automatisch de aanwezigheid van een Django-app. Er is geen extra configuratie nodig voor deze quickstart.

Als je Python 3.14 of later gebruikt, detecteert en draait App Service automatisch je FastAPI-app. Je hebt geen extra configuratie nodig voor deze quickstart.

Als je Python 3.13 of eerder gebruikt, moet je een aangepast opstartcommando instellen zodat App Service je app kan uitvoeren. Het volgende commando start Gunicorn met twee Uvicorn-werkprocessen: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Instructies	Schermafbeelding
Als je Python 3.13 of eerder gebruikt, configureer dan het opstartcommando in Azure App Service. Ga naar de App Service-instantie in het Azure-portaal. Selecteer Configuratie onder de kop Instellingen in het menu aan de linkerkant van de pagina. Zorg ervoor dat het tabblad Algemene instellingen is geselecteerd. Voer in het veld Opstartopdracht gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0.0:8000 main:app in. Selecteer Opslaan om uw wijzigingen op te slaan. Wacht totdat de instellingen zijn bijgewerkt voordat u doorgaat. Als je Python 3.14 of later gebruikt, is geen opstartcommando nodig.
Start vervolgens de web-app opnieuw. Selecteer Overzicht in het menu aan de linkerkant van de pagina. Selecteer Opnieuw opstarten in het bovenste menu.

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

Eerst moet u Azure-app Service configureren om logboeken naar het App Service-bestandssysteem uit te voeren met behulp van de opdracht 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

Gebruik de opdracht az webapp log tail om logboeken te streamen.

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

Vernieuw de startpagina in de app of probeer andere aanvragen om bepaalde logboekberichten te genereren. Het resultaat dient er ongeveer als volgt uit te zien.

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"

Verwijder de resourcegroep met behulp van de opdracht az group delete .

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

Met argument --no-wait kan de opdracht worden geretourneerd voordat de bewerking wordt voltooid.

Volg deze stappen tijdens het aanmelden bij Azure Portal om een resourcegroep te verwijderen.

Instructies	Schermafbeelding
Navigeer naar de resourcegroep in Azure Portal. Voer de naam van de resourcegroep in de zoekbalk boven aan de pagina in. Selecteer onder de kop Resourcegroepen de naam van de resourcegroep om ernaar te navigeren.
Selecteer de Resourcegroep verwijderen knop bovenaan de pagina.
Voer in het bevestigingsvenster de naam van de resourcegroep in om het verwijderen te bevestigen. Selecteer Verwijderen om de resourcegroep te verwijderen.