Schnellstart: Bereitstellen einer Python-Web-App (Django, Flask oder FastAPI) in 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. Navigieren Sie zum Anwendungsordner:

   cd msdocs-python-flask-webapp-quickstart
   

2. Erstellen Sie eine virtuelle Umgebung für die App:

   • Windows
   • macOS/Linux

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

3. Installieren Sie die Abhängigkeiten:

   pip install -r requirements.txt
   

4. Führen Sie die App aus:

   flask run
   

5. Navigieren Sie in einem Webbrowser unter http://localhost:5000 zur Beispielanwendung.

   

Treten Probleme auf? Informieren Sie uns darüber.

1. Navigieren Sie zum Anwendungsordner:

   cd msdocs-python-django-webapp-quickstart
   

2. Erstellen Sie eine virtuelle Umgebung für die App:

   • Windows
   • macOS/Linux

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

3. Installieren Sie die Abhängigkeiten:

   pip install -r requirements.txt
   

4. Führen Sie die App aus:

   python manage.py runserver
   

5. Navigieren Sie in einem Webbrowser unter http://localhost:8000 zur Beispielanwendung.

   

Treten Probleme auf? Informieren Sie uns darüber.

1. Navigieren Sie zum Anwendungsordner:

   cd msdocs-python-fastapi-webapp-quickstart
   

2. Erstellen Sie eine virtuelle Umgebung für die App:

   • Windows
   • macOS/Linux

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

3. Installieren Sie die Abhängigkeiten:

   pip install -r requirements.txt
   

4. Führen Sie die App aus:

   uvicorn main:app --reload
   

5. Navigieren Sie in einem Webbrowser unter http://localhost:8000 zur Beispielanwendung.

   

Treten Probleme auf? Informieren Sie uns darüber.

Azure CLI-Befehle können auf einem Computer ausgeführt werden, auf dem die Azure CLI installiert ist.

Über die Azure CLI ist der Befehl az webapp up verfügbar, der die erforderlichen Ressourcen erstellt und Ihre Anwendung in einem einzigen Schritt bereitstellt.

Melden Sie sich erforderlichenfalls mithilfe von az login bei Azure an.

az login

Erstellen Sie die Web-App und andere Ressourcen, und stellen Sie dann Ihren Code mithilfe von az webapp up in Azure bereit.

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

• Der Parameter --runtime gibt an, welche Version von Python Ihre App ausführt. In diesem Beispiel wird Python 3.9 verwendet. Um alle verfügbaren Runtimes aufzulisten, verwenden Sie den Befehl az webapp list-runtimes --os linux --output table.
• Der Parameter --sku definiert die Größe (CPU, Arbeitsspeicher) und die Kosten für den App Service-Plan. In diesem Beispiel wird der Dienstplan „Basic (B1)“ verwendet, der in Ihrem Azure-Abonnement eine geringe Gebühr verursacht. Eine vollständige Liste der App Service-Pläne finden Sie auf der Seite App Service – Preise.
• Das Flag --logs konfiguriert die Standardprotokollierung, die erforderlich ist, um die Anzeige des Protokolldatenstroms unmittelbar nach dem Start der Web-App zu ermöglichen.
• Sie können optional einen Namen mit dem Argument --name <app-name> angeben. Wenn Sie keinen Namen angeben, wird automatisch ein Name generiert.
• Optional können Sie das Argument --location <location-name> einfügen, wobei <location_name> eine verfügbare Azure-Region ist. Sie können eine Liste der zulässigen Regionen für Ihr Azure-Konto abrufen, indem Sie den Befehl az appservice list-locations ausführen.

Die Ausführung dieses Befehls kann einige Minuten in Anspruch nehmen. Bei der Ausführung des Befehls werden Meldungen zum Erstellen der Ressourcengruppe, des App Service-Plans und der App-Ressource, zur Konfiguration der Protokollierung und zur ZIP-Bereitstellung angezeigt. Anschließend wird die Meldung „You can launch the app at http://<app-name>.azurewebsites.net“ (Sie können die App unter http://.azurewebsites.net starten.) angezeigt. Dabei handelt es sich um die URL der App in 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>"
}

