Fixes #85: Write an ADR-010 about the infrastructure

adr/010-infrastructure.fr-ca.md

@@ -0,0 +1,189 @@
+# ADR-010 : Infrastructure
+
+## Résumé Exécutif
+
+Cette section fournit un bref résumé de la décision prise, en soulignant les
+points principaux afin que le lecteur puisse comprendre l'essentiel sans avoir
+à lire l'ensemble du document.
+
+## Contexte
+
+Notre équipe fait face à des défis en matière de déploiement de solutions, notamment dans le choix des fournisseurs de cloud. Historiquement, nous utilisions Google Cloud Run et Azure App Service. Cependant, en raison de l'absence de compte Google Cloud et des restrictions d'accès sur Azure, nous nous retrouvons à basculer d'un compte à l'autre, entraînant d'importants temps d'arrêt pour nos applications.
+
+De plus, la création manuelle de tous les services sur les fournisseurs de cloud via le ClickOps s'est avérée fastidieuse. En ce qui concerne la sécurité, nous utilisons actuellement un Key Vault dans Azure pour récupérer manuellement les valeurs des variables d'environnement, mais cela ne constitue pas une solution optimale pour la gestion des secrets.
+
+Le scalling de nos applications n'est pas actuellement une priorité, car nous avons une visibilité fixe sur le nombre d'utilisateurs. Cependant, nous n'avons pas encore mis en oeuvre de solution de scaling. 
+
+En ce qui concerne le monitoring et la télémétrie, nous n'avons actuellement rien en place en dehors des outils fournis par les fournisseurs de cloud. Nous reconnaissons la nécessité d'améliorer ces aspects pour une gestion plus efficace de nos applications.
+
+Bref, de nombreuses tâches sont actuellement effectuées manuellement. Bien que nous disposions de github workflow pour déployer des images Docker, la gestion des déploiements sur différents fournisseurs de cloud n'est pas automatisée. En cas d'erreur en production, aucune solution ne permet aux développeurs de résoudre rapidement le problème
+
+Voici quelle que cas d'utilisations qui on été discuter qu'on voudrait gérer:
+
+- Gérer la base de données PostgreSQL (et bientôt PostgreSQL ML) sans recourir au ClickOps ;
+
+- Accroître la redondance des données de manière plus efficace ;
+
+- Déployer, gérer, surveiller et instrumenter les applications au sein de l'organisation ;
+
+- Améliorer la gestion des secrets ;
+
+- Éliminer les silos entre l'équipe de sécurité et l'équipe DevOps au sein de l'organisation ;
+
+- Mettre en place des déploiements sur tous les fournisseurs de cloud en cas de pannes. Cela inclue une persistances des données dans les différents cloud provider ;
+
+- Automatisation du scalling (HPA) ;
+
+- Adopter une stratégie de sauvegarde et de reprise après sinistre ; 
+
+- Créer une documentation facile de lecture et d'adaption pour permettre une transition "shift-left" ;
+
+- Éviter les points de défaillance uniques.
+
+## Décision
+
+Notre solution consistera à déployer des clusters Kubernetes sur différents fournisseurs de cloud. Voici les composants qui seront déployés pour gérer divers cas d'utilisation
+
+- Gestion des secrets: HashiCorp Vault. Cependant, nous prévoyons d'explorer d'autres solutions avant de nous engager pleinement avec Vault  ;
+
+- Gestion des deployments: ArgoCD et Kustomize (nous envisageons également Flux) ;
+
+- Gestion des environnements de developpement: vcluster ;
+
+- Gestion des VM's (au besoins): KubeVirt ;
+
+- Gestion de l'instrumentation des applications: OpenTelemetry et Clickhouse ;
+
+- Gestion du monitoring: Grafana et Prometheus pour collecter des métriques spécifiques aux applications déployées avec Helm ;
+
+- Gestion du load balancing: Ingress NGINX ;
+
+D'autres composants seront ajoutés au besoin.
+
+## Alternatives Considérées
+
+Cette section présente les différentes options ou solutions considérées avant
+d'arriver à la décision finale. Chaque alternative est généralement discutée
+dans une sous-section.
+
+### Mozilla SOPS
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### Contour
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### Kong
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### Traefik
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### HAProxy Ingress
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### Istio Ingress
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### Flux
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### Carvel ytt
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### cdk8s
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### Carvel ytt
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+### kapp-controller
+
+Avantages :
+
+- Aspects positifs de cette alternative.
+
+Inconvénients :
+
+- Aspects négatifs de cette alternative.
+
+## Conséquences
+
+Cette partie décrit les résultats attendus, positifs comme négatifs, de la
+décision. Cela peut inclure son impact sur différentes parties prenantes ou
+toute action qui doit être prise à la suite de la décision.
+
+## Références
+
+Toute documentation, recherche ou données soutenant la décision peuvent être
+citées ici. Cela peut inclure des articles académiques, des articles de blog ou
+des documents internes.

adr/010-infrastruture.en-ca.md

@@ -0,0 +1,63 @@
+# ADR-XXX : Title
+
+## Optional Illustration
+
+This section can contain diagrams, flowcharts, or any visual aids that help in
+understanding the architecture decision. It is optional and should be included
+if it adds value to the document.
+
+## Executive Summary
+
+This section provides a brief summary of the decision being made, outlining the
+main points so that the reader can understand the gist without reading the
+entire document.
+
+## Context
+
+The context section sets the stage and provides background information necessary
+to understand the problem or decision. It might include the scope of the
+decision, stakeholders involved, and current circumstances.
+
+## Decision
+
+This section clearly states the decision that has been made, and may also
+include justification and reasoning.
+
+## Alternatives Considered
+
+This section presents the different options or solutions considered before
+arriving at the final decision. Each alternative is usually discussed in a
+subsection.
+
+### Alternative 1
+
+Pros:
+
+- Positive aspects of this alternative.
+
+Cons:
+
+- Negative aspects of this alternative.
+
+### Alternative 2
+
+Pros:
+
+- Positive aspects of this alternative.
+
+Cons:
+
+- Negative aspects of this alternative.
+
+Add as many alternatives as necessary.
+
+## Consequences
+
+This part outlines the expected outcomes, both positive and negative, of the
+decision. This may include its impact on different stakeholders, or any actions
+that need to be taken as a result of the decision.
+
+## References
+
+Any documentation, research, or data that support the decision can be cited
+here. This can include academic papers, blog posts, or internal documents.