Lokalen Entwicklungsserver verwenden

Sie können den lokalen Entwicklungsserver verwenden, um die Ausführung Ihrer App Engine-Anwendung in der Produktion zu simulieren und für den Zugriff auf gebündelte App Engine-Dienste zu nutzen.

Die simulierte Umgebung erzwingt gewisse Sandbox-Einschränkungen, wie beispielsweise eingeschränkte Systemfunktionen und Python 2-Modulimporte, sie erzwingt aber keine Kontingente oder Zeitüberschreitungen für Anfragen.

Der lokale Entwicklungsserver simuliert außerdem die von den Bibliotheken im SDK für App Engine bereitgestellten Dienste, einschließlich Datenspeicher, Memcache und Aufgabenwarteschlangen. Hierzu werden die Aufgaben der Dienste vom Server lokal ausführt. Wenn die Anwendung auf dem Entwicklungsserver ausgeführt wird, können Sie weiterhin Remote API-Aufrufe über HTTP-Endpunkte von Google APIs an die Produktionsinfrastruktur senden.

Hinweise

Da Python 2.7 das Ende der Unterstützung erreicht hat, können Sie Ihre Anwendungen nicht mehr mit der neuesten Version von dev_appserver.py lokal ausführen. So laden Sie eine archivierte Version von devapp_server.py herunter:

1. Laden Sie aus dem Archiv den komprimierten Ordner herunter, der den Server dev_appserver.py für Laufzeiten enthält, die das Ende des Supports erreicht haben.

2. Extrahieren Sie den Inhalt des Verzeichnisses in Ihr lokales Dateisystem, z. B. in Ihr /home-Verzeichnis. Sie finden dev_appserver.py im Verzeichnis google_appengine/.

Lokalen Entwicklungsserver einrichten

Für die Ausführung des lokalen Entwicklungsserver-Tools muss Folgendes eingerichtet sein:

1. Prüfen Sie, ob Sie einen Python 2-Interpreter der Version 2.7.12 oder höher installiert haben.

2. Legen Sie für die DEVAPPSERVER_ROOT-Umgebungsvariable in Ihrer Shell den Pfad des Python 2-Interpreters fest.

Lokalen Entwicklungsserver ausführen

Hinweis: Das dev_appserver-Tool unterstützt die Entwicklung von Python 3-Anwendungen unter Windows nicht.

Nachdem Sie den lokalen Entwicklungsserver eingerichtet und die Konfigurationsdatei app.yaml für die Anwendung erstellt haben, können Sie den dev_appserver.py-Befehl für Ihre Anwendung lokal ausführen.

So starten Sie den lokalen Entwicklungsserver:

1. Führen Sie in dem Verzeichnis, das Ihre app.yaml-Konfigurationsdatei enthält, den dev_appserver.py-Befehl aus.

   Geben Sie den Verzeichnispfad zur Anwendung an. Beispiel:

        python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py [PATH_TO_YOUR_APP]
   

   Alternativ können Sie die Konfigurationsdatei eines bestimmten Dienstes angeben. Beispiel:

        python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py app.yaml
   

   Fügen Sie die Option --port ein, um den Port zu ändern:

        python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --port=9999 [PATH_TO_YOUR_APP]
   

   Ersetzen Sie [DEVAPPSERVER_ROOT] durch den Pfad zu dem Ordner, in den Sie die archivierte Version von devapp_server.py extrahieren.

   Weitere Informationen zu dev_appserver.py-Befehlsoptionen finden Sie unter Lokale Entwicklungsserver-Optionen.

2. Der lokale Entwicklungsserver wird jetzt ausgeführt und ist für Anfragen bereit. Rufen Sie http://localhost:8080/ in Ihrem Webbrowser auf, um die Anwendung in Aktion zu sehen.

   Wenn Sie einen benutzerdefinierten Port mit der Option --port angegeben haben, müssen Sie den Port in Ihrem Browser öffnen.

Mit den folgenden Tastenkombinationen können Sie den lokalen Server über die Befehlszeile beenden:

• macOS oder Linux: Strg + C
• Windows: Strg + Pause

Anwendungs-IDs angeben

Zum Aufrufen der Anwendungs-ID auf dem lokalen Server, z. B. für das Spoofing einer E-Mail-Adresse, verwenden Sie die Funktion get_application_id(). Den Hostnamen der ausgeführten Anwendung können Sie mit der Funktion get_default_version_hostname() abrufen.

Laufzeitumgebung der Anwendung erkennen

Ermitteln Sie den Wert der Umgebungsvariable SERVER_SOFTWARE, um zu prüfen, ob der Code in einer Produktionsumgebung oder auf dem lokalen Entwicklungsserver ausgeführt wird:

