Graficar ejemplo completo de integrar GitFlow y GitLab MRs

AUTHOR: Osiris Alejandro Gomez

EMAIL: osiux@osiux.com

DATE: 2023-05-12 09:30

#+ATTR_HTML: :title Git Flow Full Example with branch develop, master, support 0.1x, support 0.2.x and four tags include GitLab Pipeline Status, Ready and Approve MR for branchs feature, hotfix and release

[IMG]

[1]

Hace 10 años que uso `git flow` ^1[2] en `gcoop` ^2[3] y hace 2 años que en un proyecto grande lo usamos conjuntamente con el circuito de `MRs` ^3[4] de `GitLab` ^4[5] para clarificar un poco todo el proceso decidí utilizar `GraphViz`

En el diagrama de ejemplo se plantean 2 *features* (`foo` y `bar`), cada uno es para un *release* en particular (`v0.1.0` y `v0.2.0`) y posterior a cada *release* se generan 2 *hotfix* (`v0.1.1` y `v0.2.2`).

El `código del grafo` ^5[6] esta disponible en el *repo* `osiux-graphviz` ^6[7]

El flujo de desarrollo es idéntico tanto para `feature`, `release` y `hotfix`, es decir, todos los *branchs* requieren los siguientes pasos:

1. Crear *branch* e inmediatamente, crear *MR* en *Draft*

2. Desarrollar *feature*, *release* y/o *hotfix*

3. Verificar *Pipeline Success* de *GitLab* (caso contrario volver a 2)

4. Si el desarrollo esta listo, marcar *Ready*

5. Revisar *MR* y Aprobar solo si hay *PS* (caso contrario volver a 2)

6. Si se completaron todos los pasos anteriores, realizar *merge*

┌─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬────────┐
│ *type*  │ *tag/br │ *Create │  *PS*   │ *Ready* │ *Review │ *Approv │ *Merge │
│         │  anch*  │   MR*   │         │         │   MR*   │   e*    │   *    │
╞═════════╪═════════╪═════════╪═════════╪═════════╪═════════╪═════════╪════════╡
│         │ `v0.1.0 │         │         │         │         │         │        │
│ *Tag Re │ ,       │         │ *GitLab │         │         │         │        │
│ leases* │ v0.2.0, │ *N/A*   │ *       │ *N/A*   │ *N/A*   │ *N/A*   │ *N/A*  │
│         │ v0.1.1, │         │         │         │         │         │        │
│         │ v0.2.2` │         │         │         │         │         │        │
├─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────┤
│         │ `master │         │         │         │         │         │        │
│ *Stable │ , suppo │         │         │         │         │         │        │
│ Release │ rt/0.1. │ *N/A*   │ *GitLab │ *N/A*   │ *N/A*   │ *N/A*   │ *N/A*  │
│ s*      │ x, supp │         │ *       │         │         │         │        │
│         │ ort/0.2 │         │         │         │         │         │        │
│         │ .x`     │         │         │         │         │         │        │
├─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────┤
│         │ `releas │         │         │         │         │         │        │
│ *Releas │ e/0.1.0 │ *Develo │ *GitLab │ *Develo │ *Mantai │ *Mantai │ *Manta │
│ e Branc │ , relea │ per*    │ *       │ per*    │ ner*    │ ner*    │ iner*  │
│ hs*     │ se/0.2. │         │         │         │         │         │        │
│         │ 0`      │         │         │         │         │         │        │
├─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────┤
│ *Hotfix │ `hotfix │         │         │         │         │         │        │
│ Branchs │ /0.1.1, │ *Develo │ *GitLab │ *Develo │ *Mantai │ *Mantai │ *Manta │
│ *       │ hotfix/ │ per*    │ *       │ per*    │ ner*    │ ner*    │ iner*  │
│         │ 0.2.2`  │         │         │         │         │         │        │
├─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────┤
│ *Featur │ `featur │         │         │         │         │         │        │
│ e Branc │ e/foo,  │ *Develo │ *GitLab │ *Develo │ *Mantai │ *Mantai │ *Manta │
│ hs*     │ feature │ per*    │ *       │ per*    │ ner*    │ ner*    │ iner*  │
│         │ /bar`   │         │         │         │         │         │        │
└─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴────────┘

feature, release y tag

☐ crear *issue* en `project#123`

☐ crear *branch* `feature/foo` saliendo de `develop` en el *repo* que corresponda

☐ crear *MR* `Draf: Resolve feature/foo "Issue Tittle"` con `Closes project#123`

☐ *branch* `feature/foo` debe tener *MR* con *PS*

☐ crear documentación en *wiki* `foo/foo_bar_vM.N.P`

☐ *branch* `release/M.N.P` debe tener *PS*

☐ *tag* `vM.N.P`

hotfix

☐ crear *branch* `support/M.N.x` saliedo de *tag* `vM.M.x`

☐ crear *branch* `hotfix/foobar` saliendo de `support/M.N.x`

☐ *branch* `hotfix/foobar` debe tener *MR* con *PS*

Referencias

┌─────────┬─────────────────────┐
│  item   │     descripción     │
╞═════════╪═════════════════════╡
│ *MR*    │ *Merge Request*     │
├─────────┼─────────────────────┤
│ *PS*    │ *Pipeline Success*  │
├─────────┼─────────────────────┤
│ `M.N.P` │ `MAJOR.MINOR.PATCH` │
└─────────┴─────────────────────┘