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

Artikel
10/16/2024

Notitie

Vanaf 1 juni 2024 hebben alle nieuw gemaakte App Service-apps de mogelijkheid om een unieke standaardhostnaam te genereren met behulp van de naamconventie <app-name>-<random-hash>.<region>.azurewebsites.net. Bestaande app-namen blijven ongewijzigd.

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

Raadpleeg de unieke standaardhostnaam voor App Service-resource voor meer informatie.

In deze quickstart implementeert u een Python-web-app (Django, Flask of FastAPI) in Azure-app Service. Azure-app Service is een volledig beheerde webhostingservice die ondersteuning biedt voor Python-apps die worden gehost in een Linux-serveromgeving.

U hebt het volgende nodig om deze snelstartgids te voltooien:

Een Azure-account met een actief abonnement. Gratis een account maken
Python 3.9 of hoger lokaal geïnstalleerd.

Notitie

Dit artikel bevat de huidige instructies voor het implementeren van een Python-web-app met behulp van Azure-app Service. Python in Windows wordt niet meer ondersteund.

Voorbeeldtoepassing

Deze quickstart kan worden voltooid met flask, Django of FastAPI. In elk framework wordt een voorbeeldtoepassing geboden om u te helpen bij het volgen van deze quickstart. Download of kloon de voorbeeldtoepassing naar uw lokale werkstation.

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

De toepassing lokaal uitvoeren:

Ga naar de toepassingsmap:

cd msdocs-python-flask-webapp-quickstart

Maak een virtuele omgeving voor de app:

Windows
macOS/Linux

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

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

De afhankelijkheden installeren:
```
pip install -r requirements.txt
```
De app uitvoeren:
```
flask run
```
Blader naar de voorbeeldtoepassing in http://localhost:5000 een webbrowser.

Ondervindt u problemen? Laat het ons weten.

Ga naar de toepassingsmap:

cd msdocs-python-django-webapp-quickstart

Maak een virtuele omgeving voor de app:

Windows
macOS/Linux

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

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

De afhankelijkheden installeren:
```
pip install -r requirements.txt
```
De app uitvoeren:
```
python manage.py runserver
```
Blader naar de voorbeeldtoepassing in http://localhost:8000 een webbrowser.

Ondervindt u problemen? Laat het ons weten.

Ga naar de toepassingsmap:

cd msdocs-python-fastapi-webapp-quickstart

Maak een virtuele omgeving voor de app:

Windows
macOS/Linux

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

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

De afhankelijkheden installeren:
```
pip install -r requirements.txt
```
De app uitvoeren:
```
uvicorn main:app --reload
```
Blader naar de voorbeeldtoepassing in http://localhost:8000 een webbrowser.

Ondervindt u problemen? Laat het ons weten.

Een web-app maken in Azure

Als u uw toepassing in Azure wilt hosten, moet u een Azure-app Service-web-app maken in Azure. U kunt een web-app maken met behulp van het Azure CLI-, VS Code-, Azure Tools-extensiepakket of Azure Portal.

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

Azure CLI heeft een opdracht az webapp up waarmee de benodigde resources worden gemaakt en uw toepassing in één stap wordt geïmplementeerd.

Meld u zo nodig aan bij Azure met az login.

az login

Maak de web-app en andere resources en implementeer vervolgens uw code in Azure met behulp van az webapp up.

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

De --runtime parameter geeft aan welke versie van Python uw app wordt uitgevoerd. In dit voorbeeld wordt Python 3.9 gebruikt. Als u alle beschikbare runtimes wilt weergeven, gebruikt u de opdracht az webapp list-runtimes --os linux --output table.
De --sku parameter definieert de grootte (CPU, geheugen) en de kosten van het App Service-plan. In dit voorbeeld wordt gebruikgemaakt van het B1-serviceplan (Basic). Hiervoor worden kleine kosten in uw Azure-abonnement in rekening gebracht. Bekijk de pagina met App Service-prijzen voor een volledige lijst met App Service-abonnementen.
De --logs vlag configureert standaardlogboekregistratie die vereist is om het weergeven van de logboekstream direct na het starten van de web-app in te schakelen.
U kunt desgewenst een naam opgeven met het argument --name <app-name>. Als u er geen opgeeft, wordt er automatisch een naam gegenereerd.
U kunt eventueel het argument --location <location-name> toevoegen, waarbij <location_name> een beschikbare Azure-regio is. U kunt een lijst met toegestane regio's voor uw Azure-account ophalen door de az appservice list-locations-opdracht uit te voeren.

