Hinweis: In den nächsten Monaten wird die App Engine-Dokumentationswebsite neu organisiert, um das Auffinden von Inhalten und die bessere Abstimmung mit den anderen Google Cloud-Produkten zu erleichtern. Es werden dieselben Inhalte verfügbar sein, aber die Navigation wird nun den restlichen Cloud-Produkten entsprechen.

Dienste von der Standardumgebung zur flexiblen Umgebung migrieren

Python |Java |Node.js |Go |Ruby |PHP |.NET

Die flexible App Engine-Umgebung bietet nicht die API-Bibliotheken des App Engine SDK. Wenn Sie Ihre Anwendung von der App Engine-Standardumgebung zur flexiblen Umgebung migrieren möchten, müssen Sie Ihren Code so aktualisieren, dass nur Dienste und APIs verwendet werden, die in allen Google Cloud-Umgebungen verfügbar sind.

In den folgenden Abschnitten finden Sie Anleitungen zur Migration bestimmter Dienste und APIs von der Standardumgebung zur flexiblen Umgebung.

Unterschiede zwischen Standardumgebung und flexibler Umgebung

Zusätzlich zu den hier dargestellten Hauptunterschieden werden Pfade mit /_ah/ in der flexiblen Umgebung nicht blockiert. Wenn Ihre Anwendung in der Standardumgebung für den Zugriff auf bestimmte Dienste Pfade mit /_ah/ verwendet, finden Sie Informationen im Abschnitt für den entsprechenden Dienst weiter unten.

Anwendungsidentität

In der flexiblen Umgebung können Sie mit einer Kombination aus Umgebungsvariablen und dem Compute Engine-Metadatendienst Informationen zur Anwendung abrufen:

Anwendungsdaten	Zugriff
Anwendungs-/Projekt-ID	Entweder die Umgebungsvariable `GOOGLE_CLOUD_PROJECT` oder die Ressource `/project/project-id` im Metadatenserver
Standardhostname	`apps.get`-Methode der App Engine Admin API
Name des Dienstkontos	Ressource `/instance/service-accounts` im Metadatenserver
OAuth 2.0-Zugriffstoken	Ressource `/instances/service-accounts` im Metadatenserver. Weitere Informationen finden Sie in der Compute Engine-Dokumentation zur Authentifizierung mit den Anmeldedaten des Dienstkontos.

Die folgende Funktionalität ist nicht direkt verfügbar:

Für Ihr Projekt ist kein Cloud Storage-Standard-Bucket vorhanden. Sie können einen Cloud Storage-Bucket erstellen und die Projekt-ID als Bucket-Namen verwenden, um einen Bucket in Ihrer Anwendung zu nutzen. Sie haben dann die Möglichkeit, die Umgebungsvariable GOOGLE_CLOUD_PROJECT in der Anwendung als Bucket-Namen einzusetzen.
Sie können Blobs nicht mit dem Standarddienstkonto signieren. Stattdessen können Sie die Identity and Access Management (IAM) API verwenden oder bei der Bereitstellung für die Anwendung einen privaten Schlüssel für das Dienstkonto zur Verfügung stellen.
Es ist auch keine integrierte API zum Abrufen öffentlicher Zertifikate für die Überprüfung von Signaturen vorhanden. Die öffentlichen Zertifikate aller Dienstkonten sind jedoch unter https://www.googleapis.com/robot/v1/metadata/x509/{service account email} verfügbar.

Hintergrundthreads

Da für die flexible Umgebung keine Sandbox-Beschränkungen gelten, können Sie Threads und Prozesse erstellen, die außerhalb der Anfrageumgebung ausgeführt werden. In der Regel benötigen Sie dazu nur die integrierten Threading- oder Multiprocessing-Tools Ihrer Sprache.

Blobstore

Die Nutzung des Blobstore-Dienstes wurde sowohl in der Standardumgebung als auch in der flexiblen Umgebung weitgehend durch Cloud Storage ersetzt. Verwenden Sie zum Speichern und Abrufen von Daten in Cloud Storage die Google Cloud-Clientbibliotheken.

Weitere Informationen erhalten Sie in dieser Anleitung:

Cloud Storage verwenden

Capabilities

Außerhalb der Standardumgebung ist keine dem Capabilities-Dienst vergleichbare Funktionalität verfügbar.

WebSockets

