Construir una vez, desplegar en cualquier lugar: enfoque para la promoción de aplicaciones

Saurabh Joshi
By Saurabh Joshi
Oct 28, 2026 8 min read

Introducción

La entrega moderna de aplicaciones exige compilaciones confiables, implementaciones consistentes y procesos de lanzamiento controlados. Reconstruir una aplicación para cada entorno puede generar inconsistencias y resulta complicado confirmar que la versión de la aplicación probada por QA llegue a Producción. El enfoque de compilar una vez, desplegar en cualquier lugar, aborda este problema construyendo el artefacto de la aplicación una sola vez y promoviendo su uso en diferentes entornos sin necesidad de reconstrucción.

El proceso de lanzamiento comienza con una rama de release seguida por los cambios del desarrollador y las canalizaciones JAR requeridas. Jenkins compila la aplicación y crea una imagen Docker, enviando la imagen al Amazon Elastic Container Registry (Amazon ECR). Optimizar el tamaño de las imágenes Docker durante este proceso de compilación mejora la eficiencia de la implementación, explorando las mejores prácticas para reducir el tamaño de las imágenes Docker con compilaciones multinivel.

Luego, la canalización de implementación despliega la imagen a Test. Después de que QA completa una prueba de validación básica, se utiliza una canalización de aprobación para controlar la promoción a entornos superiores como UAT y Producción. Helm, Kubernetes y ArgoCD soportan la configuración y el despliegue específicos por entorno. Este enfoque separa la compilación de la aplicación de la implementación y promoción, creando así un proceso de control de lanzamiento consistente y rastreable.

Puntos clave

  • Construir una vez: Crear el artefacto de la aplicación y la imagen Docker una vez por cada candidato a lanzamiento.
  • Probar antes de promocionar: Completar las pruebas de validación de calidad antes de promocionar el lanzamiento.
  • Reutilizar el mismo artefacto: Promocionar la imagen validada en Test, UAT y Producción.
  • Configuración separada: Usar valores de Helm para administrar ajustes específicos del entorno.
  • Controlar los lanzamientos: Implementar puertas de aprobación para entornos superiores.
  • Mantener trazabilidad: Asociar cada imagen con su versión de lanzamiento y revisión de origen.

¿Por qué adoptar un enfoque de construir una sola vez?

El enfoque previene que aplicaciones construidas para diferentes entornos produzcan dependencias diversas, parámetros de compilación o revisiones de código fuente distintas. En consecuencia, el artefacto desplegado en Producción podría diferir del que fue probado por QA. El enfoque de construir una sola vez evita recompilaciones innecesarias durante la promoción. Una vez que Jenkins ha creado el artefacto de lanzamiento, el proceso de promoción incluye pruebas, aprobación y despliegue. El flujo de trabajo es el siguiente:

Construir → Probar → Sanidad QA → Aprobación → UAT → Producción

Cada entorno utiliza la misma imagen de la aplicación; la configuración de despliegue puede cambiar según el entorno. Este enfoque mejora la consistencia del artefacto, facilita la resolución de problemas, minimiza las operaciones duplicadas de compilación y hace que la trazabilidad del lanzamiento sea más sencilla.

