Python 2 ya no es compatible con la comunidad. Recomendamos que migres las apps de Python 2 a Python 3.

Configura Eclipse para el desarrollo y la depuración de Python 2 con Google App Engine

ID de región

REGION_ID es un código abreviado que Google asigna en función de la región que seleccionas cuando creas la app. El código no corresponde a un país ni a una provincia, aunque algunos ID de región puedan parecer similares a los códigos de país y provincia que se suelen usar. Incluir REGION_ID.r en las URL de App Engine es opcional en el caso de las apps existentes, y pronto será obligatorio para todas las apps nuevas.

A fin de garantizar una transición sin problemas, estamos actualizando App Engine de forma paulatina para usar los ID de región. Si aún no actualizamos tu proyecto de Google Cloud, no verás un ID de región para la app. Dado que el ID es opcional en las apps existentes, no es necesario que actualices las URL ni realices otros cambios una vez que el ID de región esté disponible en las apps existentes.

Obtén más información acerca de los ID de región.

Comienza con el desarrollo y la depuración locales mediante Eclipse y los complementos de PyDev. Esta configuración te permite ejecutar tu app de App Engine de forma local en modo de depuración y usar la perspectiva de depuración de Eclipse para establecer interrupciones y revisar el código línea a línea. Los complementos de PyDev ofrecen funciones auxiliares para trabajar con App Engine, que incluyen la creación de proyectos de inicio y la implementación de apps.

Antes de comenzar

  1. Instala Python 2.7, si aún no lo hiciste. ¿No estás seguro?
  2. Desde la sección Opcional de la página de descargas del SDK, instala el SDK original de App Engine para Python.

Verifica tu versión de Python

Para comprobar qué versión de Python instalaste, ejecuta el siguiente comando:

python --version

Instala Eclipse

En las siguientes instrucciones, se presupone que instalarás el IDE de Eclipse para JavaScript y desarrolladores web, que se basa en Eclipse Neon (4.6). Usa el instalador de Eclipse para facilitar el proceso.

  1. Instala el instalador de Eclipse.
  2. En el instalador de Eclipse, elige el paquete del IDE de Eclipse para JavaScript y desarrolladores web (Eclipse IDE for JavaScript and Web Developers) y haz clic en Instalar (Install).

    Instalación de Eclipse con el instalador de Eclipse. Captura de pantalla.

  3. Cuando finalice la instalación, haz clic en Launch.

  4. Cuando se inicie Eclipse, especifica una ubicación de lugar de trabajo o acepta la predeterminada.

Instala PyDev

Luego de instalar Eclipse, debes instalar el complemento de PyDev que te permite usar Eclipse como un IDE de Python.

  1. En Eclipse, haz clic en Help > Eclipse Marketplace.
  2. En el campo Buscar (Find), especifica “PyDev”.

    Busca PyDev en Eclipse Marketplace y, luego, instálalo. Captura de pantalla.

  3. Haz clic en Install y completa el asistente de instalación.

  4. Reinicia Eclipse cuando se te solicite.

Configura tu proyecto

  1. Para crear un proyecto nuevo, haz clic en File > New > Project.

  2. En la página Selecciona un asistente (Select a wizard), elige Proyecto de PyDev en Google App Engine (PyDev Google App Engine Project).

    Selecciona el asistente de proyecto Pydev. Captura de pantalla.

  3. En la página PyDev Project, elige un nombre para el proyecto. Luego, haz clic en Configurar un intérprete antes de continuar (Please configure an interpreter before proceeding) para que Eclipse configure el intérprete predeterminado.

    Si Eclipse no encontró un intérprete de Python 2.7, haz clic en el vínculo Haz clic aquí para configurar un intérprete que no está en la lista (Click here to configure an interpreter not listed) a fin de configurar el que corresponda.

  4. En la página de Google App Engine, haz clic en Explorar (Browse) y ubica el directorio en el que instalaste el SDK de App Engine. ¿Dónde está?

    Especifica la ubicación del SDK de App Engine al crear el proyecto. Captura de pantalla.

  5. Haz clic en Siguiente (Next) para continuar con la configuración de un proyecto básico o en Finalizar (Finish) para comenzar con un proyecto en blanco.

  6. Si configuras un proyecto, especifica su ID. Para ver el ID del proyecto, ve a Cloud Console. Si aún no registraste ningún proyecto, puedes especificar un nombre temporal que se insertará en el archivo app.yaml del proyecto. Puedes cambiarlo más adelante si es necesario.

  7. Elige una plantilla de inicio. Recomendación: Usa la plantilla Hello World para generar un archivo app.yaml y una secuencia de comandos de Python simple. Luego, puedes desarrollar con los marcos de trabajo que prefieras, como Flask o Django.

