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 los 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, 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 de código fuente y estáticos, podrás ver que se aplican en segundos, lo que genera un ciclo de retroalimentación acelerado.
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 compatibles y los sincroniza con el contenedor en ejecución en tu clúster. Los cambios en los tipos de archivos que no admiten la carga en caliente activan una recompilación de imágenes y un reinicio del pod.
La sincronización de archivos automática 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.
La configuración de sincronización puede ser una de las 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 de Buildpacks.infer
: Los destinos de cada archivo modificado se infieren del compilador.manual
: Debes especificar los archivos en tu espacio de trabajo local y su destino en el contenedor en ejecución.
En la siguiente sección sync
de ejemplo en un archivo skaffold.yaml
, se especifica una sincronización manual
para sincronizar todos los archivos HTML /static-html
con la carpeta static
en un contenedor:
build: artifacts: - image: gcr.io/k8s-skaffold/node-example context: node sync: manual: - src: 'static-html/*.html' dest: static
Para obtener una descripción detallada de 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:
Haz un cambio en tu proyecto. Por ejemplo, si usas la app de Cloud Code Java Guestbook, agrega un extremo nuevo a la clase
FrontendController
de la siguiente manera:Abre el archivo
FrontendController.java
desdesrc/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); }
Agrega las importaciones necesarias para las anotaciones nuevas,
RequestMapping
yResponseBody
.
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.
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 se desarrollan 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
del ejemplo agrupa estos servicios en cinco módulos de skaffold llamados setup
, db
, frontend
, backend
y loadgenerator
.
Define los módulos de Skaffold y las dependencias de configuración
Para definir los módulos de Skaffold y las dependencias de configuración, sigue estos pasos:
Abre el proyecto en el que deseas definir los módulos.
Abre el archivo
skaffold.yaml
.Si tu archivo
skaffold.yaml
tiene varias configuraciones, para hacer que una configuración sea un módulo de Skaffold, especifica la siguiente línea:metadata: name: MODULE_NAME_1
Por ejemplo, en el
skaffold.yaml
de Bank of Anthos, el módulodb
define las implementaciones de bases de datos:En el caso de 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ónrequires
de tu archivoskaffold.yaml
.Por ejemplo, el archivo
skaffold.yaml
de Bank of Anthos incluye la dependencia de configuraciónsetup
.Para definir una dependencia, agrega lo siguiente a tu archivo
skaffold.yaml
, en el que DEPENDENCY_NAME es el nombre de la 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.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 cuáles módulos quieres ejecutar en la pestaña Build / Deploy cuando selecciones Run > Edit configurations.Instala las últimas compilaciones de usuarios con información privilegiada.
Ve a Run > Edit configurations y abre la pestaña Build / Deploy.
En Configuración de Skaffold, selecciona skaffold.yaml.
Elige una de estas opciones:
- Compilar e implementar con todos los módulos y dependencias
- 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 tu destino de ejecución con las opciones que desees, puedes optar por la ejecución habitual de la 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.
- Haz clic en el ícono Develop on Kubernetes y, luego, en Edit Configurations para abrir el diálogo Run/Debug Configurations.
- Personaliza la implementación mediante las opciones de configuración disponibles.
- 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 Cuando se guarda el archivo. Las aplicaciones de Kubernetes nuevas 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.
- Si tu aplicación está configurada para usar módulos de Skaffold, puedes seleccionar solo para compilar o implementar módulos específicos.
- Una vez que estés conforme con la configuración, haz clic en OK y, luego, en el ícono Run.
¿Qué sigue?
- Usa el clúster de minikube integrado en Cloud Code para el desarrollo local.
- Cómo depurar tu aplicación en Cloud Code
- Lee los detalles sobre la función de sincronización de archivos de Skaffold.