Cómo funciona el proceso de lanzamiento

  1. Crear la rama de lanzamiento
    La canalización de lanzamiento crea una rama de lanzamiento. Los desarrolladores realizan los cambios necesarios en la rama, que se convierte en la fuente para la siguiente compilación. Luego, el equipo ejecuta las canalizaciones JAR requeridas, JAR 2.0 y JAR 2.2, según los requisitos del lanzamiento. La compilación de la aplicación comienza una vez que se han completado con éxito los pasos de preparación necesarios.
     
  2. Construir la aplicación con Jenkins
    Jenkins se encarga del proceso de construcción de la aplicación. La canalización de compilación extrae la rama de lanzamiento, realiza los pasos de construcción requeridos y crea el artefacto de la aplicación. La canalización luego empaqueta la aplicación en una imagen Docker y sube la imagen a Amazon ECR. El equipo debe registrar la versión del lanzamiento, el SHA del commit de Git, el número de compilación de Jenkins y la etiqueta de la imagen. Esta información ayuda a identificar el artefacto exacto asociado con un lanzamiento. Una vez que la compilación es exitosa y pasa las verificaciones requeridas, el proceso de promoción debe reutilizar el artefacto existente en lugar de construir la aplicación nuevamente.
     
  3. Almacenar la imagen Docker en Amazon ECR
    Amazon ECR es un repositorio central para almacenar y recuperar imágenes Docker. Después de que Jenkins ha creado la imagen, la sube al repositorio ECR correspondiente. Las canalizaciones de despliegue recuperarán esa imagen al desplegar la aplicación en diferentes entornos. Una etiqueta de imagen única ayuda a identificar cada lanzamiento. Usar la misma etiqueta de imagen en todos los entornos garantiza que Test, UAT y Producción reciban el mismo artefacto.

Implementar en Pruebas y completar la validación básica de aseguramiento de calidad

Una vez que la imagen está en Amazon ECR, la canalización de despliegue la implementa en Test. Helm gestiona la configuración de despliegue de Kubernetes mientras que ArgoCD sincroniza la configuración deseada con el entorno Kubernetes objetivo. El proceso de despliegue debe verificar que la aplicación se haya iniciado correctamente, que las comprobaciones de estado hayan pasado y que la funcionalidad crítica funcione según lo esperado. QA realizará pruebas de validación para confirmar la versión. Si la aplicación no pasa la validación, el equipo resuelve el problema y repite las comprobaciones necesarias antes de continuar. Un despliegue exitoso no significa que la versión esté lista para su promoción. Una vez que QA haya completado las comprobaciones requeridas, la versión avanza a la etapa de aprobación.

Promocionando la misma compilación a entornos superiores

La canalización de aprobación proporciona un punto de control controlado antes de que el lanzamiento avance a entornos superiores. El proceso sigue estos pasos:

  • Jenkins compila la aplicación y publica la imagen Docker.
  • La canalización de implementación despliega la imagen en Test.
  • QA completa las pruebas de integridad.
  • La canalización de aprobación solicita la autorización para la promoción.
  • Un interesado autorizado aprueba el lanzamiento.
  • El proceso de despliegue promueve la misma imagen a UAT.
  • El equipo completa la aprobación requerida para Producción.
  • El proceso de despliegue promueve la imagen aprobada a Producción.

La aprobación autoriza la promoción, no desencadena otra compilación de la aplicación. Esta separación ayuda a mantener un registro claro del artefacto que pasó la validación y llegó a Producción.

Gestionar implementaciones con Helm, Kubernetes y ArgoCD

Diferentes entornos tendrán diferentes requisitos operativos. Producción puede necesitar más réplicas y límites de recursos más altos que prueba, pero esto no requiere una nueva imagen de aplicación. Los archivos de valores de Helm gestionan estas configuraciones de despliegue. Los equipos también pueden configurar endpoints específicos para cada entorno y ajustes de funcionalidades de forma separada al artefacto de la aplicación. ArgoCD soporta despliegues basados en GitOps sincronizando los entornos de Kubernetes con la configuración deseada almacenada en Git.

Cada herramienta tiene una responsabilidad distinta:

    1. Jenkins: Compila la aplicación y publica imágenes Docker.
    2. Amazon ECR: Almacena las imágenes de la aplicación.
    3. Helm: Gestiona la configuración del despliegue.
    4. ArgoCD: Sincroniza la configuración deseada con Kubernetes.
    5. Kubernetes: Ejecuta y gestiona la aplicación.

 Para más información, explora pasos para actualizar un clúster Amazon EKS y endurecimiento integral de contenedores en Amazon EKS.

Pipelines de Jenkins y sus responsabilidades

La configuración de Jenkins se divide en diferentes responsabilidades en lugar de poner todo el proceso de lanzamiento en una sola canalización. Algunas de las canalizaciones importantes en el flujo son:

