Go 1.16 pasó a la fase de disponibilidad general.

Especifica dependencias

Las apps que se ejecutan en el entorno de ejecución estándar de Go 1.12 y versiones posteriores pueden usar cualquier paquete compatible con linux/amd64.

Usa módulos de Go

Recomendamos que uses los módulos de Go a fin de administrar dependencias en la app de Go, pero puedes seguir usando el modo GOPATH anterior si no estás listo para migrar a los módulos de Go.

Cuando implementas la app, App Engine usa el comando go build para compilarla y, por lo tanto, coincide con el comportamiento de Go. Para asegurarte de que la app use el modo compatible con el módulo, haz lo siguiente en tu entorno de desarrollo:

  • Crea el archivo go.mod del módulo en el mismo directorio que el archivo app.yaml. App Engine busca en el directorio actual y, luego, en los directorios superiores de forma sucesiva hasta encontrar un archivo go.mod.

    Si App Engine no encuentra un archivo go.mod, sigue el modo GOPATH.

  • Si configuras la variable de entorno GO111MODULE, asegúrate de que el valor de la variable habilite el modo compatible con el módulo. Cuando implementas la app, App Engine comprueba que tu entorno tenga GO111MODULE y coincida con el comportamiento de Go. App Engine solo aplica la configuración de la variable GO111MODULE si incluiste un archivo go.mod para tu app.

  • En Go 1.12, no ubiques el directorio de tu app en o menos de $GOPATH/src. Si tu aplicación de Go 1.12 se encuentra en cualquier parte del árbol de directorios $GOPATH/src, App Engine sigue el modo GOPATH, incluso si definiste un archivo go.mod para la aplicación.

    En Go 1.13 y versiones posteriores, App Engine usa el modo compatible con módulos de forma predeterminada, a menos que GO111MODULE anule el valor predeterminado o que un archivo go.mod no exista en el directorio de la app.

Dependecias de vendoring

Mediante el vendoring, se copian los paquetes que usa tu app en el directorio de la aplicación en lugar de descargar módulos de sus fuentes durante el proceso de compilación. Go proporciona el comando go build para hacer el vendoring de los paquetes que necesita tu app en un directorio llamado vendor en el directorio raíz de tu app.

En Go 1.14, si el directorio raíz de tu app contiene un directorio llamado vendor, el comando go build (y, por lo tanto, el proceso de implementación de App Engine) usará los paquetes del directorio del proveedor en lugar de descargar módulos.

En Go 1.13 y versiones anteriores, el proveedor solo está disponible si configuras tu entorno para usar el modo GOPATH.

Usa dependencias privadas

App Engine no puede descargar tus dependencias privadas durante el proceso de compilación, por lo que debes incluirlas en el código de la aplicación en el momento de la implementación.

Deberás usar la directiva replace en tu archivo go.mod para declarar dependencias privadas. En el siguiente ejemplo, se supone que la app se encuentra en el directorio /myapp/:

  1. Cambia al directorio de tu app:

    cd /myapp
    
  2. Crea un directorio que contenga tus dependencias privadas:

    mkdir private
    

    Asegúrate de que la dependencia privada se encuentre en el directorio private. Un enfoque consiste en crear un symlink:

    mkdir private/private.example.com
    ln -s /path/to/private.example.com/foo private/private.example.com/foo
    
  3. Actualiza el archivo go.mod con el objetivo de usar la directiva replace a fin de usar el directorio private para tu dependencia:

    go mod edit -replace=private.example.com/foo=./private/private.example.com/foo
    

    El archivo go.mod debería verse de la siguiente manera:

    Archivo go.mod final

    module private.example.com/myapp
    
    require private.example.com/foo v1.2.3
    
    replace private.example.com/foo => ./private/private.example.com/foo
    

    Archivo go.mod original

    module private.example.com/myapp
    
    require private.example.com/foo v1.2.3
    
  4. No modifiques la forma en la que importas y usas tu paquete privado. La declaración import debería verse de la siguiente manera:

    import "private.example.com/foo"
    
  5. Mediante la implementación de la app, incluye tu dependencia privada:

    gcloud app deploy