Accedere ai servizi in bundle legacy per Go

In questa pagina viene descritto come installare e utilizzare 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 di API dei servizi in bundle legacy puoi chiamare nel runtime di Go.
• Prima di avviare un progetto di migrazione in Go, consulta le panoramica della migrazione di runtime e considerazioni sulla migrazione quando utilizzi servizi in bundle legacy.

Installazione dell'SDK dei servizi App Engine

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

1. Aggiorna il tuo app.yaml per 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/ nel precedente i 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 di riferimento per l'API dei servizi in bundle legacy.

4. Esegui go mod tidy per pulire 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 libreria, assicurati di includere il numero della versione principale della dipendenza le 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, potresti non aver eseguito l'upgrade di un'istruzione di importazione.

Considerazioni sulla migrazione

Se esegui la migrazione a un'istanza, tieni presente quanto segue il runtime Go e la tua app utilizza servizi in bundle legacy:

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