Auf gebündelte Legacy-Dienste für Go zugreifen

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

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:

  1. Aktualisieren Sie die Datei app.yaml mit der folgenden Zeile:

    app_engine_apis: true
    
  2. Fügen Sie einen Verweis auf das neueste SDK in Ihrem go.mod hinzu. Führen Sie dazu go 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.

  3. Ä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.

  4. Führen Sie go mod tidy aus, um Referenzen in der Datei go.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: