Publicación de versiones
Esta página describe el procedimiento exacto de publicación de Axelix.
Hay dos tipos de publicación con la misma estructura: ambos distribuyen todos los componentes a la vez bajo una versión:
- Una versión menor se publica desde
mastery abre una nueva líneaX.Y. - Una versión de parche se publica desde la rama de parches de esa línea (
X.Y.x) y lleva todos los componentes aX.Y.Z.
Por supuesto, también publicaremos versiones principales. Cuando llegue el momento, documentaremos su procedimiento.
Para conocer la organización de las ramas, consulte modelo de ramas.
Versiones menores
Una versión menor publica todos los componentes juntos bajo una versión X.Y.0 y la marca con una
etiqueta vX.Y.0 en master (consulte
una versión para cada componente). El
procedimiento, por orden:
1. Preparación
La preparación consiste en los cambios manuales previos a la publicación. Todos se incluyen en un único commit en
master, para poder revertir o aplicar selectivamente la publicación de forma limpia si es necesario posponerla.
- Establecer la versión del conjunto. Entre publicaciones,
axelixVersionen elgradle.propertiesde la raíz contiene la próxima versión con el sufijo-SNAPSHOT, por ejemplo3.1.0-SNAPSHOTmientras3.1.0está en desarrollo. La preparación elimina el sufijo y establece la versión exacta que se va a publicar: para3.1.0, se establece3.1.0. El proceso de publicación lee este valor y lo utiliza para nombrar la etiqueta resultante; el proceso rechaza publicar una versión-SNAPSHOT. Elgradle.propertiesde la raíz es el único lugar donde se define la versión: todos los componentes la heredan de ahí. - Actualizar los playgrounds. Las aplicaciones de ejemplo de
playgrounds/son, por diseño, proyectos independientes: no heredanaxelixVersion, sino que fijan explícitamente las versiones del starter y el plugin de Axelix que utilizan. Actualice esas versiones a la que se va a publicar. - Actualizar la documentación. Solo mantenemos documentación versionada por línea principal. Por ejemplo, durante el desarrollo de una versión menor, añadimos avisos de «próxima versión» para sus funciones; al publicar la versión menor que las incluye, sustituimos esos avisos por los correspondientes avisos de «disponible desde».
2. Iniciar el proceso de publicación
No creamos la etiqueta manualmente. El proceso de publicación lee la versión de gradle.properties y ejecuta sus comprobaciones previas. Después publica los artefactos Maven (starters y plugins), compila y publica la imagen Docker de Master, y empaqueta y firma el chart de Helm. Solo entonces crea y envía la etiqueta vX.Y.0, y después actualiza el repositorio de charts de Helm. Por tanto, los artefactos pueden haberse publicado ya si el proceso falla antes de crear la etiqueta.
Las notas de la versión se redactan manualmente
El proceso crea la etiqueta y un borrador de la versión en GitHub con los artefactos JAR y Helm adjuntos.
El desarrollador que realiza la publicación debe editar las notas del borrador de vX.Y.0 y después publicar el borrador manualmente.
Redactar las notas por sí solo no lo publica.
Versiones de parche
Una versión de parche, como cualquier versión de Axelix, publica todos los componentes bajo una versión: no hay
parches por componente. El procedimiento es similar al de una versión menor, con una diferencia estructural: se publica desde
la rama de parches de la línea de versiones menores en lugar de master. Se omite el paso de documentación: los parches no
cambian la documentación.
-
Cambiar a la rama de parches. El trabajo de parches se mantiene en la única rama de la línea, llamada
X.Y.x. La letraxrepresenta toda la línea de parches y, a diferencia de una etiqueta, el nombre de la rama no lleva prefijov. Se crea a partir de la etiquetavX.Y.0de la versión menor (consulte modelo de ramas → dónde se desarrollan los parches). Créela desde la etiqueta si es el primer parche de la línea; en otro caso, ya existe. -
Incorporar las correcciones a esa rama. Una corrección suele incorporarse primero a
mastery después se adapta a la rama de parches; solo cambia lo que el parche corrige realmente. -
Preparación en la rama (un único commit).
- Establecer la versión del conjunto. Establezca
axelixVersionen elgradle.propertiesde la raíz con la nueva versión de parcheX.Y.Z. A diferencia demaster, la rama de parches no tiene sufijo-SNAPSHOTentre publicaciones: conserva la última versión publicada de su línea hasta que el siguiente parche la actualiza. - Actualizar los playgrounds. Actualice las aplicaciones de ejemplo a la nueva versión de parche, por el mismo motivo que en una
menor: fijan explícitamente sus versiones de Axelix y no heredan
axelixVersion.
- Establecer la versión del conjunto. Establezca
-
Iniciar el proceso de publicación. Es el mismo proceso que para una versión menor, iniciado desde la rama de parches en lugar de
master. Sigue la misma secuencia de comprobaciones, publicación, empaquetado y etiquetado descrita arriba, con la versiónX.Y.Zy la etiquetavX.Y.Z. Como todas las etiquetas de Axelix, lleva el prefijov. Al igual que en una versión menor, crea un borrador de la versión en GitHub con los artefactos JAR y Helm. El desarrollador debe editar las notas del borrador para la nueva etiqueta y después publicar el borrador manualmente.
Ejemplo completo
Supongamos que la versión 3.1.0 necesita una corrección en el Axelix Spring Boot 3 Starter:
- El parche se mantiene en la rama
3.1.x, creada a partir de la etiquetav3.1.0. Si la línea3.1ya recibió un parche, esa rama existe; en otro caso, la creamos desdev3.1.0. - Adaptamos la corrección de
mastera esa rama. - En el
gradle.propertiesde la raíz establecemosaxelixVersionen3.1.1, la versión de parche que queremos publicar, y actualizamos los playgrounds a3.1.1. - Iniciamos el proceso de publicación desde la rama
3.1.x. Publica los artefactos Maven y la imagen de Master con la versión3.1.1, empaqueta el chart de Helm y después crea y envía la etiqueta conjuntav3.1.1. A continuación actualiza el repositorio de charts. Todos los componentes reciben la versión3.1.1, aunque solo haya cambiado un starter.
El resultado cumple lo que promete
una versión para cada componente:
tras la publicación, 3.1.1 existe para todos los componentes. Puede actualizar todos los componentes desplegados
a la vez o solo el que se ha corregido:
la compatibilidad se garantiza por major.minor,
por lo que las diferencias de versión de parche entre componentes desplegados siempre son seguras.