Python 3.9 ist jetzt allgemein verfügbar.

Abhängigkeiten angeben

Abhängigkeiten deklarieren und verwalten

Abhängigkeiten für Python-Anwendungen werden in einer Standarddatei vom Typ requirements.txt deklariert. Beispiel:

Flask==0.10.1
google-cloud-storage

Wenn Sie in App Engine bereitstellen, werden die in der Datei requirements.txt angegebenen Abhängigkeiten automatisch mit der bereitgestellten Anwendung installiert. Sie können jedes Linux-kompatible Python-Paket verwenden, auch Pakete, die native C-Erweiterungen erfordern.

Standardmäßig werden abgerufene Abhängigkeiten von App Engine zwischengespeichert, um die Build-Zeiten zu reduzieren. Mit dem folgenden Befehl können Sie eine nicht im Cache gespeicherte Version der Abhängigkeit installieren:

gcloud beta app deploy --no-cache

Private Abhängigkeiten

Abhängigkeiten werden in einer Umgebung von Cloud Build installiert, die keinen Zugriff auf SSH-Schlüssel bietet. In Repositories gehostete Pakete, für die eine SSH-basierte Authentifizierung erforderlich ist, müssen in das Projektverzeichnis kopiert und zusammen mit dem Code Ihres Projekts hochgeladen werden. Hierzu wird der Paketmanager "pip" verwendet.

So verwenden Sie private Abhängigkeiten:

  1. pip install -t lib my_module ausführen, um Abhängigkeiten in einen lokalen Ordner mit dem Namen lib zu kopieren.

  2. Fügen Sie dem Verzeichnis lib eine leere __init__.py-Datei hinzu, um sie zu einem Modul zu machen.

  3. Importieren Sie das Modul in Ihre Anwendung. Beispiel:

    import lib.my_module
    

Abhängigkeiten lokal installieren

Wenn Sie eine Anwendung lokal entwickeln und testen, empfehlen wir dringend die Verwendung von venv. Sie können damit die Abhängigkeiten der Anwendung von den Systempaketen isolieren. Das gewährleistet auch, dass Ihre Abhängigkeiten auf Ihrem lokalen Computer und der bereitgestellten Anwendung dieselbe Version haben.

Mit den folgenden Schritten installieren Sie die Abhängigkeiten mit venv.

Mac OS/Linux

  1. Erstellen Sie eine isolierte Python-Umgebung:
    python3 -m venv env
    source env/bin/activate
  2. Wenn Sie sich nicht in dem Verzeichnis befinden, das den Beispielcode enthält, wechseln Sie zum Verzeichnis mit dem Beispielcode hello_world. Installieren Sie dann Abhängigkeiten:
    cd YOUR_SAMPLE_CODE_DIR
    pip install -r requirements.txt

Windows

Führen Sie Ihre Python-Pakete mit PowerShell aus.

  1. Wechseln Sie zu Ihrer Installation von PowerShell.
  2. Klicken Sie mit der rechten Maustaste auf die Verknüpfung zu PowerShell und starten Sie diese als Administrator.
  3. Erstellen Sie eine isolierte Python-Umgebung.
    python -m venv env
    .\env\Scripts\activate
  4. Gehen Sie zu Ihrem Projektverzeichnis und installieren Sie die Abhängigkeiten: Wenn Sie sich nicht in dem Verzeichnis befinden, das den Beispielcode enthält, wechseln Sie zum Verzeichnis mit dem Beispielcode hello_world. Installieren Sie dann Abhängigkeiten:
    cd YOUR_SAMPLE_CODE_DIR
    pip install -r requirements.txt

Dadurch wird sichergestellt, dass bei der lokalen Ausführung der Anwendung nur die in der Datei requirements.txt deklarierten Abhängigkeiten verfügbar sind. Die während der Bereitstellung von App Engine installierten Abhängigkeiten basieren auf dem Inhalt der Datei requirements.txt, nicht auf dem Inhalt des Verzeichnisses env/.

Web-Framework installieren

Sie müssen ein Web-Framework verwenden, damit Ihre Anwendung Webanfragen verarbeiten kann. Sie können ein beliebiges Python-Web-Framework verwenden, zum Beispiel:

Wenn Sie ein bestimmtes Web-Framework verwenden möchten, fügen Sie es einfach Ihrem requirements.txt hinzu:

Flask==0.10.1

WSGI-Server installieren

Einige Web-Frameworks haben integrierte WSGI-Server. Davon sind jedoch nur einige für den Produktions-Traffic geeignet. Die meisten Webanwendungen verwenden einen eigenständigen WSGI-Server wie Gunicorn, uWSGI oder Waitress. Weitere Informationen zur Installation, Konfiguration und Verwendung eines WSGI-Servers finden Sie unter Anwendungsstart.