Auf dieser Seite wird beschrieben, wie Sie die gebündelten Dienste mit der Go 1.12+-Laufzeit für die App Engine-Standardumgebung installieren und verwenden. Ihre Anwendung kann über das App Engine Services SDK für Go 1.12+ auf die gebündelten Dienste zugreifen.
Hinweis
- Weitere Informationen finden Sie in der Liste der gebündelten Legacy-Dienst-APIs, die Sie in der Go 1.12-Laufzeit aufrufen können.
- Lesen Sie vor dem Start eines Migrationsprojekts zu Go 1.12+ oder höher 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 1.12 oder höher 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 1.12+ 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 1.12+-Laufzeit migrieren und Ihre Anwendung gebündelte Legacy-Dienste verwendet:
- Wenn Sie die Funktionen eines gebündelten Legacy-Dienstes in Ihrer Go 1.12+-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
.