Für die Erstellung von Azure-Ressourcen in VS Code müssen Sie das Paket mit der Azure-Tools-Erweiterung installiert haben und über VS Code bei Azure angemeldet sein.

Öffnen Sie im Anwendungsordner VS Code:

code .

Anweisungen	Screenshot
Suchen Sie auf der linken Symbolleiste nach dem Azure-Symbol. Wählen Sie diese Option aus, um die Erweiterung „Azure-Tools für VS Code“ anzuzeigen. Wenn das Symbol für die Azure-Tools nicht angezeigt wird, stellen Sie sicher, dass die Erweiterung „Azure-Tools für VS Code“ installiert ist.
In der Erweiterung „Azure-Tools für VS Code“: Wählen Sie im Abschnitt RESSOURCEN Ihr Abonnement aus. Wählen Sie + (Ressource erstellen...) aus.
Wählen Sie die Option Create App Service Web App... (App Service-Web-App erstellen) aus.
Geben Sie den Namen msdocs-python-webapp-quickstart-XYZ für diese Web-App ein, wobei XYZ drei beliebige eindeutige Zeichen sind. Bei der Bereitstellung wird dieser Name als App-Name im Formular https://<app-name>.azurewebsites.netverwendet.
Wählen Sie den Runtimestapel für die Anwendung aus. Wählen Sie in diesem Beispiel Python 3.9 aus.
Wählen Sie den App Service-Plan (Tarif) für diese Web-App aus. Der App Service-Plan steuert, wie viele Ressourcen (CPU/Arbeitsspeicher) Ihrer App zur Verfügung stehen und wie hoch die Kosten sind. Wählen Sie für dieses Beispiel den Tarif Basic (B1) aus. Dieser Plan belastet Ihr Azure-Abonnement mit einer geringen Gebühr, wird aber wegen der besseren Leistung gegenüber dem Plan „Free (F1)“ empfohlen.
Wählen Sie in der Benachrichtigung „Neue Web-App erstellt“ die Schaltfläche Bereitstellen aus.
Wählen Sie den Schnellstartordner, in dem Sie arbeiten, als Ordner für die Bereitstellung aus.
Antworten Sie mit Ja, um Ihre Buildkonfiguration zu aktualisieren und die Bereitstellungsleistung zu verbessern.
Nach Abschluss der Bereitstellung wird in der rechten unteren Ecke von VS Code eine entsprechende Benachrichtigung angezeigt. Über diese Benachrichtigung können Sie zu Ihrer Web-App navigieren.

Melden Sie sich beim Azure-Portal an, und führen Sie die folgenden Schritte aus, um Ihre Azure App Service-Ressourcen zu erstellen.

