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 dei servizi App Engine per Go.

Prima di iniziare

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 per specificare uno o più servizi in bundle legacy. Ad esempio:

    app_engine_bundled_services:
- datastore_v3
- memcache
- user

    Se utilizzi funzionalità come login: admin nella sezione handlers del file app.yaml, attiva l'API Users configurando l'impostazione user nell'elenco app_engine_bundled_services.

  2. Aggiungi un riferimento all'ultimo SDK 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 v2 dell'SDK dei servizi App Engine.

  3. Nella tua app, modifica le istruzioni di importazione inserendo /v2/ nei vecchi nomi dei pacchetti. Ad esempio, se utilizzi Memcache, procedi nel seguente modo:

    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 liberare spazio dai riferimenti nel file go.mod.

    go mod tidy

Considerazioni sulla migrazione

Se esegui la migrazione al runtime Go e la tua app utilizza servizi in bundle legacy, tieni presente le seguenti considerazioni: