Accede a los servicios agrupados en paquetes heredados para Go 1.12+

En esta página, se describe cómo instalar y usar los servicios en paquetes con el entorno de ejecución de Go 1.12+ para el entorno estándar de App Engine. Tu app puede acceder a los servicios en paquetes a través del SDK de servicios de App Engine para Go 1.12+.

Antes de comenzar

• Consulta la lista de APIs de servicios agrupados en paquetes heredados que puedes llamar en el entorno de ejecución de Go 1.12+.
• Antes de comenzar un proyecto de migración a Go 1.12+, consulta la descripción general de la migración del entorno de ejecución y las consideraciones de migración cuando uses los servicios agrupados en paquetes heredados.

Instala el SDK de servicios de App Engine

Para llamar a las API de servicios agrupados en paquetes heredados con Go 1.12+, debes usar el SDK más reciente. Lleva a cabo los pasos siguientes:

1. Actualiza el archivo app.yaml para que incluya la siguiente línea:

   app_engine_apis: true
   

2. Para agregar una referencia al SDK más reciente en tu archivo go.mod, ejecuta go get en la terminal de la siguiente manera:

   go get google.golang.org/appengine/v2
   

   La diferencia principal cuando se actualiza a Go 1.12+ es usar la v2 del SDK de servicios de App Engine.

3. En la app, modifica las instrucciones de importación mediante la inserción de /v2/ en los nombres de paquetes anteriores. 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 referencias de la API de servicios agrupados en paquetes heredados.

4. Ejecuta go mod tidy para limpiar las referencias de tu archivo go.mod.

   go mod tidy
   

Nota: Cuando actualices a una nueva versión principal de una dependencia de Go, como un paquete o una biblioteca, asegúrate de incluir el número de la versión principal de la dependencia en tus instrucciones de importación. Si ejecutas go mod tidy y descubres que aún importa una versión anterior del SDK de servicios de App Engine para Go, es probable que hayas pasado por alto la actualización de una instrucción de importación.

Consideraciones sobre la migración

Debes tener en cuenta las siguientes consideraciones si migras al entorno de ejecución de Go 1.12+ y tu app usa los servicios agrupados en paquetes heredados:

• Para probar la funcionalidad de servicios agrupados en paquetes heredados en la app de Go 1.12+, ejecuta la aplicación en el entorno local con las herramientas de desarrollo que sueles usar, como go run.
• Para implementar la app, usa el comando gcloud app deploy.