Die flexible App Engine-Umgebung unterstützt Websockets. Weitere Informationen finden Sie in folgenden Leitfäden:

Firestore im Datastore-Modus (Datastore)

Sie können von überall aus mit der Datastore API auf Datastore zugreifen. Verwenden Sie die Google Cloud-Clientbibliotheken zum Speichern und Abrufen von Daten aus dem Datenspeicher.

Dieselben Datastore-daten sind verfügbar, unabhängig davon, ob Sie die App Engine-Bibliotheken oder die Google Cloud-Clientbibliotheken verwenden oder die API direkt aufrufen.

Wenn Sie die Python-Bibliothek ndb verwenden und den NDB-ähnlichen Datastore-Zugriff bevorzugen, empfehlen wir, zu Cloud NDB zu migrieren. Weitere Informationen finden Sie im Cloud NDB-Repository.

Sowohl die Cloud NDB- als auch die Datastore-Clientbibliotheken werden von Python 2 und 3 unterstützt und funktionieren sowohl für die App Engine-Standardumgebung oder die flexible App Engine-Umgebung als auch für Nicht-App Engine-Anwendungen. So können sich Python 2-Entwickler von gebündelten Legacy-Diensten wie App Engine ndb lösen. Cloud NDB hat das zusätzliche Ziel, weiterhin die Nutzerfreundlichkeit von NDB zu gewährleisten.

Weitere Informationen erhalten Sie in dieser Anleitung:

Datastore verwenden

Bilder

Der Bildbearbeitungsdienst ist außerhalb der Standardumgebung nicht verfügbar. Sie können jedoch Bilder direkt aus Ihrer Anwendung oder direkt aus Cloud Storage bereitstellen.

Wenn Sie Bilder verarbeiten müssen, können Sie dazu eine Bildverarbeitungsbibliothek wie Pillow installieren und verwenden.

Der Bilderdienst bietet außerdem Funktionen zur Vermeidung dynamischer Anfragen an Ihre Anwendung. Dazu erfolgt die Änderung der Bildgröße über eine Bereitstellungs-URL. Sie können stattdessen auch die Bilder mit der neuen Größe im Voraus generieren und dann zur Bereitstellung in Cloud Storage hochladen. Alternativ haben Sie die Möglichkeit, die Bildgröße mit einem entsprechenden externen CDN-Dienst (Content Delivery Network) zu ändern.

Weitere Informationen finden Sie in diesen Leitfäden:

Logging

Wie in der Standardumgebung ist das Logging in der flexiblen Umgebung automatisch aktiviert. Allerdings erfolgt die Erfassung der Logs in einem unterschiedlichen Format. Sie werden nicht nach Anfragen gebündelt und Logs von stdout und stderr werden gesondert erfasst.

Wenn Sie mehr Kontrolle über das Anwendungs-Logging, die Möglichkeit zum Log-Gruppieren und die Möglichkeit haben möchten, zusätzliche Metadaten in Logs zu erfassen, können Sie die Cloud Logging API direkt mit den Google Cloud-Clientbibliotheken verwenden.

Weitere Informationen finden Sie in diesem Leitfaden:

Anwendungslogs schreiben

Mail

Der App Engine Mail-Dienst ist außerhalb der Standardumgebung nicht verfügbar. Zum Senden von E-Mails benötigen Sie einen externen E-Mail-Anbieter wie SendGrid, Mailgun oder Mailjet. Diese Dienste bieten APIs zum Senden von E-Mails aus Anwendungen, die in beliebigen Umgebungen ausgeführt werden.

Die folgenden Leitfäden zeigen, wie Sie die Dienste mit der flexiblen Umgebung nutzen:

Memcache

Der Memcache-Dienst ist in der flexiblen App Engine-Umgebung nicht verfügbar. Verwenden Sie Memorystore for Redis zum Speichern von Anwendungsdaten im Cache.

Module

Die Modules API ist außerhalb der Standardumgebung nicht verfügbar. Sie können aber mit Umgebungsvariablen und der App Engine Admin API Informationen zu den ausgeführten Diensten der Anwendung abrufen und ändern:

