From 7b1c0edd390cb0722c64c900018e5ce4621f179d Mon Sep 17 00:00:00 2001
From: "Thierry T." <1940947+lepiaf@users.noreply.github.com>
Date: Wed, 13 Nov 2024 11:45:29 +0100
Subject: [PATCH 01/14] Create 2024-11-19-semantic-release
---
_articles/fr/2024-11-19-semantic-release | 78 ++++++++++++++++++++++++
1 file changed, 78 insertions(+)
create mode 100644 _articles/fr/2024-11-19-semantic-release
diff --git a/_articles/fr/2024-11-19-semantic-release b/_articles/fr/2024-11-19-semantic-release
new file mode 100644
index 000000000..6fcfe1537
--- /dev/null
+++ b/_articles/fr/2024-11-19-semantic-release
@@ -0,0 +1,78 @@
+---
+contentType: article
+lang: fr
+date: '2024-11-19'
+slug: semantic-release
+title: Automatiser la création de la version d'une application avec semantic-release
+excerpt: Automatiser la création de la version d'une application avec semantic-release
+categories:
+ - devops
+authors:
+ - tthuon
+keywords: []
+---
+
+Votre est prête à être livrée. Pour cela, vous avez besoin de marquer votre application avec un numéro de version. Une convention permet de faciliter le suivi de version : [Gestion sémantique de version](https://semver.org/lang/fr/).
+
+La livraison de la version 1.0.0 s'est déroulé avec succès. Maintenant, vous avez besoin d'ajouter de nouvelles fonctionnalité. Il faudra donc incrémenter le numéro de version.
+
+Deux options possibles :
+- marquer la prochaine version manuellement
+- automatiser ce processus en suivant une convention
+
+Automatisons ce processus.
+
+## Convention de nommage des commits
+
+Afin d'automatiser le processus de marquage des versions, nous allons nous référer à l'historique des commits du dépôt Git. Une nouvelle version d'un logiciel peut se définir par un ensemble de commit entre la précédente version et la tête de la branche principale.
+
+Nos commits doivent respecter une convention. Pour cela, nous allons utiliser [Commits Conventionnels](https://www.conventionalcommits.org/fr/v1.0.0/).
+
+Pour simplifier, un commit commençant par
+- "feat: " va incrémenter le numéro de version mineur
+- "fix: " va incrémenter le numéro de version de correctif
+
+Une fois que nos commits respectent la nomenclature défini par Commits Conventionnels, nous pouvons utiliser un outil pour effectuer le différentiel de version : [semantic-release](https://github.com/semantic-release/semantic-release).
+
+## semantic-release
+
+semantic-release va automatiser ce processus de marquage d'une version d'un logiciel.
+
+Cela nécessite quelques configurations.
+
+Tout d'abord, il faut créer un fichier `.releaserc.yml` avec le contenu suivant :
+
+```yaml
+plugins:
+ -
+ - "@semantic-release/commit-analyzer"
+ - preset: "conventionalcommits"
+ -
+ - "@semantic-release/release-notes-generator"
+ - preset: "conventionalcommits"
+ - "@semantic-release/gitlab"
+branches:
+ - "main"
+```
+
+Cette configuration ajoute deux modules pour utiliser les commits conventionnels, et un troisième pour s'intégrer avec Gitlab.
+
+Enfin, la branche de référence en `main` dans notre cas.
+
+Dans le fichier `.gitlab-ci.yml`, ajoutons une tâche pour générer le prochain numéro de version.
+
+```yaml
+release:
+ image: dockerhub.ftven.net/node:lts
+ stage: release
+ variables:
+ GITLAB_TOKEN: ${RELEASE_TOKEN}
+ before_script:
+ - npm install semantic-release@"^23.0.8" @semantic-release/gitlab@"^13.0.4" conventional-changelog-conventionalcommits@"^7.0.2"
+ script:
+ - npx semantic-release
+ rules:
+ - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+ when: manual
+```
+
From 9a57262dab41fbd557ee5d7f00ed589d151ff5b1 Mon Sep 17 00:00:00 2001
From: "Thierry T." <1940947+lepiaf@users.noreply.github.com>
Date: Wed, 13 Nov 2024 11:55:38 +0100
Subject: [PATCH 02/14] Update and rename 2024-11-19-semantic-release to
2024-11-19-semantic-release.md
---
...release => 2024-11-19-semantic-release.md} | 28 ++++++++++++++++---
1 file changed, 24 insertions(+), 4 deletions(-)
rename _articles/fr/{2024-11-19-semantic-release => 2024-11-19-semantic-release.md} (63%)
diff --git a/_articles/fr/2024-11-19-semantic-release b/_articles/fr/2024-11-19-semantic-release.md
similarity index 63%
rename from _articles/fr/2024-11-19-semantic-release
rename to _articles/fr/2024-11-19-semantic-release.md
index 6fcfe1537..0f2a334ec 100644
--- a/_articles/fr/2024-11-19-semantic-release
+++ b/_articles/fr/2024-11-19-semantic-release.md
@@ -2,7 +2,7 @@
contentType: article
lang: fr
date: '2024-11-19'
-slug: semantic-release
+slug: automatiser-la-creation-de-la-version-dune-application-avec-semantic-release
title: Automatiser la création de la version d'une application avec semantic-release
excerpt: Automatiser la création de la version d'une application avec semantic-release
categories:
@@ -24,7 +24,7 @@ Automatisons ce processus.
## Convention de nommage des commits
-Afin d'automatiser le processus de marquage des versions, nous allons nous référer à l'historique des commits du dépôt Git. Une nouvelle version d'un logiciel peut se définir par un ensemble de commit entre la précédente version et la tête de la branche principale.
+Afin d'automatiser le processus de marquage des versions, nous allons nous référer à l'historique des commits du dépôt Git. Une nouvelle version d'une application peut se définir par un ensemble de commit entre la précédente version et la tête de la branche principale.
Nos commits doivent respecter une convention. Pour cela, nous allons utiliser [Commits Conventionnels](https://www.conventionalcommits.org/fr/v1.0.0/).
@@ -36,7 +36,7 @@ Une fois que nos commits respectent la nomenclature défini par Commits Conventi
## semantic-release
-semantic-release va automatiser ce processus de marquage d'une version d'un logiciel.
+semantic-release va automatiser ce processus de marquage d'une version d'une application.
Cela nécessite quelques configurations.
@@ -62,13 +62,16 @@ Enfin, la branche de référence en `main` dans notre cas.
Dans le fichier `.gitlab-ci.yml`, ajoutons une tâche pour générer le prochain numéro de version.
```yaml
+stage:
+ - release
+
release:
image: dockerhub.ftven.net/node:lts
stage: release
variables:
GITLAB_TOKEN: ${RELEASE_TOKEN}
before_script:
- - npm install semantic-release@"^23.0.8" @semantic-release/gitlab@"^13.0.4" conventional-changelog-conventionalcommits@"^7.0.2"
+ - npm install semantic-release @semantic-release/gitlab conventional-changelog-conventionalcommits
script:
- npx semantic-release
rules:
@@ -76,3 +79,20 @@ release:
when: manual
```
+
Prévisualiser le contenu de la prochaine version
+Ajoutez l'option --dry-run afin de prévisualiser le contenu de la prochaine version
+
+
+Le jeton `RELEASE_TOKEN` est créé en suivant la documentation suivante https://docs.gitlab.com/ee/user/project/settings/project_access_tokens.html
+
+Lors de la prochaine exécution du pipeline Gitlab CI, une tâche `release` va apparaître. Elle sera en attente d'une action utilisateur. Une fois que l'utilisateur a validé, la nouvelle version est créé et publié dans Gitlab (voir documentation : https://docs.gitlab.com/ee/user/project/releases/).
+
+Félicitation, vous avez automatiser la création d'une version de votre application. Prenez une boisson chaude pour vous détendre.
+
+## Références
+
+- https://semver.org/lang/fr/
+- https://www.conventionalcommits.org/fr/v1.0.0/
+- https://github.com/semantic-release/semantic-release
+- https://docs.gitlab.com/ee/user/project/settings/project_access_tokens.html
+- https://docs.gitlab.com/ee/user/project/releases/
From abb2b84b2902454f22b69f00a52e6bea2d140d45 Mon Sep 17 00:00:00 2001
From: "Thierry T." <1940947+lepiaf@users.noreply.github.com>
Date: Wed, 13 Nov 2024 11:58:57 +0100
Subject: [PATCH 03/14] Add files via upload
---
.../Astronautes qui font la fete.jpg | Bin 0 -> 705782 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 _assets/articles/2024-11-19-semantic-release/Astronautes qui font la fete.jpg
diff --git a/_assets/articles/2024-11-19-semantic-release/Astronautes qui font la fete.jpg b/_assets/articles/2024-11-19-semantic-release/Astronautes qui font la fete.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e1930894241c9299a7a519fdeee9726142078993
GIT binary patch
literal 705782
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