Accéder aux anciens services groupés pour Go

Cette page explique comment installer et utiliser les services groupés avec l'environnement d'exécution Go pour l'environnement standard App Engine. Votre application peut accéder aux services groupés via le SDK des services App Engine pour Go.

Avant de commencer

Installer le SDK des services App Engine

Pour appeler les API des anciens services groupés avec Go, vous devez utiliser la dernière version du SDK. Procédez comme suit :

  1. Mettez à jour votre fichier app.yaml pour inclure la ligne suivante :

    app_engine_apis: true
    
  2. Ajoutez une référence à la dernière version du SDK dans votre fichier go.mod en exécutant go get dans le terminal comme suit :

    go get google.golang.org/appengine/v2
    

    La principale différence lors de la mise à niveau vers Go consiste à utiliser la version 2 du SDK des services App Engine.

  3. Dans votre application, modifiez vos instructions d'importation en insérant /v2/ dans les anciens noms de packages. Par exemple, si vous utilisez Memcache, procédez comme suit :

    import (
      "google.golang.org/appengine/v2"
      "google.golang.org/appengine/v2/memcache"
    )
    

    Pour obtenir la liste complète des noms de packages disponibles, consultez la documentation de référence des API des anciens services groupés.

  4. Exécutez go mod tidy pour supprimer les références de votre fichier go.mod.

    go mod tidy
    

Considérations sur la migration

Vous devez prendre en compte les points suivants si vous effectuez une migration vers l'environnement d'exécution Go, et que votre application utilise des anciens services groupés :