Accedi 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 in bundle tramite l'SDK dei 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 in fase di runtime e le considerazioni sulla migrazione quando utilizzi i servizi in bundle legacy.

Installazione dell'SDK dei 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 quando esegui l'upgrade a Go è l'uso della versione 2 dell'SDK dei servizi App Engine.

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

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

   Per l'elenco completo dei nomi dei pacchetti disponibili, consulta la documentazione di riferimento delle API dei 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, come un pacchetto o una libreria, assicurati di includere il numero di versione principale della dipendenza nelle istruzioni di importazione. Se esegui go mod tidy e scopri che sta ancora importando una versione precedente dell'SDK dei servizi App Engine per Go, probabilmente non hai eseguito l'upgrade di un'istruzione di importazione.

Considerazioni sulla migrazione

Se esegui la migrazione al runtime Go e la tua app utilizza servizi in bundle legacy, devi tenere presente quanto segue:

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