Acelera el desarrollo en Cloud Code para IntelliJ

Para acelerar tu desarrollo local en Cloud Code para IntelliJ, aprovecha la sincronización de archivos y la recarga en caliente, la implementación automática al guardar y usa módulos de Skaffold para desarrollar partes de una aplicación por separado.

Habilita la sincronización de archivos de Skaffold y la recarga en caliente

Para mejorar la eficiencia de tu flujo de trabajo de desarrollo local y evitar tener que volver a compilar, volver a implementar y reiniciar tus Pods, Skaffold admite la copia de archivos modificados en un contenedor implementado. Esto significa que, cuando realices cambios en los archivos estáticos y de código fuente, podrás ver cómo se aplican en segundos, lo que acelera el ciclo de retroalimentación.

En el caso de los archivos estáticos (como los archivos HTML y CSS), este comportamiento de copia de archivos se denomina sincronización de archivos.

Para los archivos de código fuente, este comportamiento se denomina recarga en caliente y admite los siguientes tipos de archivos:

  • Go: *.go
  • Java: *.java, *.kt, *.scala, *.groovy, *.clj
  • NodeJS: *.js, *.mjs, *.coffee, *.litcoffee, *.json

Con la recarga en caliente configurada, Skaffold detecta los cambios en los archivos admitidos y los sincroniza con el contenedor en ejecución en tu clúster. Los cambios en los tipos de archivos que no admiten la recarga en caliente activan una recompilación de imágenes y un reinicio del pod.

La sincronización automática de archivos y la recarga en caliente están habilitadas de forma predeterminada cuando trabajas con Buildpacks como tu compilador preferido. Para otros compiladores, como Docker, puedes especificar una sección sync en tu archivo skaffold.yaml para el artefacto que estás personalizando.

Tu parámetro de configuración de sincronización puede ser uno de los siguientes (en orden de preferencia):

  • auto: Skaffold configura automáticamente la sincronización. (solo para artefactos de Jib y Buildpacks) Este es el valor predeterminado para los Buildpacks.
  • infer: El compilador infiere los destinos de cada archivo modificado.
  • manual: Debes especificar los archivos en tu espacio de trabajo local y su destino en el contenedor en ejecución.

La siguiente sección de sync de ejemplo en un archivo skaffold.yaml especifica una sincronización de manual para sincronizar todos los archivos HTML de /static-html en la carpeta static de un contenedor:

build:
  artifacts:
    - image: gcr.io/k8s-skaffold/node-example
      context: node
      sync:
        manual:
          - src: 'static-html/*.html'
            dest: static

Para obtener información detallada sobre la sincronización de archivos y la especificación de reglas de sincronización, consulta la guía de Skaffold sobre la sincronización de archivos.

Agrega funciones nuevas durante el desarrollo en Kubernetes

Después de configurar la sincronización de archivos y la recarga en caliente, inicia un ciclo de iteración y agrega más funciones a tu proyecto. Los cambios se implementan en tu clúster de Kubernetes sin detener ni quitar la implementación, compilar ni etiquetar de forma manual la imagen, ni actualizar el clúster.

Un ciclo de iteración estándar se parece al siguiente:

  1. Realiza un cambio en tu proyecto. Por ejemplo, si usas la app de libro de visitas de Cloud Code Java, agrega un extremo nuevo a la clase FrontendController de la siguiente manera:

    1. Abre el archivo FrontendController.java desde src/main/java/cloudcode/guestbook/frontend y agrega lo siguiente:

      @RequestMapping("/greeting")
      @ResponseBody
      public String greeting(@RequestParam(value="name", defaultValue="World") String name) {
         return String.format("Hello from Kubernetes with IntelliJ, %s!", name);
      }
      
    2. Agrega las importaciones necesarias para las anotaciones nuevas, RequestMapping y ResponseBody.

  2. Guarda los cambios (Ctrl/Cmd+S) o compila el proyecto.

    Puedes mirar el progreso y los registros de la implementación en la ventana de la consola. Después de que se implementen los cambios, confirma las actualizaciones.

  3. Para finalizar la sesión de desarrollo continuo, haz clic en el ícono Detener.

    Cloud Code borra todos los recursos de Kubernetes que se usaron para la sesión de desarrollo.

Desarrolla aplicaciones de microservicios con configuraciones de Skaffold

Cuando desarrollas aplicaciones de microservicios, puede ser útil trabajar en secciones separadas de forma independiente para simplificar la depuración y la implementación.

Puedes desarrollar y depurar partes de tu aplicación de forma independiente si la divides en módulos de Skaffold. Por ejemplo, la muestra de Bank of Anthos es una aplicación que contiene diez microservicios. El archivo skaffold.yaml de la muestra agrupa estos servicios en cinco módulos de Skaffold llamados setup, db, frontend, backend y loadgenerator.