Ubicación predeterminada del SDK

macOS
Si instalaste el SDK con el iniciador de Google App Engine, se te solicitará que crees symlinks cuando comience el iniciador. Si creaste symlinks, esta es la ubicación predeterminada:
/usr/local/google_appengine
Si no creaste symlinks, esta es la ubicación predeterminada:
/Applications/GoogleAppEngineLauncher.app/Contents/Resources/GoogleAppEngine-default.bundle/Contents/Resources/google_appengine
Linux
La ubicación es el lugar en el que extrajiste el archivo ZIP del SDK que descargaste.
Windows
C:\Program Files (x86)\Google\google_appengine\

Importación de bibliotecas para que reconozca Eclipse

Después de configurar un proyecto, puedes elegir una biblioteca que utilice el código. Deberás importar la biblioteca en el proyecto y configurar el proyecto para que la cargue, pero también deberás darle instrucciones a Eclipse para que la use.

Para que Eclipse reconozca la biblioteca importada, haz lo siguiente:

  1. Importa la biblioteca al proyecto.
  2. Edita las propiedades del proyecto de Eclipse: haz clic derecho en el proyecto y selecciona Propiedades (Properties).
  3. Selecciona PyDev - PYTHONPATH en el panel de navegación del cuadro de diálogo.
  4. Si administras tus bibliotecas en una carpeta secundaria del proyecto, como “lib”, haz clic en Add source folder.

Ahora, Eclipse agrega las bibliotecas especificadas en la ruta de Python para llevar a cabo las importaciones.

Inicio de la app en modo de depuración

La ejecución de la app en modo de depuración en Eclipse te permite establecer interrupciones en el código. Cuando se ejecutan esas líneas, el procesamiento se detiene de manera temporal para que puedas inspeccionar el código y seguir la ejecución línea a línea. Esta función es muy útil durante el desarrollo de la app.

Establecimiento de una configuración de depuración

La primera vez que inicies la app en modo de depuración, se creará una configuración de depuración que podrás ejecutar más adelante o modificar a fin de agregar parámetros para tu compilación.

  1. Haz clic con el botón derecho en el nombre del proyecto en el explorador de proyectos y selecciona Debug As > PyDev: Google App Run.

    Debería abrirse la vista de la consola y mostrar la salida del sistema del servidor de desarrollo, que incluye las URL que ejecuta la app.

  2. Para verificar que la app se esté ejecutando, dirígete a la URL que se muestra en la consola. De manera predeterminada, la app se ejecuta desde http://localhost:8080. Si usaste la plantilla inicial de Hello World, deberías ver “Hello, world!” en el navegador.

Ahora el modo de depuración está en ejecución en Eclipse. También creaste una configuración de depuración que puedes ejecutar más adelante si sales de Eclipse, o bien si necesitas detener y reiniciar el depurador.

Establecimiento de una interrupción para revisar el código línea a línea

