Cómo migrar a Cloud Code

En este documento, se describe cómo migrar tu proyecto de App Engine basado en IntelliJ a Cloud Code.

Antes de comenzar

  • Si tu proyecto está basado en Maven o Gradle y usa los complementos antiguos basados en el SDK de App Engine (p. ej., com.google.appengine.appengine-maven-plugin y com.google.appengine:gradle-appengine-plugin), primero deberías migrar al SDK de Cloud nuevo basado en los complementos de Maven y Gradle.

  • El complemento nuevo no admite mejoras de Datanucleus. Si dependes de esta característica, tendrás que configurar la mejora de Datanucleus de forma manual (JDO, JPA) a fin de migrar tu proyecto a Cloud Code. Deberías usar Objectify como la capa de ORM cuando lees o escribes en Cloud Datastore.

Instala el complemento nuevo

Si aún no lo has hecho, instala el complemento de la siguiente manera:

  1. From inside IDEA, open File > Settings. Or, on Mac OS X, open IntelliJ IDEA > Preferences.
  2. Select Plugins from the navigation pane and search for Cloud Code.
  3. Click Install.
  4. Choose to Restart your IDE.
  5. Configure the project JDK:
    1. Open File > Project Structure. Or on Mac OS X open IntelliJ IDEA > Project Structure.
    2. Choose Project Settings > Project.
    3. If the Project JDK is missing, click New... and choose a JDK.

Configura IntelliJ y tu proyecto

Después de instalar el complemento, debes seguir estos pasos a fin de configurar IntelliJ y tu proyecto para usar el complemento nuevo:

  1. Cuando recibas la notificación de que el complemento nuevo genera conflictos con la integración existente de App Engine, acepta que se inhabilite el complemento antiguo.

    Captura de pantalla que muestra la notificación que indica que el complemento genera conflicto y el aviso para inhabilitarlo.

  2. Reinicia IntelliJ.

  3. Cuando recibas la notificación de que tu proyecto tiene un formato antiguo, haz clic en Convert (Convertir) para convertirlo al nuevo.

    Captura de pantalla que muestra la notificación que indica que el proyecto tiene el formato antiguo y el aviso para convertirlo.

  4. Deberías borrar tu servidor existente de App Engine y las instancias de Cloud, y volver a crear todo con el SDK de Cloud nuevo.

    1. Navega a Settings (Configuración) -> Build, Execution, Deployment (Compilación, Ejecución, Implementación) -> Application Servers (Servidores de la aplicación).

    2. Selecciona tus instancias de Desarrollo de App Engine y haz clic en Borrar (-).

    3. Haz clic en Agregar (+) y selecciona Servidor de desarrollo de Google App Engine.

      Captura de pantalla que muestra una lista de servidores de apps y el ícono para borrarlos y agregarlos.

    4. Navega a Settings (Configuración) -> Build, Execution, Deployment (Compilación, Ejecución, Implementación) -> Clouds (Nubes).

    5. Selecciona las instancias de la nube de Google App Engine y haz clic en Borrar (-).

    6. Haz clic en Agregar (+) para configurar un objetivo de implementación en la nube de App Engine.

      Captura de pantalla que muestra una lista de instancias de la nube y los íconos para borrarlas y agregarlas.

  5. Si tienes alguna configuración de ejecución en el servidor local de App Engine, debes actualizarla para que use el servidor de aplicaciones configurado recientemente.

  6. Navega a Herramientas -> Cloud Code para ver la lista de acciones que tienes disponibles para ejecutar y, también, implementar tu aplicación o ver la documentación a fin de obtener más información.

  7. Para proyectos basados en Maven o Gradle, asegúrate de que usas la versión más reciente de los complementos de App Engine para Gradle y Maven.

Cómo configurar proyectos nativos de IntelliJ

Actualiza tus dependencias de App Engine solo para los proyectos nativos de IntelliJ (p. ej., proyectos cuyos ajustes se configuraron de forma manual con la faceta antigua de App Engine y que no se sincronizaron con Gradle o Maven).

Tus dependencias de App Engine están configuradas como "External Libraries" (Bibliotecas externas) y las proporciona la instalación antigua del SDK de App Engine. Si borras la instalación del SDK de App Engine, tu aplicación no se compilará.

Captura de pantalla que muestra una lista de bibliotecas externas.

Para quitar esta dependencia del SDK antiguo de App Engine, configura las dependencias de la API de App Engine con la característica de importación de la faceta de App Engine, de la siguiente manera:

  1. Los usuarios de la antigua característica de mejora JDO/JPA de Datanucleus del complemento deben portar sus aplicaciones a Maven o Gradle, ya que la mejora de Datanucleus no es compatible con el complemento de Cloud Code.

  2. En la IU de la estructura del proyecto de IntelliJ, navega a la pestaña de dependencias estándar del módulo de App Engine.

  3. Quita todas las bibliotecas relacionadas de App Engine.

    Captura de pantalla que muestra una lista de bibliotecas externas y los íconos para borrarlas.

  4. En la misma IU de la estructura del proyecto, navega a la faceta Google App Engine de tu módulo de App Engine.

  5. En el panel Libraries (Bibliotecas), selecciona las dependencias de App Engine que usas.

    Captura de pantalla que muestra una lista de las bibliotecas disponibles para seleccionar.

    Con esta acción, se recuperarán automáticamente estas dependencias desde Maven Central y se agregarán a la ruta de clase de tu módulo.

  6. Ejecuta y, luego, implementa de forma local para verificar que tu configuración nueva funcione.

  7. En este punto, ya puedes borrar con seguridad tu SDK de App Engine antiguo.

Cómo obtener asistencia

Si deseas enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Cloud Code para IntelliJ