Accéder aux anciens services groupés pour Go 1.12+

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

Avant de commencer

• Consultez la liste des anciennes API de services groupés que vous pouvez appeler dans l'environnement d'exécution Go 1.12+.
• Avant de lancer un projet de migration vers Go 1.12+, consultez la présentation de la migration des environnements d'exécution et les considérations sur la migration lorsque vous utilisez des anciens services groupés.

Installer le SDK des services App Engine

Pour appeler les API des anciens services groupés avec Go 1.12+, 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 1.12 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
   

Remarque : Lorsque vous effectuez une mise à niveau vers une nouvelle version majeure d'une dépendance Go, telle qu'un package ou une bibliothèque, veillez à inclure le numéro de la version majeure de la dépendance dans les instructions d'importation. Si vous exécutez go mod tidy et constatez qu'il importe encore une ancienne version du SDK des services App Engine pour Go, vous avez probablement omis de mettre à niveau une instruction d'importation.

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 1.12+, et que votre application utilise des anciens services groupés :

• Pour tester la fonctionnalité des anciens services groupés dans votre application Go 1.12+, exécutez votre application dans votre environnement local avec les outils de développement que vous utilisez habituellement (par exemple go run).
• Pour déployer votre application, utilisez la commande gcloud app deploy.