Utilizar el servidor de desarrollo local

Puedes usar el servidor de desarrollo local para simular el funcionamiento de tu aplicación de App Engine en producción, así como para acceder a los servicios agrupados de App Engine.

El entorno simulado aplica algunas restricciones del espacio aislado, como funciones del sistema restringidas e importaciones de módulos de Go 1.11, pero no otras, como los tiempos de espera o las cuotas de las solicitudes.

El servidor de desarrollo local también simula los servicios proporcionados por las bibliotecas del SDK de App Engine, como Datastore, Memcache y Task Queues, realizando sus tareas de forma local. Cuando tu aplicación se ejecuta en el servidor de desarrollo, puedes seguir haciendo llamadas a APIs remotas a la infraestructura de producción mediante los endpoints HTTP de las APIs de Google.

Antes de empezar

Como Go 1.11 ha llegado al final de su ciclo de asistencia, ya no puedes usar la última versión de dev_appserver.py para ejecutar tus aplicaciones de forma local. Para descargar una versión archivada de devapp_server.py, sigue estos pasos:

  1. En el archivo, descarga la carpeta comprimida que contiene el servidor dev_appserver.py para los tiempos de ejecución que han llegado al final del periodo de asistencia.

  2. Extrae el contenido del directorio en tu sistema de archivos local, por ejemplo, en el directorio /home. Puedes encontrar dev_appserver.py en el directorio google_appengine/.

Configurar el servidor de desarrollo local

Para ejecutar la herramienta del servidor de desarrollo local, debe configurar lo siguiente:

  1. Verifica que has instalado un intérprete de Python 2 de la versión 2.7.12 o posterior.

  2. Define la variable de entorno DEVAPPSERVER_ROOT en tu shell con la ruta de tu intérprete de Python 2.

Ejecutar el servidor de desarrollo local

Después de configurar el servidor de desarrollo local y crear el archivo de configuración app.yaml de tu aplicación, puedes usar el comando dev_appserver.py para ejecutarla localmente.

Para iniciar el servidor de desarrollo local, sigue estos pasos:

  1. En el directorio que contiene el archivo de configuración app.yaml, ejecuta el comando dev_appserver.py.

    dev_appserver.py

    Especifica la ruta del directorio de tu aplicación. Por ejemplo:

    python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py PATH_TO_YOUR_APP
    

    También puedes especificar el archivo de configuración de un servicio concreto, por ejemplo:

    python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py app.yaml
    

    Para cambiar el puerto, incluye la opción --port:

    python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --port=9999 PATH_TO_YOUR_APP
    

    Sustituye DEVAPPSERVER_ROOT por la ruta a la carpeta en la que extraes la versión archivada de devapp_server.py.

    goapp serve

    El comando goapp serve se incluye en el SDK de App Engine para Go original y encapsula la herramienta de Python dev_appserver.py subyacente. Para iniciar el servidor de desarrollo local, ejecuta el siguiente comando:

      goapp serve
    

    Para obtener más información sobre las opciones del comando dev_appserver.py, consulta Opciones del servidor de desarrollo local.

  2. El servidor de desarrollo local ya está en funcionamiento y a la espera de solicitudes. Puedes visitar http://localhost:8080/ en tu navegador web para ver la aplicación en acción.

    Si has especificado un puerto personalizado con la opción --port, recuerda abrir tu navegador en ese puerto.

Para detener el servidor local desde la línea de comandos, pulsa lo siguiente:

  • macOS o Linux: Control+C
  • Windows: Control + Inter

Especificar IDs de aplicación

Para acceder a tu ID de aplicación en el servidor local (por ejemplo, para suplantar una dirección de correo electrónico), usa la función appengine.AppID. Para obtener el nombre de host de la aplicación en ejecución, usa la función appengine.DefaultVersionHostname.

Detectar el entorno de tiempo de ejecución de la aplicación

Para determinar si tu código se está ejecutando en producción o en el servidor de desarrollo local, puedes llamar al método IsDevAppServer(). Si el valor es true, el código se ejecuta en el entorno de desarrollo local. De lo contrario, se ejecuta en producción.


package devserver

import (
	"fmt"
	"net/http"

	"google.golang.org/appengine"
)

func init() {
	http.HandleFunc("/", handler)
}

func handler(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "IsDevAppServer: %v", appengine.IsDevAppServer())
}