Ahora que el depurador está en ejecución, puedes establecer interrupciones y usarlas para revisar la ejecución del código línea a línea.

  1. Abre un archivo en el proyecto de Eclipse, como el archivo helloworld.py si usas la plantilla inicial.

  2. Haz clic derecho en el número de línea junto al código en el que deseas establecer una interrupción y selecciona Agregar interrupción (Add breakpoint).

    Menú contextual que se muestra al hacer clic derecho en el número de línea en Eclipse. Captura de pantalla.

    Aparece un círculo verde en la línea en la que estableciste la interrupción.

  3. Vuelve al navegador y abre la URL que ejecutará la línea en la que estableciste la interrupción. Eclipse te pedirá que cambies a la perspectiva de depuración cuando se active la interrupción.

  4. Si se te solicita que cambies a la perspectiva de depuración, haz clic en . Esta perspectiva proporciona una vista específica de depuración del código, incluida la vista de variables.

    Captura de pantalla completa del IDE de Eclipse en modo de depuración con las diferentes vistas de depuración.

    En el visualizador de variables, puedes inspeccionar las variables y los objetos que tienes definidos en el código.

    Los botones de la barra de menú proporcionan los siguientes controles:

    • Ícono de continuar la ejecución Continúa la ejecución hasta la siguiente interrupción o finaliza la ejecución.
    • Ícono de continuar la ejecución Revisa código de nivel inferior, como un método.
    • Ícono para revisar el código línea a línea Revisa el código actual línea a línea en lugar de ocuparte de código de nivel inferior.
    • Ícono para volver al código de nivel superior Vuelve al código de nivel superior. Si revisas código de nivel inferior, quizás quieras regresar al de nivel superior antes de que el código de nivel inferior finalice la ejecución para volver al código que lo llamó.
    • Ícono de detención del proceso Detén el proceso.
    • Ícono de omitir las interrupciones restantes Omite las interrupciones restantes.
  5. Haz clic en el ícono de continuar (Ícono de continuar) para seguir con el proceso y permitir que el servidor de desarrollo envíe una respuesta simple de “Hello, world!” al navegador.

Para volver a la perspectiva de PyDev luego de finalizar la depuración del código, selecciona Window > Perspective > Open Perspective y elige Pydev. O haz clic en el ícono de PyDev en la esquina superior derecha en Eclipse:

Se muestran los íconos para alternar con rapidez entre perspectivas en Eclipse

Implementa tu app desde Eclipse

El complemento de PyDev para Eclipse te permite implementar la app desde tu lugar de trabajo.

  1. Usa Google Cloud Console para configurar tu proyecto de Google Cloud:

    Selecciona o crea un proyecto de Cloud y asegúrate de que incluya una aplicación de App Engine:

    Ir a App Engine

    El Panel se abrirá si ya existe una aplicación de App Engine en tu proyecto. De lo contrario, se te solicitará que selecciones la región en la que quieres que se ubique tu aplicación de App Engine.

    Sugerencia: El ID del proyecto se vuelve parte de la URL de tu app, por ejemplo, https://PROJECT_ID.REGION_ID.r.appspot.com.

  2. En Eclipse, edita el archivo app.yaml y cambia el valor del elemento application por el ID de tu proyecto de Cloud.

  3. En la vista del explorador de paquetes (Package Explorer) o del explorador de proyectos (Project Explorer) de PyDev, haz clic derecho en la carpeta del proyecto y elige PyDev: Google App Engine > Upload.

    Imagen del menú contextual cuando se hace clic con el botón derecho en el proyecto a fin de mostrar la opción de carga de PyDev para App Engine

    Si esta es la primera vez que ejecutas los comandos de administración del SDK de App Engine, se te pedirá que autorices al SDK para otorgar acceso a la herramienta a fin de modificar las aplicaciones de App Engine. Haz clic en Permitir.

    Puedes cerrar la ventana del navegador cuando aparezca el mensaje de que se completó el flujo de autenticación (The authentication flow has completed) y volver a Eclipse.

  4. Confirma que la aplicación se subió correctamente en el cuadro de diálogo Administra Google App Engine (Manage Google App Engine):

    Captura de pantalla del cuadro de diálogo que confirma que los pasos de carga se completaron de forma correcta

  5. Navega hasta https://PROJECT_ID.REGION_ID.r.appspot.com y verás cómo la aplicación entrega tráfico.

Próximos pasos

Ahora que ya configuraste un entorno de desarrollo, aprende a desarrollar y a implementar apps en Cloud Console.