From d40dd560c1ca9cc4ac53b326f72b2a0c822837dd Mon Sep 17 00:00:00 2001 From: Olivier DOSSMANN Date: Tue, 21 Jan 2025 10:07:12 +0100 Subject: [PATCH] chore(content): Change technical specs and complete 'demarche' page --- content/30_specifications_techniques.md | 40 +------------ content/40_demarche.md | 74 +++++++++++++++++++------ 2 files changed, 59 insertions(+), 55 deletions(-) diff --git a/content/30_specifications_techniques.md b/content/30_specifications_techniques.md index 9db58ed..b37654d 100644 --- a/content/30_specifications_techniques.md +++ b/content/30_specifications_techniques.md @@ -6,50 +6,14 @@ TODO: spécifications techniques Mot clé : écosystème DevOps -La réalisation de ce projet va plus loin que la simple mise en place d'une -application dans le Cloud. C'est une nouvelle équipe, dans un nouvel -environnement avec une application inconnue et des savoirs à acquérir. +Blah blah -En pareille situation, c'est tout un **écosystème DevOps** qu'il faut mettre -en place. Ainsi nous commençons par nous organiser pour collaborer sur le +Ainsi nous commençons par nous organiser pour collaborer sur le projet pour répondre aux besoins ; après quoi nous nous tournons vers l'étude de l'application pour continuer sur le choix d'une infrastructure pour accueillir nos services. Finalement nous choisissons aussi des outils autour de l'application pour garantir un certain niveau de service. - -## Organisation - -Gitlab, Slack, SemVer, Git OneFlow, Conventional commit, différents environnements - -### Normes - -* SemVer -* Git OneFlow -* Conventional commit - -### Environnements - -* Développement -* Tests -* Pré-production (appelé « staging ») -* Production - -### Plateforme DevOps - -* couvre les principes DevOps -* Github vs. Gitlab ? -* services utilisés : - * Tickets - * Jalons - * Kanbans -* Base de connaissance collaborative : Wiki sous Gitlab - -### Méthodologie - -* Méthodologie Agile basique -* Compte-rendus journaliers - ## Étude de l'application ### Composants de l'application diff --git a/content/40_demarche.md b/content/40_demarche.md index 2ac7a5e..1440510 100644 --- a/content/40_demarche.md +++ b/content/40_demarche.md @@ -1,29 +1,69 @@ \newpage -# Démarche, outils utilisés et collaboration +# Démarche suivie et opportunité(s) de collaboration TODO: introduction -## Démarche +La réalisation de ce projet va plus loin que la simple mise en place d'une +application dans le Cloud. C'est une nouvelle équipe, dans un nouvel +environnement avec une application inconnue et des savoirs à acquérir. + +En pareille situation, c'est tout un **écosystème DevOps** qu'il faut mettre +en place. + +## Démarche et outils TODO : compléter -## Outils utilisés +Gitlab, Slack, SemVer, Git OneFlow, Conventional commit, différents environnements + +* D'abord une plateforme avec un groupe (gitlab.com/devu42) et un projet principal (`projet`) + base de connaissances (wiki) +* Un domaine devu42.fr pour avoir une adresse courriel (team@devu42.fr) partagée +* Création d'étapes (jalons) progressives : + * Étape 1 : préparation - outils (config. gitlab, projets, wiki, etc.), cahier des charges + * Étape 2 (avec 3) : CI/CD sur le projet principal + * Étape 3 (avec 2) : Infrastructure (Terraform) + * Étape 4 (avec 5) : Données (postgreSQL) + * Étape 5 (avec 4) : Observabilité + * Étape 6 : extras (si on a le temps) +* Compte-rendus réguliers + +### Normes + +* SemVer +* Git OneFlow +* Conventional commit + +### Environnements + +* Développement : chez chaque DEV (Dockerfile + docker-compose du projet lui-même) +* Tests : dans chaque gitlab-runner utilisé, via une CI +* Pré-production (appelé « staging ») : AWS staging +* Production : AWS production + +TODO: donner schéma effectué + +### Plateforme DevOps + +* couvre les principes DevOps +* Github vs. Gitlab ? +* services utilisés : + * Tickets + * Jalons + * Kanbans +* Base de connaissance collaborative : Wiki sous Gitlab + +### Méthodologie + +* Méthodologie Agile basique +* Compte-rendus journaliers +* Jalon pour chaque semaine, avec quelques tickets par étapes + +## Cas d'une collaboration inter-équipe TODO : compléter -## Collaboration +* réunion avec l'équipe Matrix pour échanger sur nos problématiques principales et nos choix actuels +* échange au sujet de la promotion logicielle avec l'équipe Matrix (Maxime) -TODO : compléter - -### Équipe Matrix - -Promotion logicielle - -TODO : compléter - -### Équipe Odoo - -Indépendance dépôts pour répartition tâches/équipes - -TODO : compléter +TODO : expliquer en quelques lignes que ça a été le cas avec l'équipe Odoo de manière bien plus sporadique (irrégulière)