Usar el Datastore local

El servidor de desarrollo local simula el almacén de datos de App Engine mediante un archivo local que se conserva entre las invocaciones del servidor local.

Para obtener más información sobre los índices y index.yaml, consulta las páginas Índices de Datastore y Configuración de índices de Datastore.

Consultar el almacén de datos local

Si tu aplicación ha escrito datos en tu Datastore local mediante el servidor de desarrollo local, puedes consultarlos en la consola de desarrollo local.

Para consultar el Datastore local, sigue estos pasos:

  1. Inicia el servidor de desarrollo.

  2. Accede a Datastore Viewer en la consola de desarrollo local. La URL es http://localhost:8000/datastore.

  3. Ver el contenido de tu almacén de datos local.

Especificar la política de asignación de IDs

En el caso de las aplicaciones de producción de App Engine, puedes configurar Datastore para que genere automáticamente los IDs de las entidades.

Aunque las políticas de asignación automática de IDs del servidor de producción son completamente diferentes de las que usa el servidor de desarrollo, también puedes definir la política de asignación automática de IDs del servidor local.

Para especificar la política de asignación automática de IDs, usa la opción --auto_id_policy:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --auto_id_policy=sequential

Sustituye:

  • DEVAPPSERVER_ROOT con la ruta a la carpeta donde quieras extraer la versión archivada de devapp_server.py.

  • --auto_id_policy con uno de los siguientes elementos:

    • scattered cuando (de forma predeterminada) los IDs se asignan a partir de una secuencia no repetida de números enteros distribuidos de forma aproximadamente uniforme.
    • sequential cuando los IDs se asignan a partir de la secuencia de números enteros consecutivos.

Borrar el almacén de datos local

Para borrar el almacén de datos local de una aplicación, invoca el servidor de desarrollo local de la siguiente manera:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --clear_datastore=yes app.yaml

Sustituye DEVAPPSERVER_ROOT por la ruta a la carpeta en la que extraes la versión archivada de devapp_server.py.

Cambiar la ubicación local de Datastore

Para cambiar la ubicación que se usa para el archivo del almacén de datos, usa la opción --datastore_path:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --datastore_path=/tmp/myapp_datastore app.yaml

Sustituye DEVAPPSERVER_ROOT por la ruta a la carpeta en la que extraes la versión archivada de devapp_server.py.

Usar el servicio Users

App Engine proporciona un servicio de usuarios para simplificar la autenticación y la autorización de tu aplicación. El servidor de desarrollo local simula el comportamiento de las cuentas de Google con sus propias páginas de inicio y cierre de sesión. Cuando se ejecuta en el servidor de desarrollo local, las funciones LoginURL y LogoutURL devuelven URLs de /_ah/login y /_ah/logout en el servidor local.

Usar Correo

El servidor de desarrollo local puede enviar correos en las llamadas al servicio de correo de App Engine mediante un servidor SMTP o una instalación local de Sendmail.

Usar SMTP

Para habilitar la compatibilidad con el correo mediante un servidor SMTP, invoca dev_appserver.py de la siguiente manera::

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --smtp_host=smtp.example.com --smtp_port=25 \
    --smtp_user=ajohnson --smtp_password=k1tt3ns [PATH_TO_YOUR_APP]

Sustituye:

  • [DEVAPPSERVER_ROOT] con la ruta a la carpeta donde quieras extraer la versión archivada de devapp_server.py.
  • --smtp_host, --smtp_port, --smtp_user y --smtp_password con tus propios valores de configuración.

Usar Sendmail

Para habilitar la asistencia de correo con Sendmail, invoca dev_appserver.py de la siguiente manera:

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --enable_sendmail=yes [PATH_TO_YOUR_APP]

Sustituye [DEVAPPSERVER_ROOT] por la ruta a la carpeta en la que has extraído la versión archivada de devapp_server.py.

El servidor local usará el comando sendmail para enviar mensajes de correo con la configuración predeterminada de tu instalación.

Usar la obtención de URLs

Cuando tu aplicación usa la API de obtención de URLs para hacer una solicitud HTTP, el servidor de desarrollo local hace la solicitud directamente desde tu ordenador. El comportamiento de la obtención de URLs en el servidor local puede ser diferente del de App Engine en producción si usas un servidor proxy para acceder a sitios web.