Doc debug prod

.gitlab-ci.yml

@@ -16,7 +16,7 @@ variables:
     value: "postgres:15.10-alpine"
     description: "Image de la base de données"
   PROJECT_VERSION:
-    value: "2.4.1"
+    value: "2.4.2"
     description: "Version du projet à déployer"
   SERVER_ENV_INT:
     value: "int-rapportnav-appli01"

backend/build.gradle.kts

@@ -2,7 +2,7 @@ import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
 import java.lang.System.getenv
 
 group = "fr.gouv.dgampa"
-version = "2.4.1"
+version = "2.4.2"
 description = "RapportNav"
 
 val kotlinVersion by extra("1.9.24")

backend/src/main/resources/graphql/mission.graphqls

@@ -10,7 +10,6 @@ type Mutation {
   patchMissionEnv(mission: MissionEnvInput!): Mission!
   updateMissionGeneralInfo(info: MissionGeneralInfoInput!): MissionGeneralInfo!
   updateMissionService(service: MissionServiceInput!): Service!
-  create(input: CreateOrUpdateMissionInput!): Mission!
 }
 
 

docs/engineering/_sidebar.md

@@ -1,12 +1,15 @@
 * [Retour](/)
 * [Tech homepage](engineering/index)
-* [Stack](engineering/stack/index)
-** [Frontend](engineering/stack/frontend)
-** [Backend](engineering/stack/backend)
-** [Database](engineering/stack/database)
-** [Infrastructure](engineering/stack/infra)
 * [Concepts principaux](engineering/concepts/index)
 ** [Gestion des utilisateurs](engineering/concepts/auth)
 ** [L'objet Mission](engineering/concepts/missions-and-actions)
 ** [Complétude des missions](engineering/concepts/mission-completion)
 ** [Gestion des dates](engineering/concepts/dates)
+* [Stack](engineering/stack/index)
+  ** [Frontend](engineering/stack/frontend)
+  ** [Backend](engineering/stack/backend)
+  ** [Database](engineering/stack/database)
+  ** [Infrastructure](engineering/stack/infra)
+* [Operations](engineering/operations/index)
+  ** [Monitoring](engineering/operations/monitoring)
+  ** [Troubleshooting](engineering/operations/troubleshooting)

docs/engineering/operations/index.md

@@ -0,0 +1,5 @@
+# Operations
+
+Ici vous trouverez comment gérer les opérations en intégration et productions, notamment autour des problématiques de :
+- monitoring
+- troubleshooting

docs/engineering/operations/monitoring.md

@@ -0,0 +1,31 @@
+# Monitoring
+
+TODO
+- sentry
+- monitoring physique des servers
+
+
+## Portainer
+
+Portainer permet de visualiser les logs et autres stats pour différents containers, images Docker.
+
+Pour l'instant, il faut demander à chaque fois l'accès à la DSI car les droits sont overwritten à chaque déploiement.
+
+Portainer n'est accessible que via le RIE à l'url suivante: http://portainer.csam.e2.rie.gouv.fr
+
+Les logs du backend et de la database sont visibles dans les logs du container
+
+![portainer.png](../images/portainer.png)
+
+## Sonarqube
+
+Sonarqube permet de mesurer la qualité du code selon plusieurs critères comme la couverture de tests, duplication de code, code smells, maintenabilité...
+
+A chaque push sur main sur le Gitlab de la DSI, une analyse est lancée et les résultats sont updatés automatiquement.
+
+Il est possible de voir le projet en suivant l'url: http://sonarqube.dsi.damgm.i2/projects
+
+En fonction du résultat de la Quality Gate, un déploiement peut être bloqué.
+
+![sonarqube.png](../images/sonarqube.png)
+

docs/engineering/operations/troubleshooting.md

@@ -0,0 +1,18 @@
+# Troubleshooting
+
+## J'ai déployé mais l'appli ne se lance pas
+
+**Symptome**: après un déploiement, en se rendant sur RapportNav, rien ne se lance, rien n'est affiché.
+
+**Cause**: l'appli a été buildée et containerizée mais la commande pour lancer le backend fail.
+
+**Que faire**:
+- Envoyer un mail à la DSI pour avoir accès à Portainer en leur précisant l'environnement et la version de l'appli (refaire pour chaque déploiement, ce n'est pas automatique pour l'instant)
+- Une fois l'accès à portainer, sélectionnez:
+  - l'environnement
+  - puis le container backend
+  - enfin, investiguez les logs
+
+![portainer.png](../images/portainer.png)
+
+

frontend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "private": true,
   "type": "module",
   "engines": {