Het volledig uitvoeren van de opdracht kan even duren. Terwijl de opdracht wordt uitgevoerd, bevat deze berichten over het maken van de resourcegroep, het App Service-plan en de app-resource, het configureren van logboekregistratie en het uitvoeren van ZIP-implementatie. Vervolgens krijgt u het volgende bericht: 'U kunt de app starten op http://<app-name>.azurewebsites.net'. Dit is de URL van de app op 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>"
}

Notitie

Met de opdracht az webapp up worden de volgende acties uitgevoerd:

Er wordt een standaardresourcegroep gemaakt.
Maak een standaard App Service-plan.
Er wordt een app met de opgegeven naam gemaakt.
Zip implementeert alle bestanden uit de huidige werkmap, waarbij buildautomatisering is ingeschakeld.
Sla de parameters lokaal in het .azure/config-bestand op, zodat u ze niet opnieuw hoeft op te geven wanneer u ze later implementeert met az webapp up of andere az webapp opdrachten uit de projectmap. De waarden in de cache worden standaard automatisch gebruikt.

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.

Azure Tools-extensiepakket downloaden

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 in het formulier `https://<app-name>.azurewebsites.net`.
Selecteer de runtimestack voor de toepassing. In dit voorbeeld selecteert u Python 3.9.
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 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.
Selecteer + Maken op de pagina App Services en selecteer vervolgens + Web-app in de vervolgkeuzelijst.
Vul op de pagina Web-app maken het formulier als volgt in. Resourcegroep → Nieuwe maken selecteren en een naam van msdocs-python-webapp-quickstart gebruiken. Naam → msdocs-python-webapp-quickstart-XYZ waarbij XYZ uit drie willekeurige tekens bestaat. Deze naam moet uniek zijn binnen Azure. Runtimestack → Python 3.9. 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 Web-app maken de optie Beoordelen en maken onder aan het scherm. Hiermee gaat u naar de pagina Controleren. Selecteer Maken om uw App Service te maken.

Ondervindt u problemen? Laat het ons weten.

Uw toepassingscode implementeren in Azure

Azure-app Service ondersteunt meerdere methoden voor het implementeren van uw toepassingscode in Azure, waaronder GitHub Actions en alle belangrijke CI/CD-hulpprogramma's. Dit artikel is gericht op het implementeren van uw code van uw lokale werkstation naar Azure.

Omdat de az webapp up opdracht de benodigde resources heeft gemaakt en uw toepassing in één stap heeft geïmplementeerd, kunt u verdergaan met de volgende stap.

U kunt uw toepassingscode implementeren vanuit een lokale Git-opslagplaats naar Azure door een externe Git-opslagplaats te configureren in uw lokale opslagplaats die verwijst naar de opslagplaats waarnaar u code wilt pushen. De URL van de externe opslagplaats en Git-referenties die nodig zijn voor de configuratie, kunnen worden opgehaald met behulp van Azure Portal of de Azure CLI.

Azure-portal
Azure-CLI