Define módulos de Skaffold y dependencias de configuración

Para definir módulos de Skaffold y dependencias de configuración, haz lo siguiente:

  1. Abre el proyecto en el que deseas definir los módulos.

  2. Abre el archivo skaffold.yaml.

  3. Si tu archivo skaffold.yaml tiene varias configuraciones, especifica la siguiente línea para convertir una configuración en un módulo de Skaffold:

    metadata:
      name: MODULE_NAME_1
    

    Por ejemplo, en el skaffold.yaml de Bank of Anthos, el módulo db define las implementaciones de la base de datos:

    apiVersion: skaffold/v3
    kind: Config
    metadata:
      name: db # module defining database deployments
    requires:
    - configs:
      - setup
    build:
      artifacts:
      - image: accounts-db
        context: src/accounts-db
      - image: ledger-db
        context: src/ledger-db
    manifests:
      rawYaml:
      - dev-kubernetes-manifests/accounts-db.yaml
      - dev-kubernetes-manifests/ledger-db.yaml
    deploy:
      kubectl: {}
  4. Para las configuraciones que dependen de que se implemente otra configuración antes de que se pueda implementar la configuración actual, debes agregar la configuración a tus dependencias. Para especificar una dependencia de configuración, agrega una lista configs a la sección requires de tu archivo skaffold.yaml.

    Por ejemplo, el archivo skaffold.yaml de Bank of Anthos incluye la dependencia de configuración setup.

    Para definir una dependencia, agrega lo siguiente a tu archivo skaffold.yaml, en el que DEPENDENCY_NAME es el nombre de tu dependencia.

    requires:
        - configs: DEPENDENCY_NAME
    

    Las configuraciones que se enumeran de esta manera pueden hacer referencia a dependencias definidas en el mismo archivo o en otros archivos skaffold.yaml del proyecto actual.

  5. Para probar las dependencias de configuración, compila cada uno de los módulos de Skaffold por separado para asegurarte de que se implementen con sus dependencias. Para ello, sigue los pasos que se indican en Cómo compilar módulos específicos de Skaffold y sus dependencias.

Compila módulos específicos de Skaffold y sus dependencias

Después de definir tus módulos y sus dependencias, puedes especificar qué módulos deseas ejecutar en la pestaña Build / Deploy cuando selecciones Run > Edit configurations.

  1. Instala las últimas compilaciones de usuarios con información privilegiada.

  2. Ve a Run > Edit configurations y abre la pestaña Build / Deploy.

  3. En Skaffold configuration, selecciona skaffold.yaml.

    Elige una de estas opciones:

    • Build and deploy with all modules and dependencies
    • Build and deploy with (si los módulos están disponibles) y selecciona los módulos que deseas compilar e implementar.

Tu selección se conservará para implementaciones posteriores. Si seleccionas un subconjunto de módulos, Cloud Code muestra una advertencia sobre la implementación de un subconjunto de módulos y no todo el sistema.

Desarrollo continuo en Kubernetes

Una vez que hayas configurado el destino de ejecución con las opciones que desees, puedes optar por una ejecución habitual de tu aplicación o iniciar un ciclo de iteración de desarrollo en tu IDE para propagar cualquier cambio realizado en la fuente y las dependencias de tu aplicación activa.

El objetivo de ejecución Develop on Kubernetes inicia el ciclo de desarrollo en tu clúster de Kubernetes. Después de iniciar el ciclo de desarrollo, Cloud Code, mediante Skaffold, compila una imagen para el proyecto y, luego, la etiqueta, la envía al repositorio configurado y usa kubectl para implementar los manifiestos de Kubernetes del proyecto.

  1. Haz clic en el ícono Develop on Kubernetes y, luego, en Edit Configurations para abrir el diálogo Run/Debug Configurations.
  2. Personaliza la implementación mediante las opciones de configuración disponibles.
  3. Si deseas que Cloud Code vuelva a implementar tu aplicación automáticamente después de guardar los cambios, en Modo de observación: volver a compilar y volver a implementar, selecciona Al guardar el archivo. Las aplicaciones nuevas de Kubernetes tienen seleccionada la opción On demand de forma predeterminada. Para obtener más información sobre los modos de reloj, consulta Modos de reloj.
  4. Si tu aplicación está configurada para usar módulos de Skaffold, puedes seleccionar solo para compilar o implementar módulos específicos.
  5. Una vez que estés satisfecho con la configuración, haz clic en OK y, luego, en el ícono de ejecutar.

¿Qué sigue?

Obtenga asistencia

Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve a Tools > Cloud Code > Help / About > Submit feedback or report an issue para informar un problema en GitHub.