En esta página se describe cómo instalar y usar los servicios incluidos con el runtime de Go para el entorno estándar de App Engine. Tu aplicación puede acceder a los servicios agrupados a través del SDK de servicios de App Engine para Go.
Antes de empezar
- Consulta la lista de APIs de servicios antiguos incluidos a las que puedes llamar en el tiempo de ejecución de Go.
- Antes de iniciar un proyecto de migración a Go, consulta la información general sobre la migración del tiempo de ejecución y las consideraciones sobre la migración al usar servicios agrupados antiguos.
Instalar el SDK de servicios de App Engine
Para llamar a las APIs de los servicios antiguos incluidos con Go, debes usar el SDK más reciente. Sigue estos pasos:
Actualiza el archivo
app.yaml
para incluir la siguiente línea:app_engine_apis: true
Añade una referencia al SDK más reciente en tu archivo
go.mod
ejecutandogo get
en la terminal de la siguiente manera:go get google.golang.org/appengine/v2
La principal diferencia al actualizar a Go es que se usa la versión 2 del SDK de servicios de App Engine.
En tu aplicación, modifica las instrucciones de importación insertando
/v2/
en los nombres de paquete antiguos. Por ejemplo, si usas Memcache, haz lo siguiente:import ( "google.golang.org/appengine/v2" "google.golang.org/appengine/v2/memcache" )
Para ver la lista completa de nombres de paquetes disponibles, consulta la documentación de referencia de la API de servicios empaquetados antiguos.
Ejecuta
go mod tidy
para limpiar las referencias del archivogo.mod
.go mod tidy
Consideraciones sobre la migración
Si vas a migrar al tiempo de ejecución de Go y tu aplicación usa servicios antiguos agrupados, debes tener en cuenta lo siguiente:
- Para probar la función de servicios agrupados antiguos en tu aplicación Go, ejecuta la aplicación en tu entorno local con las herramientas de desarrollo que suelas usar, como
go run
. - Para desplegar tu aplicación, usa el comando
gcloud app deploy
.