Para acelerar tu desarrollo local en Cloud Code para VS Code, 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 y la recarga en caliente de Skaffold
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.
Para los archivos estáticos (como 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 cambios al contenedor en ejecución en tu clúster. Cambios en los tipos de archivo que no admiten activos la recarga activa una recompilación de la imagen y el 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 desarrolladores, como
Docker, puedes especificar una sección sync
en tu archivo skaffold.yaml
para la
del artefacto que personalizas.
La configuración de sincronización puede ser una de las siguientes (en orden de preferencia):
auto
: Skaffold configura la sincronización automáticamente. (solo para artefactos de Jib y Buildpacks). Esta es la configuración predeterminada de los paquetes de compilación.infer
: Los destinos de cada archivo modificado se infieren del compilador.manual
: Debes especificar los archivos en tu lugar de trabajo local y su destino en el contenedor en ejecución.
En la siguiente sección sync
de ejemplo de un archivo skaffold.yaml
, se especifica un
Sincronización de manual
para sincronizar todos los archivos HTML /static-html
con 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 cuando desarrollas 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 cuenta de Kubernetes clúster sin detener ni quitar el Deployment, compilarlo etiquetar la imagen o actualizar el clúster.
Un ciclo de iteración estándar se parece al siguiente:
Realiza 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 los parámetros de configuración de Skaffold
Cuando se desarrollan aplicaciones de microservicios, puede ser útil trabajar en de forma independiente para simplificar la depuración y la implementación.
Puedes desarrollar y depurar partes de tu aplicación de forma independiente al dividir
tu aplicación en los módulos de Skaffold. Por ejemplo, el
Muestra de Bank of Anthos
es una aplicación que contiene diez microservicios. El valor
skaffold.yaml
de archivos 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 módulos y dependencias de configuración de Skaffold, 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 una configura un módulo de Skaffold, especifica la siguiente línea:metadata: name: MODULE_NAME_1
Por ejemplo, en
skaffold.yaml
del Banco de Anthos, el módulodb
define implementaciones de bases de datos:Para configuraciones que dependen de otra configuración que se implementó antes se puede implementar la configuración actual, debes agregarla a las dependencias. Para especificar una dependencia de configuración, agrega una lista
configs
al 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 enumeradas de esta manera pueden hacer referencia a dependencias definidas en el el mismo archivo u otros archivos
skaffold.yaml
en el 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 los módulos y sus dependencias, puedes especificar qué
módulos que quieras ejecutar con Cloud Code en tu archivo launch.json
.
Si tu proyecto no tiene un archivo launch.json
definido, cuando ejecutes Cloud
Code: Run on Kubernetes o Cloud Code: Debug on Kubernetes, lo que
que selecciones los módulos para compilar:
- Abre la Paleta de comandos (
Ctrl
/Cmd
+Shift
+P
) y, luego, ejecuta Cloud Code: Ejecutar en Kubernetes. - Haz clic en Select modules.
- Elige los módulos que quieres implementar y haz clic en OK. Cada módulo se compila con sus dependencias.
- Cuando se te solicite, elige un registro de imágenes y, luego, presiona
Enter
.
Si tu proyecto tiene un launch.json
, sigue estos pasos para elegir los módulos de Skaffold que se compilarán:
Abre el archivo
launch.json
de tu proyecto.Edita la configuración de inicio para agregar la opción
skaffoldFlags
con una Lista delimitada por comas demodules
que se compilará. Si se omiteskaffoldFlags
, se compilan todos los módulos.{ "name": "Run on Kubernetes", "type": "cloudcode.kubernetes", "request": "launch", "skaffoldConfig": "${workspaceFolder}/skaffold.yaml", "skaffoldFlags": { "modules": ["MODULE_NAME_2,MODULE_NAME_2"], "watch": true, "cleanUp": true, } }
Ejecuta la configuración de inicio que editaste.
Desarrollo continuo en Kubernetes
Una vez que hayas configurado tu destino de ejecución con las opciones que desees, puedes optar por una ejecución normal 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 Run 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.
- Personaliza la implementación mediante las opciones de configuración disponibles.
- Si tu aplicación está configurada para usar módulos de Skaffold, puedes seleccionar módulos específicos para compilar o implementar.
- Abre la paleta de comandos (presiona
Ctrl
/Cmd
+Shift
+P
) y, luego, ejecuta la Comando Cloud Code: Run on Kubernetes. - Confirma si deseas usar el contexto de Kubernetes actual para ejecutar la app (o cambia a uno preferido). Para obtener más información sobre cómo configurar un contexto de Kubernetes, consulta Cómo configurar la configuración.
Si elegiste un clúster remoto como contexto, cuando se te solicite, elige un registro de imágenes para enviar las imágenes. Si usas Container Registry, puedes explorar un registro existente o especificar el nombre de un registro para crearlo. Si tu proyecto tiene La API de Artifact Registry está habilitada y al menos un repositorio de Artifact Registry puedes navegar hasta un repositorio existente de Artifact Registry y seleccionarlo.
A continuación, Cloud Code compila los contenedores, los envía al registro, aplica las configuraciones de Kubernetes al clúster y espera el lanzamiento.
¿Qué sigue?
- Usa las funciones integradas Clúster de Minikube para el desarrollo local.
- Depura tu aplicación en Cloud Code
- Lee los detalles en Función de sincronización de archivos de Skaffold