Instructies	Schermafbeelding
Navigeer naar de App Service voor uw toepassing. Voer de naam van uw App Service in het zoekvak boven aan het scherm in. Selecteer onder de kop Resources de App Service om ernaar te navigeren.
Op de pagina voor de App Service: Selecteer Deployment Center in het menu aan de linkerkant van het scherm. Selecteer Lokale Git in de vervolgkeuzelijst met het label Bron. Selecteer Opslaan.
Nadat u de pagina hebt opgeslagen, wordt het adres voor de externe Git-opslagplaats vernieuwd en weergegeven. Kopieer de waarde van de Git Clone-URI , omdat deze waarde wordt gebruikt voor het instellen van een Externe Git in een latere stap.
Op de pagina Implementatiecentrum : Navigeer naar het tabblad Lokale Git/FTPS-referenties . Zoek de lokale git-gebruikersnaam en het wachtwoord onder de referenties van het toepassingsbereik . Houd dit scherm open zodat u deze referenties tijdelijk kunt kopiëren wanneer u uw code implementeert in de externe opslagplaats. Zorg ervoor dat u de lokale Git-gebruikersnaam kopieert, die begint met bijvoorbeeld een `$`.`$msdocs-python-webapp-quickstart-123` Wanneer u code voor het eerst naar de externe Git-opslagplaats pusht, zijn deze referenties nodig om te verifiëren bij de externe opslagplaats.

Configureer vervolgens in de hoofdmap van uw toepassing een externe Git die verwijst naar Azure met behulp van de Git-URL van de externe Azure die u in een vorige stap hebt verkregen.

git remote add azure <git-deployment-url>

U kunt nu code vanuit uw lokale Git-opslagplaats naar Azure pushen met behulp van de Externe Git die u zojuist hebt geconfigureerd. De standaardimplementatiebranch voor App Service is master, maar veel Git-opslagplaatsen gaan weg van master en gebruiken main. U kunt de toewijzing van de naam van de lokale vertakking opgeven naar de naam van de externe vertakking in de push (zoals hieronder wordt weergegeven) of u kunt de DEPLOYMENT_BRANCH app-instelling configureren.

git push azure main:master

De eerste keer dat u code naar Azure pusht, wordt u door Git gevraagd om de Azure-implementatiereferenties die u in de vorige stap hebt verkregen. Git slaat deze referenties vervolgens in de cache op, zodat u ze niet opnieuw hoeft in te voeren bij volgende implementaties.

Configureer eerst de implementatiebron voor uw web-app als lokale Git met behulp van de az webapp deployment source opdracht. Met deze opdracht wordt de URL uitgevoerd van de externe Git-opslagplaats waarnaar u code pusht. Maak een kopie van deze waarde, omdat u deze in een latere stap nodig hebt.

bash
PowerShell-terminal

# 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

Haal de implementatiereferenties voor uw toepassing op. Git heeft deze nodig voor verificatie bij Azure wanneer u in een latere stap code naar Azure pusht.

bash
PowerShell-terminal

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

Configureer vervolgens in de hoofdmap van uw toepassing een externe Git die verwijst naar Azure met behulp van de Git-URL van de externe Azure die u in een vorige stap hebt verkregen.

git remote add azure <git-deployment-url>

git push azure main:master

De eerste keer dat u code naar Azure pusht, wordt u door Git gevraagd om de Azure-implementatiereferenties die u in een vorige stap hebt verkregen. Git slaat deze referenties vervolgens in de cache op, zodat u ze niet opnieuw hoeft in te voeren bij volgende implementaties.

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.

Gebruik de opdracht az webapp config appsettings set om de SCM_DO_BUILD_DURING_DEPLOYMENT instelling in te stellen op een waarde van true.

bash
PowerShell-terminal

# 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

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.

Windows
macOS/Linux

Gebruik in Windows een programma zoals 7-Zip om een ZIP-bestand te maken dat nodig is om de toepassing te implementeren.

In macOS of Linux kunt u het ingebouwde hulpprogramma gebruiken om een ZIP-bestand zip te maken.

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.

Azure-CLI
cURL

De opdracht az webapp deploy kan worden gebruikt voor het uploaden en implementeren van een zip-bestand in Azure.

bash
PowerShell-terminal

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

Als u cURL wilt gebruiken om uw ZIP-bestand te uploaden naar Azure, hebt u de gebruikersnaam en het wachtwoord voor de implementatie voor uw App Service nodig. Deze referenties kunnen worden verkregen via Azure Portal.

