Merge pull request #464 from ansforge/tmc/poc-gatling

Feat : tmc initial setup

Author: Clemsazert

tools/tmc/.env.template

@@ -0,0 +1,7 @@
+KEY_PASSPHRASE=
+CERTIFICATE_PATH=
+TRUST_STORE_PASSWORD=
+TRUST_STORE_PATH=
+RABBITMQ_HOST=
+RABBITMQ_PORT=
+EXCHANGE_NAME=

tools/tmc/.gitignore

@@ -0,0 +1,3 @@
+.gradle
+build
+.env

tools/tmc/README.md

@@ -0,0 +1,67 @@
+# Hub Santé load testing
+
+## Description
+
+TODO :
+
+- [] Lister les scénarios implémentés et avec quelle charge
+
+## Utilisation en local
+
+### Prérequis
+
+- Java 21
+- Droits de connexion :
+  - Disposer du certificat client associé à l'utilisateur des tmc
+  - Génerer un trustStore avec la root CA IGC Santé (TEST/PROD en fonction de l'environnement visé)
+
+### Environnement
+
+- Dans `tools/tmc`, uppliquer le fichier `.env.template` en le renommant `.env` :
+
+```bash
+cp .env.template .env
+```
+
+- Remplir le fichier `.env` en référençant
+  - les paths **absolus** du certificat et du truststore (respectivement `CERTIFICATE_PATH` et `TRUST_STORE_PASSWORD`)
+  - les mots de passe associés (respectivement `KEY_PASSPHRASE` et `TRUST_STORE_PASSWORD`)
+  - le host du server RabbitMQ visé (`RABBITMQ_HOST`)
+  - le port du server RabbitMQ visé (`RABBITMQ_PORT`)
+  - le nom de l'exchange visé pour la publication des messages sur le server RabbitMQ (`EXCHANGE_NAME`)
+
+Note : l'exposition des variables d'environnement via fichier `.env` est géré en dev local par la librairie [dotenv-java](https://github.com/cdimascio/dotenv-java).
+
+### Lancement des tests
+
+Pour lancer la simulation `PublishExample` utiliser la commande :
+
+```bash
+./gradlew gatlingRun --simulation example.PublishExample
+```
+
+## Architecture technique
+
+Sur Confluence sont disponibles [l'expression de besoin](https://ans-esante.atlassian.net/wiki/spaces/HUB/pages/1256292572/Expression+de+besoin) et la [stratégie technique](https://ans-esante.atlassian.net/wiki/spaces/HUB/pages/1257865233/Strat+gie+Technique) retenue pour l'implémentation des tests de montée en charge sur le Hub Santé.
+
+Le document de stratégie technique contient notamment un ADR sur le choix de Gatling par rapport aux autres offres disponibles sur le marché.
+
+Note : la version de Gatling utilisée ici est la `3.11.3`. Il en est ainsi car il s'agit la version la plus récente utilisable avec le plugin [gatling-amqp](https://github.com/galax-io/gatling-amqp-plugin).
+
+## Archive : Gatling default readme
+
+Gatling plugin for Gradle - Java demo project
+
+=============================================
+
+A simple showcase of a Gradle project using the Gatling plugin for Gradle. Refer to the plugin documentation
+[on the Gatling website](https://gatling.io/docs/current/extensions/gradle_plugin/) for usage.
+
+This project includes:
+
+- Gradle Wrapper, so you don't need to install Gradle (a JDK must be installed and $JAVA_HOME configured)
+- minimal `build.gradle` leveraging Gradle wrapper
+- latest version of `io.gatling.gradle` plugin applied
+- sample [Simulation](https://gatling.io/docs/gatling/reference/current/general/concepts/#simulation) class,
+demonstrating sufficient Gatling functionality
+- proper source file layout

tools/tmc/build.gradle

@@ -0,0 +1,21 @@
+plugins {
+    id 'java'
+    // The following line allows to load io.gatling.gradle plugin and directly apply it
+    id 'io.gatling.gradle' version '3.11.3'
+}
+
+dependencies {
+    gatling("org.galaxio:gatling-amqp-plugin_2.13:0.14.0")
+    gatling("io.github.cdimascio:dotenv-java:3.2.0")
+}
+
+gatling {
+  enterprise {
+    // Enterprise Cloud (https://cloud.gatling.io/) configuration reference: https://gatling.io/docs/gatling/reference/current/extensions/gradle_plugin/#working-with-gatling-enterprise-cloud
+    // Enterprise Self-Hosted configuration reference: https://gatling.io/docs/gatling/reference/current/extensions/gradle_plugin/#working-with-gatling-enterprise-self-hosted
+  }
+}
+
+repositories {
+  mavenCentral()
+}

tools/tmc/gradle/wrapper/gradle-wrapper.jar

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists