Auf dieser Seite wird beschrieben, wie Sie die gebündelten Dienste mit der Go-Laufzeit für die App Engine-Standardumgebung installieren und verwenden. Ihre Anwendung kann über das App Engine Services SDK für Go auf die gebündelten Dienste zugreifen.
Hinweise
- Weitere Informationen finden Sie in der Liste der gebündelten Legacy-Dienst-APIs, die Sie in der Go-Laufzeit aufrufen können.
- Lesen Sie vor dem Start eines Migrationsprojekts zu Go die Laufzeitmigrationsübersicht und die Überlegungen zur Migration bei der Verwendung gebündelter Legacy-Dienste.
App Engine Services SDK installieren
Um die APIs mit gebündelten Legacy-Diensten mit Go aufzurufen, müssen Sie das neueste SDK verwenden. Gehen Sie so vor:
Aktualisieren Sie die Datei
app.yaml
mit der folgenden Zeile:app_engine_apis: true
Fügen Sie einen Verweis auf das neueste SDK in Ihrem
go.mod
hinzu. Führen Sie dazugo get
im Terminal so aus:go get google.golang.org/appengine/v2
Der Hauptunterschied beim Upgrade auf Go ist die Verwendung von Version 2 des App Engine-Dienste-SDK.
Ändern Sie in der Anwendung die Importanweisungen durch Einfügen von
/v2/
in die alten Paketnamen. Wenn Sie beispielsweise Memcache verwenden, gehen Sie so vor:import ( "google.golang.org/appengine/v2" "google.golang.org/appengine/v2/memcache" )
Eine vollständige Liste der verfügbaren Paketnamen finden Sie in der API-Referenzdokumentation für gebündelte Legacy-Dienste.
Führen Sie
go mod tidy
aus, um Referenzen in der Dateigo.mod
zu bereinigen.go mod tidy
Hinweise zur Migration
Beachten Sie die folgenden Überlegungen, wenn Sie zur Go-Laufzeit migrieren und Ihre Anwendung gebündelte Legacy-Dienste verwendet:
- Wenn Sie die Funktionen eines gebündelten Legacy-Dienstes in Ihrer Go-Anwendung testen möchten, führen Sie Ihre Anwendung in Ihrer lokalen Umgebung aus. Verwenden Sie dabei die Entwicklungstools, die Sie sonst auch verwenden, z. B.
go run
. - Verwenden Sie zum Bereitstellen der Anwendung den Befehl
gcloud app deploy
.