Selecteer implementatiecentrum op de pagina voor de web-app in het menu aan de linkerkant van de pagina.
Selecteer het tabblad FTPS-referenties .
De gebruikersnaam en het wachtwoord worden weergegeven onder de kop Toepassingsbereik . Gebruik voor zip-bestandsimplementaties alleen het deel van de gebruikersnaam na het \ teken dat begint met bijvoorbeeld een $.$msdocs-python-webapp-quickstart-123 Deze referenties zijn nodig in de cURL-opdracht.

Voer de volgende curl opdracht uit om uw zip-bestand te uploaden naar Azure en uw toepassing te implementeren. De gebruikersnaam is de gebruikersnaam van de implementatie die is verkregen in stap 3. Wanneer deze opdracht wordt uitgevoerd, wordt u gevraagd om het implementatiewachtwoord.

bash
PowerShell-terminal

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

Zorg ervoor dat u voor PowerShell de gebruikersnaam tussen enkele aanhalingstekens plaatst, zodat PowerShell de gebruikersnaam niet probeert te interpreteren als een PowerShell-variabele.

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

Afhankelijk van uw netwerkbandbreedte duren bestanden meestal tussen de 10 en 30 seconden om te uploaden naar Azure.

Ondervindt u problemen? Raadpleeg eerst de gids voor probleemoplossing. Als dat niet helpt, laat het ons dan weten.

Opstartscript configureren

Op basis van de aanwezigheid van bepaalde bestanden in een implementatie detecteert App Service automatisch of een app een Django- of Flask-app is en voert standaardstappen uit om uw app uit te voeren. Voor apps die zijn gebaseerd op andere webframeworks zoals FastAPI, moet u een opstartscript configureren voor App Service om uw app uit te voeren; Anders voert App Service een standaard alleen-lezen app uit die zich in de map opt/defaultsite bevindt.

Zie Een Linux Python-app configureren voor Azure-app Service voor meer informatie over hoe Python-apps worden uitgevoerd en hoe u het gedrag ervan kunt configureren en aanpassen met uw app.

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

Voor FastAPI moet u een aangepaste opstartopdracht configureren voor App Service om uw app uit te voeren. De volgende opdracht start Gunicorn met 2 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

Instructies	Schermafbeelding
Configureer eerst de opstartopdracht in Azure-app Service. Navigeer naar de pagina voor het App Service-exemplaar in Azure Portal. 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.
Start vervolgens de web-app opnieuw. Selecteer Overzicht in het menu aan de linkerkant van de pagina. Selecteer Opnieuw opstarten in het bovenste menu.

Instructies

Schermafbeelding

Configureer eerst de opstartopdracht in Azure-app Service. Navigeer naar de pagina voor het App Service-exemplaar in Azure Portal.

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.

Een schermopname van de locatie in Azure Portal waar de opstartopdracht moet worden geconfigureerd.

Start vervolgens de web-app opnieuw.

Selecteer Overzicht in het menu aan de linkerkant van de pagina.
Selecteer Opnieuw opstarten in het bovenste menu.

Een schermopname van het opnieuw instellen van de web-app in Azure Portal.

Bladeren naar de app

Blader naar de geïmplementeerde toepassing in uw webbrowser met behulp van de URL http://<app-name>.azurewebsites.net. Als u een standaard-app-pagina ziet, wacht u een minuut en vernieuwt u de browser.

Met de Python-voorbeeldcode wordt een Linux-container uitgevoerd in App Service via een ingebouwde installatiekopie.

Schermopname van de app die wordt uitgevoerd in Azure

Gefeliciteerd U hebt uw Python-app geïmplementeerd in App Service.

Ondervindt u problemen? Raadpleeg eerst de gids voor probleemoplossing. Als dat niet helpt, laat het ons dan weten.

Logboeken streamen

Azure-app Service legt alle berichtuitvoer vast op de console om u te helpen bij het diagnosticeren van problemen met uw toepassing. De voorbeeld-apps bevatten print() instructies om deze mogelijkheid te demonstreren.

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

