Apéndice: ADR de ejemplo

Title (Título)

Esta decisión define el enfoque de ciclo de vida del desarrollo de software para el desarrollo de aplicaciones ABC.

Estado

Aceptada

Fecha

11/03/2022

Contexto

La aplicación ABC es una solución empaquetada que se implementará en el entorno del cliente mediante un paquete de implementación. Debemos contar con un proceso de desarrollo que nos permita disponer de una característica, un hotfix y una canalización de lanzamiento controlables.

Decisión

Utilizamos una versión adaptada del Flujo de trabajo de GitFlow para desarrollar la aplicación ABC.

Por motivos de simplicidad, no utilizaremos las ramas hotfix/* y release/*, porque la aplicación ABC se empaquetará en lugar de implementarse en un entorno específico. Por esta razón, no es necesaria una complejidad adicional que pueda impedirnos reaccionar con rapidez para corregir errores en las versiones de producción o probar las versiones en un entorno independiente.

La estrategia de ramificación acordada es la siguiente:

• Cada repositorio debe tener una rama main protegida que se utilizará para etiquetar las publicaciones.

• Cada repositorio debe tener una rama develop protegida para todo el trabajo de desarrollo en curso.

Consecuencias

Positivo:

• El proceso de GitFlow adaptado nos permitirá regular el control de versiones de lanzamiento de la aplicación ABC.

Negativo:

• GitFlow es más complicado que el desarrollo basado en enlaces troncales o el flujo de GitHub y tiene más sobrecarga.

Conformidad

• Las ramas main y develop de cada repositorio se deben marcar como Protected.

• Las modificaciones a las ramas main y develop se deben propagar mediante solicitudes de fusión.

• Se requiere al menos una aprobación para cada solicitud de fusión.

Notas

• Autor: Jane Doe

• Versión: 0.1

• Registro de cambios:

  • 0.1: Versión inicial propuesta