Accedere ai servizi in bundle legacy per Go

Questa pagina descrive come installare e utilizzare i servizi in bundle con il runtime Go per l'ambiente standard di App Engine. La tua app può accedere ai servizi integrati tramite l'SDK per i servizi App Engine per Go.

Prima di iniziare

• Consulta l'elenco delle API dei servizi in bundle legacy che puoi chiamare nel runtime Go.
• Prima di avviare un progetto di migrazione a Go, consulta la panoramica della migrazione del runtime e le considerazioni sulla migrazione quando utilizzi i servizi in bundle precedenti.

Installazione dell'SDK per i servizi App Engine

Per chiamare le API dei servizi in bundle legacy con Go, devi utilizzare l'SDK più recente. Segui questi passaggi:

1. Aggiorna il file app.yaml in modo da includere la seguente riga:

   app_engine_apis: true
   

2. Aggiungi un riferimento all'SDK più recente nel file go.mod eseguendo go get nel terminale come segue:

   go get google.golang.org/appengine/v2
   

   La differenza principale durante l'upgrade a Go è l'utilizzo della versione 2 dell'SDK dei servizi App Engine.

3. Nell'app, modifica le istruzioni di importazione inserendo /v2/ nei vecchi nomi dei pacchetti. Ad esempio, se utilizzi Memcache, segui questi passaggi:

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

   Per l'elenco completo dei nomi dei pacchetti disponibili, consulta la documentazione dei riferimenti dell'API per i servizi in bundle legacy.

4. Esegui go mod tidy per ripulire i riferimenti nel file go.mod.

   go mod tidy
   

Nota: quando esegui l'upgrade a una nuova versione principale di una dipendenza Go, ad esempio un pacchetto o una libreria, assicurati di includere il numero della versione principale della dipendenza nelle tue dichiarazioni di importazione. Se esegui go mod tidy e scopri che viene ancora importata una versione precedente dell'SDK per i servizi App Engine per Go, probabilmente hai perso l'upgrade di un'istruzione di importazione.

Considerazioni sulla migrazione

Tieni presenti le seguenti considerazioni se esegui la migrazione al runtime Go e la tua app utilizza servizi in bundle precedenti:

• Per testare la funzionalità dei servizi legacy raggruppati nella tua app Go, esegui l'applicazione nel tuo ambiente locale con gli strumenti di sviluppo che utilizzi di solito, ad esempio go run.
• Per eseguire il deployment dell'app, utilizza il comando gcloud app deploy.