if os.getenv('SERVER_SOFTWARE', '').startswith('Google App Engine/'):
  # Production
else:
  # Local development server

Lokalen Datenspeicher verwenden

Hinweis: Die lokale Entwicklungsumgebung wird migriert, um den Cloud Datastore-Emulator zu verwenden. Weitere Informationen zu dieser Änderung finden Sie in der Migrationsanleitung.

Der lokale Entwicklungsserver simuliert den App Engine Datastore mithilfe einer lokalen Datei, die zwischen Aufrufen des lokalen Servers bestehen bleibt.

Weitere Informationen zu Indexen und index.yaml finden Sie auf den Seiten Datenspeicherindexe und Konfiguration des Datenspeicherindex.

Lokalen Datenspeicher durchsuchen

Wenn die Anwendung mithilfe des lokalen Entwicklungsservers Daten in den lokalen Datenspeicher geschrieben hat, können Sie diese in der lokalen Entwicklungskonsole durchsuchen.

So durchsuchen Sie den lokalen Datenspeicher:

1. Starten Sie den Entwicklungsserver.

2. Rufen Sie in der lokalen Entwicklungskonsole den Datastore-Betrachter auf. Die URL lautet http://localhost:8000/datastore.

3. Sehen Sie sich die Inhalte des lokalen Datenspeichers an.

ID-Zuordnungsrichtlinie angeben

Für die App Engine-Produktionsumgebung können Sie im Datenspeicher festlegen, dass Entitäts-IDs automatisch generiert werden.

Die Richtlinien für die automatische Zuweisung von IDs für den Produktionsserver unterscheiden sich zwar grundlegend von den Richtlinien für den Entwicklungsserver, doch Sie können auch hier die Richtlinie zur automatischen ID-Zuordnung für den lokalen Server angeben.

Verwenden Sie die Option --auto_id_policy, um die Richtlinie für die automatische ID-Zuweisung anzugeben:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --auto_id_policy=sequential

Ersetzen Sie:

• DEVAPPSERVER_ROOT durch den Pfad zu dem Ordner, in den Sie die archivierte Version von devapp_server.py extrahieren.

• --auto_id_policy mit einem der folgenden:

  • scattered: (Standardeinstellung) IDs werden aus einer sich nicht wiederholenden Sequenz von annähernd einheitlich verteilten Ganzzahlen zugewiesen.
  • sequential: IDs werden aus der Sequenz von aufeinanderfolgenden Ganzzahlen zugewiesen.

Hinweis: Ihre Anwendung sollte keine Annahmen hinsichtlich der Abfolge von in der Produktion zugewiesenen automatischen IDs machen.

Lokalen Datenspeicher löschen

Wenn Sie den lokalen Datenspeicher für eine Anwendung löschen möchten, rufen Sie den lokalen Entwicklungsserver auf:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --clear_datastore=yes app.yaml

Ersetzen Sie DEVAPPSERVER_ROOT durch den Pfad zu dem Ordner, in den Sie die archivierte Version von devapp_server.py extrahieren.

Standort des lokalen Datenspeichers ändern

Zum Ändern des für die Datenspeicherdatei verwendeten Standorts verwenden Sie die Option --datastore_path:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --datastore_path=/tmp/myapp_datastore app.yaml

Ersetzen Sie DEVAPPSERVER_ROOT durch den Pfad zu dem Ordner, in den Sie die archivierte Version von devapp_server.py extrahieren.

Nutzerdienst verwenden

App Engine bietet einen Nutzerdienst, der die Authentifizierung und Autorisierung für Ihre Anwendung vereinfacht. Der lokale Entwicklungsserver simuliert das Verhalten von Google-Konten mit eigenen Anmelde- und Abmeldeseiten. Bei der Ausführung auf dem lokalen Entwicklungsserver geben die Funktionen users.create_login_url und users.create_logout_url URLs für /_ah/login und /_ah/logout auf dem lokalen Server zurück.

E-Mail-Dienst verwenden

Der lokale Entwicklungsserver kann einen SMTP-Server oder eine lokale Installation von Sendmail nutzen, um E-Mails für Aufrufe an den App Engine-E-Mail-Dienst zu senden.

SMTP verwenden

Zum Aktivieren der E-Mail-Unterstützung mit einem SMTP-Server rufen Sie dev_appserver.py so auf:

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --smtp_host=smtp.example.com --smtp_port=25 \
    --smtp_user=ajohnson --smtp_password=k1tt3ns [PATH_TO_YOUR_APP]

Ersetzen Sie:

