Schnellstart: Bereitstellen einer Python-Web-App (Django oder Flask) 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

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.

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 bei Bedarf 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 account 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 Rubrik Dienste die Option 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, wie viele Ressourcen (CPU/Arbeitsspeicher) Ihrer App zur Verfügung stehen und wie hoch die Kosten für diese Ressourcen sind. 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 4. Navigieren zur App fortfahren.

Da der vorherige Schritt die erforderlichen Ressourcen erstellt und Ihre Anwendung in einem einzigen Schritt bereitgestellt hat, können Sie mit 4. Navigieren zur App fortfahren.

Sie können Ihren Anwendungscode aus einem lokalen Git-Repository in Azure bereitstellen, indem Sie ein Git-Remoterepository in Ihrem lokalen Repository konfigurieren, das auf Azure verweist und an das Code gepusht werden soll. Die URL des Remoterepositorys und die Git-Anmeldeinformationen, die für die Konfiguration erforderlich sind, können entweder über das Azure-Portal oder mit der Azure-Befehlszeilenschnittstelle abgerufen werden.

• Azure portal
• Azure-Befehlszeilenschnittstelle

Anweisungen	Screenshot
Navigieren Sie zu der App Service-Instanz für Ihre Anwendung. Geben Sie den Namen Ihrer App Service-Instanz in das Suchfeld oben auf dem Bildschirm ein. Wählen Sie unter der Überschrift Ressourcen die App Service-Instanz aus, um zu ihr zu navigieren.
Auf der Seite für die App Service-Instanz: Wählen Sie im Menü auf der linken Seite des Bildschirms Bereitstellungscenter aus. Wählen Sie in der Dropdownliste mit der Bezeichnung Quelle die Option Git (lokal) aus. Wählen Sie Speichern.
Nach dem Speichern wird die Seite aktualisiert und zeigt die Adresse für das Git-Remoterepository an. Kopieren Sie den Wert von Git-Klon-URI, da Sie diesen Wert in einem späteren Schritt zum Einrichten eines Git-Remoterepositorys verwenden.
Auf der Seite Bereitstellungscenter: Navigieren Sie zur Registerkarte Lokale Git-/FTPS-Anmeldeinformationen. Suchen Sie den Benutzernamen und das Kennwort des lokalen Gits unter den Anmeldeinformationen für den Anwendungsbereich. Lassen Sie diesen Bildschirm geöffnet, damit Sie diese Anmeldeinformationen vorübergehend kopieren können, wenn Sie Ihren Code im Remoterepository bereitstellen. Kopieren Sie unbedingt den Benutzernamen des lokalen Gits, der mit einem $ beginnt, z. B $msdocs-python-webapp-quickstart-123. Wenn Sie zum ersten Mal Code in das Git-Remoterepository pushen, werden diese Anmeldeinformationen für die Authentifizierung beim Remoterepository benötigt.

Konfigurieren Sie als Nächstes im Stammverzeichnis Ihrer Anwendung ein Git-Remoterepository, das auf Azure verweist, und verwenden Sie dabei die Git-URL des Azure-Remoterepositorys, die Sie in einem vorherigen Schritt abgerufen haben.

git remote add azure <git-deployment-url>

Sie können nun Code aus Ihrem lokalen Git-Repository mithilfe des soeben konfigurierten Git-Remoterepositorys an Azure pushen. Der Standardbereitstellungsbranch für App Service ist master, aber viele Git-Repositorys wechseln von master zu main. Sie können entweder die Zuordnung des lokalen Branchnamens zum Remotebranchnamen im Push angeben (wie unten dargestellt) oder Ihre DEPLOYMENT_BRANCH-App-Einstellung konfigurieren.

git push azure main:master

Wenn Sie zum ersten Mal Code an Azure pushen, werden Sie von Git zur Eingabe der Anmeldeinformationen für die Azure-Bereitstellung aufgefordert, die Sie in einem vorherigen Schritt abgerufen haben. Git speichert diese Anmeldeinformationen dann zwischen, sodass Sie sie bei nachfolgenden Bereitstellungen nicht erneut eingeben müssen.

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 Postman oder cURL in Azure hochladen.

• Azure-Befehlszeilenschnittstelle
• Postman
• cURL

Der Befehl az webapp deploy kann zum Hochladen und Bereitstellen einer ZIP-Datei in Azure verwendet werden.

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

app = Flask(__name__)


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

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:

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.