Dienstinformation	Zugriff
Aktueller Dienstname	Umgebungsvariable `GAE_SERVICE`
Aktuelle Dienstversion	Umgebungsvariable `GAE_VERSION`
Aktuelle Instanz-ID	Umgebungsvariable `GAE_INSTANCE`
Standardhostname	`apps.get`-Methode der App Engine Admin API
Liste der Dienste	`apps.services.list`-Methode der App Engine Admin API
Liste der Versionen für einen Dienst	`apps.services.versions.list`-Methode der App Engine Admin API
Standardversion für einen Dienst, inklusive Traffic-Aufteilung	`apps.services.get`-Methode der App Engine Admin API
Liste der für eine Version ausgeführten Instanzen	`apps.services.versions.instances.list`-Methode der App Engine Admin API

Mit der App Engine Admin API können Sie auch Dienste und Versionen in der Anwendung bereitstellen und verwalten.

Namespaces

Außerhalb der Standardumgebung wird die Mehrinstanzenfähigkeit nur von Datastore direkt unterstützt. Bei anderen Diensten müssen Sie die Mehrinstanzenfähigkeit manuell verwalten. Sie können mit der Cloud Resource Manager API programmatisch neue Projekte erstellen und projektübergreifend auf Ressourcen zugreifen, um Dienstinstanzen vollständig zu isolieren.

OAuth

Der OAuth-Dienst ist in der flexiblen Umgebung nicht verfügbar. Sie können OAuth 2.0-Tokens mit der oauth2.tokeninfo-Methode der OAuth 2.0 API verifizieren.

Remote

Der Remote API-Dienst ist in der flexiblen Umgebung nicht anwendbar. Die überwiegende Anzahl der Datensicherungsdienste wie Cloud Datastore, auf die aus der flexiblen Umgebung zugegriffen werden kann, sind von überall aus zugänglich.

Suche

Der Suchdienst ist aktuell außerhalb der flexiblen Umgebung nicht verfügbar. Sie können eine beliebige Datenbank mit Volltextsuche wie ElasticSearch in Compute Engine hosten und darauf sowohl von der Standard- als auch von der flexiblen Umgebung aus zugreifen.

Sockets

Für die flexible Umgebung gelten keine Sandbox-Beschränkungen. Sie können ausgehende Sockets ganz normal öffnen und verwenden.

Task Queue

Mit Tasks können Sie den Push-Dienst der Aufgabenwarteschlange außerhalb der Standardumgebung der ersten Generation verwenden.

In vielen Fällen, in denen Sie Pull-Warteschlangen verwenden können, z. B. für Aufgaben oder Nachrichten, die von unterschiedlichen Workern abgerufen und verarbeitet werden, ist Pub/Sub eine empfehlenswerte Alternative, die ähnliche Funktionen und Zustellgarantien bietet.

URL-Abruf

Der URL-Abrufdienst ist in der flexiblen Umgebung nicht verfügbar. Es gibt jedoch keine Sandbox-Einschränkungen. Daher kann Ihre Anwendung eine beliebige HTTP-Bibliothek zum Abrufen der URL-Abruffunktion verwenden. Die Verwendung von Anfragen wird empfohlen.

Users

Der Nutzerdienst ist außerhalb der Standardumgebung nicht verfügbar. Sie können in der flexiblen Umgebung aber jeden HTTP-basierten Authentifizierungsmechanismus verwenden. Beispiele:

Google Identity Platform bietet zahlreiche Optionen zur Authentifizierung und Autorisierung von Google-Nutzerkonten.
Firebase Authentication ermöglicht die Authentifizierung mithilfe von Nutzername/Passwort oder einer föderierten Identität über Google, Facebook, Twitter und andere.
Auth0 bietet die Authentifizierung mithilfe verschiedener Identitätsanbieter und Funktionen zur Einmalanmeldung (SSO).
OAuth 2.0 und OpenID Connect bieten die föderierte Identität vom Anbieter Ihrer Wahl. Google ist ein OpenID Connect-Identitätsanbieter. Außerdem ist eine Reihe weiterer Anbieter verfügbar.

Da der Nutzerdienst nicht zur Verfügung steht, kann mit app.yaml der Zugriff auf URLs nicht auf Administratoren beschränkt werden. Sie müssen dies über Ihre Anwendung festlegen.

Nächste Schritte

Eine Übersicht der wichtigsten Unterschiede zwischen der flexiblen Umgebung und der Standardumgebung mit Richtlinien für Anwendungen, die beide Umgebungen verwenden, finden Sie unter Flexible App Engine-Umgebung für Nutzer der App Engine-Standardumgebung.