U kunt de inhoud van de diagnostische logboeken van App Service bekijken met behulp van de Azure CLI, VS Code of Azure Portal.

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.

bash
PowerShell-terminal

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.

bash
PowerShell-terminal

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. De uitvoer moet er ongeveer als volgt uitzien.

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"

Instructies	Schermafbeelding
Eerst moet u streaminglogboeken inschakelen in Azure-app Service. Klik in de sectie App Service van de Azure Tools for VS Code-extensie met de rechtermuisknop op uw App Service-exemplaar en selecteer Streaminglogboeken starten in het menu.
De consolelogboeken worden weergegeven in het vs code-uitvoervenster. Vernieuw de startpagina in de app of probeer andere aanvragen om bepaalde logboekberichten te genereren. U ziet logboekberichten die door uw app worden gegenereerd, evenals andere berichten die door de service in de uitvoer worden gegenereerd.

Instructies	Schermafbeelding
Eerst moet u streaminglogboeken inschakelen in Azure-app Service. Navigeer naar de pagina voor het App Service-exemplaar in Azure Portal. Selecteer App Service-logboeken onder de kop Bewaking in het menu aan de linkerkant van de pagina. Wijzig de eigenschap Toepassingslogboeken van Uit in Bestandssysteem. Voer een bewaarperiode van 30 dagen in voor de logboeken. Selecteer Opslaan om uw wijzigingen op te slaan.
Selecteer Logboekstream in de sectie Bewaking in het navigatiedeelvenster aan de linkerkant. Vernieuw de startpagina in de app of probeer andere aanvragen om bepaalde logboekberichten te genereren. In de uitvoer ziet u logboekberichten die zijn gegenereerd door uw app en berichten die door de service zijn gegenereerd.

Instructies

Schermafbeelding

Eerst moet u streaminglogboeken inschakelen in Azure-app Service. Navigeer naar de pagina voor het App Service-exemplaar in Azure Portal.

Selecteer App Service-logboeken onder de kop Bewaking in het menu aan de linkerkant van de pagina.
Wijzig de eigenschap Toepassingslogboeken van Uit in Bestandssysteem.
Voer een bewaarperiode van 30 dagen in voor de logboeken.
Selecteer Opslaan om uw wijzigingen op te slaan.

Een schermopname van de locatie in Azure Portal waar u streaminglogboeken inschakelt.

Selecteer Logboekstream in de sectie Bewaking in het navigatiedeelvenster aan de linkerkant. Vernieuw de startpagina in de app of probeer andere aanvragen om bepaalde logboekberichten te genereren.

In de uitvoer ziet u logboekberichten die zijn gegenereerd door uw app en berichten die door de service zijn gegenereerd.

Een schermopname van het weergeven van logboeken in Azure Portal.

Ondervindt u problemen? Raadpleeg eerst de gids voor probleemoplossing. Als dat niet helpt, laat het ons dan weten.

Resources opschonen

Wanneer u klaar bent met de voorbeeld-app, kunt u alle resources voor de app verwijderen uit Azure. Als u de resourcegroep verwijdert, worden er geen extra kosten in rekening gebracht en blijft uw Azure-abonnement overzichtelijk. Als u de resourcegroep verwijdert, worden ook alle resources in de resourcegroep verwijderd en is dit de snelste manier om alle Azure-resources voor uw app te verwijderen.

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.

Instructies	Schermafbeelding
In de Azure Tools-extensie voor VS Code: Zoek de sectie RESOURCES . Selecteer het pictogram Groeperen op en selecteer Groeperen op resourcegroep.
Zoek in de lijst met resources de resourcegroep die u wilt verwijderen, klik er met de rechtermuisknop op en selecteer Resourcegroep verwijderen.... U wordt gevraagd de verwijdering te bevestigen door de naam van de resourcegroep in het dialoogvenster in te voeren.

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 knop Resourcegroep verwijderen boven aan de pagina.
Voer in het bevestigingsvenster de naam van de resourcegroep in om het verwijderen te bevestigen. Selecteer Verwijderen om de resourcegroep te verwijderen.