Canalización

Propósito

release-pipeline

Crea la rama de lanzamiento

build-pipeline

Construye la aplicación

deploy-pipeline

Despliega la compilación

approval-pipeline

Aprobará la etiqueta para la promoción a entornos superiores

Cada canalización maneja una responsabilidad específica, lo que facilita seguir y solucionar problemas en el proceso de lanzamiento. Las dependencias claras también evitan que compilaciones fallidas o verificaciones de QA no exitosas avancen a etapas posteriores.

Construir una vez vs reconstruir para cada entorno

Reconstruir para Cada Entorno

Construir Una Vez

La aplicación se construye varias veces

La aplicación se construye una vez

Se pueden generar diferentes artefactos

Se promueve el mismo artefacto

La construcción se repite para entornos superiores

Los entornos superiores reutilizan la construcción existente

Mayor dependencia del proceso de construcción durante el despliegue

El despliegue está separado de la construcción

Más difícil garantizar que Prueba y Producción usen la misma construcción

Se puede promover el mismo artefacto

El enfoque de construir una vez no elimina las pruebas específicas para cada entorno. Cada entorno sigue requiriendo controles adecuados de despliegue y liberación. Simplemente elimina reconstrucciones innecesarias de la aplicación durante el proceso de promoción.

Buenas prácticas para una promoción de aplicaciones confiable

Algunas prácticas ayudan a mantener la coherencia durante todo el ciclo de vida de la liberación.

  1. No reconstruir nunca durante la promoción
    Reutiliza el artefacto existente en todos los entornos. Si se requiere un cambio en la aplicación, crea una nueva construcción y repite la validación necesaria.
     
  2. Separar la configuración del código de la aplicación
    Gestiona las configuraciones específicas de cada entorno mediante valores de Helm y un mecanismo adecuado de manejo de secretos.
     
  3. Usar referencias inmutables de imágenes
    Registra las etiquetas de imagen y usa la misma referencia de imagen en todos los entornos.
     
  4. Aplicar validaciones y puertas de aprobación
    Evita que las liberaciones avancen cuando fallen las pruebas o aprobaciones requeridas.
     
  5. Mantener la trazabilidad
    Registra el commit fuente, número de construcción de Jenkins, etiqueta de imagen e historial de despliegue. 
    Para despliegues en producción que requieren gestión avanzada del tráfico y visibilidad del servicio, implementar un service mesh como Istio proporciona un control detallado sobre la comunicación y observabilidad de la aplicación. 
     
  6. Planificar la reversión
    Conserva imágenes previamente aprobadas y mantiene registros de despliegue para apoyar la recuperación cuando una liberación cause problemas.

Conclusión

El enfoque de construir una vez y desplegar en cualquier lugar separa la construcción de la aplicación del despliegue y la promoción, ayudando a los equipos a mantener la coherencia a lo largo del ciclo de vida del lanzamiento. Jenkins construye la aplicación y publica la imagen Docker en Amazon ECR. La canalización de despliegue entrega la imagen a Test, donde QA realiza pruebas de verificación básica. Tras las aprobaciones necesarias, el equipo promueve la misma imagen a UAT y Producción.

Helm gestiona la configuración del despliegue, Kubernetes ejecuta la aplicación y ArgoCD soporta despliegues basados en GitOps. El principio clave es sencillo: construir una vez, validar el artefacto y promover ese mismo artefacto a través de los entornos.

Al evitar reconstrucciones innecesarias y mantener controles claros de aprobación, los equipos pueden mejorar la consistencia de los artefactos, simplificar la resolución de problemas y establecer un proceso de lanzamiento CI/CD más confiable. Para extender esta confiabilidad aún más y optimizar los costos de infraestructura, los equipos también pueden implementar estrategias inteligentes de autoscaling de Kubernetes con herramientas como Karpenter para ajustar automáticamente los recursos en función de la demanda de la aplicación en tiempo real.