Anweisungen	Screenshot
Im Azure-Portal: Geben Sie auf der Suchleiste oben im Azure-Portal App Services ein. Wählen Sie im Menü, das unter der Suchleiste angezeigt wird, unter der Überschrift Dienste das Element mit der Bezeichnung App Services aus.
Wählen Sie auf der Seite App Services die Option + Erstellen und dann im Dropdownmenü + Web-App aus.
Füllen Sie auf der Seite Web-App erstellen das Formular wie folgt aus. Ressourcengruppe: Wählen Sie Neu erstellen aus, und verwenden Sie den Namen msdocs-python-webapp-quickstart. Name:msdocs-python-webapp-quickstart-XYZ, wobei XYZ drei zufällige Zeichen sind. Dieser Name muss innerhalb von Azure eindeutig sein. Runtimestapel:Python 3.9. Region: Eine beliebige Azure-Region in Ihrer Nähe. App Service-Plan → Wählen Sie unter Tarif die Option Tarife erkunden aus, um einen anderen App Service-Plan auszuwählen.
Der App Service-Plan steuert die Menge der Ressourcen (CPU/Arbeitsspeicher), die Ihrer App zur Verfügung stehen, sowie die Kosten für diese Ressourcen. Wählen Sie in diesem Beispiel unter Dev/Test den Plan Basic B1 aus. Der Plan „Basic B1“ belastet Ihr Azure-Konto mit einer geringen Gebühr, wird aber wegen der besseren Leistung gegenüber dem Plan „Free F1“ (Kostenlos) empfohlen. Wenn Sie fertig sind, wählen Sie Auswählen aus, um Ihre Änderungen anzuwenden.
Wählen Sie auf der Hauptseite Web-App erstellen die Option Überprüfen und erstellen am unteren Rand des Bildschirms aus. Dadurch gelangen Sie zur Seite „Überprüfung“. Wählen Sie Erstellen aus, um Ihre App Service-Instanz zu erstellen.

Da der Befehl az webapp up die erforderlichen Ressourcen erstellt und Ihre Anwendung in einem einzigen Schritt bereitgestellt hat, können Sie mit dem nächsten Schritt fortfahren.

Da im vorherigen Schritt die erforderlichen Ressourcen erstellt und Ihre Anwendung in einem einzigen Schritt bereitgestellt wurden, können Sie mit dem nächsten Schritt fortfahren.

Anwendungen können in Azure bereitgestellt werden, indem eine ZIP-Datei mit dem Anwendungscode erstellt und in Azure hochgeladen wird. ZIP-Dateien können mit der Azure-Befehlszeilenschnittstelle oder einem HTTP-Client wie cURL in Azure hochgeladen werden.

Aktivieren der Buildautomatisierung

Wenn Sie eine ZIP-Datei Ihres Python-Codes bereitstellen, müssen Sie ein Flag festlegen, um die Azure-Buildautomatisierung zu aktivieren. Die Buildautomatisierung installiert alle erforderlichen Anforderungen und Pakete, die für die Ausführung der Anwendung in Azure benötigt werden.

Sie aktivieren die Buildautomatisierung in Azure, indem Sie die App-Einstellung SCM_DO_BUILD_DURING_DEPLOYMENT entweder im Azure-Portal oder mithilfe der Azure-Befehlszeilenschnittstelle festlegen.

• Azure portal
• Azure-Befehlszeilenschnittstelle

Anweisungen	Screenshot
Auf der Seite für die Web-App im Azure-Portal: Wählen Sie auf der linken Symbolleiste unter der Überschrift Einstellungen die Option Konfiguration aus, um die Anwendungseinstellungen anzuzeigen. Wählen Sie unter Anwendungseinstellungen die Option Neue Anwendungseinstellung aus.
Geben Sie im Dialogfeld wie folgt eine neue Einstellung ein: Name → SCM_DO_BUILD_DURING_DEPLOYMENT Wert → true
Wählen Sie Speichern aus, um Ihre Einstellungen zu speichern.

Erstellen einer ZIP-Datei Ihrer Anwendung

Erstellen Sie als Nächstes eine ZIP-Datei Ihrer Anwendung. Sie müssen nur die Komponenten der Anwendung selbst einschließen. Sie müssen keine Dateien oder Verzeichnisse einschließen, die mit einem Punkt (.) beginnen, z. B. .venv, .gitignore, .github oder .vscode.

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

Hochladen der ZIP-Datei in Azure

Nachdem Sie eine ZIP-Datei erstellt haben, können Sie die Datei entweder mithilfe der Azure-Befehlszeilenschnittstelle oder eines HTTP-Clients wie cURL in Azure hochladen.

# 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 erkennt automatisch, wenn eine Flask-App vorhanden ist. Für diesen Schnellstart ist keine zusätzliche Konfiguration erforderlich.