• [DEVAPPSERVER_ROOT] durch den Pfad zu dem Ordner, in den Sie die archivierte Version von devapp_server.py extrahieren.
• Optionen --smtp_host, --smtp_port, --smtp_user und --smtp_password durch Ihre eigenen Konfigurationswerte.

Sendmail verwenden

Zum Aktivieren der E-Mail-Unterstützung mit Sendmail rufen Sie dev_appserver.py so auf:

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --enable_sendmail=yes [PATH_TO_YOUR_APP]

Ersetzen Sie [DEVAPPSERVER_ROOT] durch den Pfad zu dem Ordner, in den Sie die archivierte Version von devapp_server.py extrahieren.

Der lokale Server verwendet dann den Befehl sendmail, um E-Mail-Nachrichten mit der Standardkonfiguration Ihrer Installation zu versenden.

Hinweis: Wenn Sie dev_appserver.py nicht wie beschrieben mit SMTP oder Sendmail aufrufen, können mit der Anwendung keine E-Mails versendet werden. Der Versuch wird in der Anwendung dennoch als erfolgreich angezeigt.

URL-Abruf verwenden

Wenn die Anwendung die URL Fetch API zum Erstellen einer HTTP-Anfrage verwendet, führt der lokale Entwicklungsserver die Anfrage direkt von Ihrem Computer aus. Das Verhalten von URL Fetch auf dem lokalen Server kann sich vom Verhalten in der App Engine-Produktionsumgebung unterscheiden, wenn Sie einen Proxyserver für den Zugriff auf Websites verwenden.

Interaktive Konsole verwenden

Mit der interaktiven Konsole können Entwickler beliebigen Python-Code in ein Webformular eingeben und in ihrer Anwendungsumgebung ausführen. Sie bietet denselben Zugriff auf die Umgebung und die Dienste der Anwendung wie eine .py-Datei in der Anwendung selbst.

Wichtig: Wenn Sie das Argument --host beim Starten des lokalen Servers anstelle der Standardadresse angeben, wird die interaktive Konsole deaktiviert. Damit wird verhindert, dass eine Person beliebigen Python-Code per Remote-Zugriff auf Ihrem Computer ausführt. Sie können dies umgehen und die interaktive Konsole wieder aktivieren. Dazu starten Sie den Entwicklungsserver mit dem Argument --enable_console.

So verwenden Sie die interaktive Konsole:

1. Starten Sie den Entwicklungsserver.

2. Rufen Sie die interaktive Konsole in der lokalen Entwicklungskonsole auf. Die URL lautet http://localhost:8000/console.

3. Geben Sie beliebigen Python-Code ein, den Sie im Textbereich ausführen möchten, und senden Sie das Formular zur Ausführung. Der folgende Code fügt beispielsweise eine Datenspeicherentität namens Greeting mit dem Textinhalt von Hello hinzu:

     from google.appengine.ext import ndb
     class Greeting(ndb.Model):
       content = ndb.TextProperty()
   
     e = Greeting(content="Hello")
     e.put()
   

Fehlerbehebung mit dem Python-Debugging

So verwenden Sie Python-Debugging (pdb):

1. Fügen Sie Ihrem Code die folgende Zeile hinzu:

   import pdb; pdb.set_trace();
   

   dev_appserver wird an dieser Stelle unterbrochen und in die pdb-REPL (Read-Eval-Print-Loop) eingefügt, sodass Sie Ihren Code über die Befehlszeile debuggen können.

2. Wenn Ihre Anwendung mehrere Anfragen gleichzeitig ausführt, die pdb.set_trace() aufrufen, werden mehrere Debugging-Sitzungen gleichzeitig gestartet, die jeweils eine Ausgabe an STDOUT senden. Sie können dies durch Serialisieren der Anfragen vermeiden. Dazu deaktivieren Sie für den dev_appserver das Multi-Threading und Multi-Processing:

   1. Deaktivieren Sie das Multi-Threading mit folgenden Optionen:

      • Für alle Dienste mit dem Flag --threadsafe_override=false
      • Für einen einzigen Dienst mit dem Flag --threadsafe_override=<SERVICENAME>:false
      • Für mehrere Dienste mit dem Flag --threadsafe_override=<SERVICE1NAME>:false,<SERVICE2NAME>:false

   2. Deaktivieren Sie das Multi-Processing mit folgenden Optionen:

      • Für alle Dienste mit dem Flag --max_module_instances=1
      • Für einen einzigen Dienst mit dem Flag --max_module_instances=<SERVICENAME>:1
      • Für mehrere Dienste mit dem Flag --max_module_instances=<SERVICE1NAME>:1,<SERVICE2NAME>:1