App Service erkennt automatisch, wenn eine Django-App vorhanden ist. Für diesen Schnellstart ist keine zusätzliche Konfiguration erforderlich.

Für FastAPI müssen Sie einen benutzerdefinierten Startupbefehl für App Service konfigurieren, um Ihre App auszuführen. Der folgende Befehl startet Gunicorn mit zwei Uvicorn-Workerprozessen: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Konfigurieren Sie zunächst den Startupbefehl mithilfe des Befehls 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

Starten Sie als Nächstes die Web-App neu, indem Sie den Befehl az webapp restart verwenden.

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

App Service erkennt automatisch, wenn eine Flask-App vorhanden ist. Für diesen Schnellstart ist keine zusätzliche Konfiguration erforderlich.

App Service erkennt automatisch, wenn eine Django-App vorhanden ist. Für diesen Schnellstart ist keine zusätzliche Konfiguration erforderlich.

Verwenden Sie die Azure CLI oder das Azure-Portal, um den Startupbefehl zu konfigurieren.

App Service erkennt automatisch, wenn eine Flask-App vorhanden ist. Für diesen Schnellstart ist keine zusätzliche Konfiguration erforderlich.

App Service erkennt automatisch, wenn eine Django-App vorhanden ist. Für diesen Schnellstart ist keine zusätzliche Konfiguration erforderlich.

Für FastAPI müssen Sie einen benutzerdefinierten Startupbefehl für App Service konfigurieren, um Ihre App auszuführen. Der folgende Befehl startet Gunicorn mit zwei Uvicorn-Workerprozessen: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Anweisungen	Screenshot
Konfigurieren Sie zunächst den Startupbefehl in Azure App Service. Navigieren Sie zur Seite für die App Service-Instanz im Azure-Portal. Wählen Sie Konfigurations unter der Überschrift Einstellungen im Menü links auf der Seite aus. Stellen Sie sicher, dass die Registerkarte Allgemeine Einstellungen ausgewählt ist. Geben Sie im Feld Startupbefehl gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app ein. Wählen Sie Speichern aus, um Ihre Änderungen zu speichern. Warten Sie, bis die Benachrichtigung angezeigt wird, dass die Einstellungen aktualisiert werden, bevor Sie fortfahren.
Starten Sie die Web-App als Nächstes neu. Wählen Sie Übersicht im Menü links auf der Seite aus. Wählen Sie im oberen Menü Neu starten aus.

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

Als Erstes müssen Sie mithilfe des Befehls az webapp log config Azure App Service so konfigurieren, dass Protokolle an das App Service-Dateisystem ausgegeben werden.

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

Verwenden Sie zum Streamen von Protokollen den Befehl 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

Aktualisieren Sie die Homepage in der App, oder versuchen Sie mit anderen Anforderungen, einige Protokollmeldungen zu generieren. Die Ausgabe sollte in etwa wie folgt aussehen:

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"

Löschen Sie die Ressourcengruppe mit dem Befehl az group delete.

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

Mit dem Argument --no-wait kann für den Befehl die Rückgabe erfolgen, bevor der Vorgang abgeschlossen ist.

Führen Sie diese Schritte aus, während Sie beim Azure-Portal angemeldet sind, um eine Ressourcengruppe zu löschen.

Anweisungen	Screenshot
Navigieren Sie im Azure-Portal zur Ressourcengruppe. Geben Sie den Namen Ihrer Ressourcengruppe auf der Suchleiste oben auf der Seite ein. Wählen Sie unter der Überschrift Ressourcengruppen den Namen der Ressourcengruppe aus, um zu dieser zu navigieren.
Wählen Sie oben auf der Seite die Schaltfläche Ressourcengruppe löschen aus.
Geben Sie im Bestätigungsdialogfeld den Namen der Ressourcengruppe ein, um den Löschvorgang zu bestätigen. Wählen Sie Löschen aus, um die Ressourcengruppe zu löschen.