> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Vocabulaire de la plateforme Kaeyros

> Glossaire d'entrée en matière avec les mots maison de Kaeyros Analytics et les termes de l'écosystème Kubernetes, ArgoCD et Helm.

Avant de naviguer dans la documentation technique de Kaeyros Analytics, vous devez connaître le vocabulaire spécifique de la plateforme. Ce glossaire rassemble les termes maison que l'équipe utilise au quotidien, ainsi que les concepts de l'écosystème Kubernetes, ArgoCD et Helm qui structurent notre infrastructure mutualisée.

## Les mots de notre plateforme

Chaque terme ci-dessous est un concept que vous rencontrerez dans les conversations, les fichiers de configuration et les outils de supervision.

> **antid**
>
> Nom historique du premier chart Helm interne de Kaeyros. Il correspond à un `Deployment` Kubernetes classique et sert encore de suffixe dans les noms de pods générés par les charts plus récents. Lorsque vous voyez `antid` dans un nom de ressource, cela indique une origine liée à ce chart historique.

> **rollout / rollout-v2**
>
> Charts Helm dédiés à Argo Rollouts, qui permettent les déploiements de type canary (progressifs). La version `rollout-v2` est celle recommandée aujourd'hui pour les nouvelles applications. Elle offre un contrôle fin sur la montée en charge des nouvelles versions avant basculement complet du trafic.

> **values**
>
> Fichier de valeurs Helm (`values.yaml` ou fichier spécifique) qui personnalise un chart pour un environnement donné. Par exemple, `values/biolab/api-prod.yaml` contient la configuration de l'API Biolab en production. Ce fichier est référencé par l'objet `Application` ArgoCD.

> **Application**
>
> Objet ArgoCD qui lie trois éléments : un chart Helm, un fichier de valeurs (`values`) et un namespace Kubernetes. C'est l'unité de déploiement dans notre plateforme. L'Application surveille le dépôt Git et synchronise automatiquement le cluster.

> **app-of-apps**
>
> Motif de conception ArgoCD où une Application racine, nommée `production`, surveille le répertoire `apps/` et crée automatiquement toutes les autres Applications. Cela permet de gérer l'ensemble de la plateforme depuis un seul point de contrôle dans Git.

> **data-precompute**
>
> Traitements de précalcul des données, exécutés dans le namespace dédié `crons`. Ces traitements préparent des données agrégées ou transformées avant consommation par les applications ou les tableaux de bord. Les manifestes correspondants appliquent des règles d'affinité strictes pour l'ordonnancement des pods.

> **dash, back, front, api**
>
> Conventions de découpage des applications. Chaque produit est généralement découpé en plusieurs composants : `front` (interface utilisateur), `back` (logique métier), `api` (exposition de données), `dash` (tableau de bord analytique). Ces suffixes apparaissent dans les noms d'Application et les fichiers de valeurs.

> **Tenant**
>
> Client final d'un produit multi-clients. Par exemple, Booking Hospital est un produit dont les tenants sont Cerisiers, HGOPED, Laquintinie et Saint-Cyr. Chaque tenant dispose de ses propres données et parfois de sa propre configuration, tout en partageant l'infrastructure technique sous-jacente.

> **sandbox, canary, passive**
>
> Variantes d'environnement en complément des classiques `dev`, `stg` et `prod`. Le `sandbox` sert à l'expérimentation isolée, le `canary` à la validation progressive des nouvelles versions, et le `passive` à la réplication inactive pour tests de reprise ou basculement d'urgence.

## Les mots de l'écosystème

Ces termes décrivent les briques technologiques qui constituent notre infrastructure mutualisée. Ils sont utilisés dans les interfaces de supervision, les journaux et les discussions techniques.

| Terme | En une phrase |
| - | - |
| **Kubernetes** | Orchestrateur de conteneurs qui gère le cycle de vie des applications sur le cluster. |
| **RKE2** | Distribution Kubernetes de Rancher, utilisée sur nos 4 nœuds de production à Helsinki. |
| **Nœud** | Machine physique ou virtuelle (serveur Hetzner) sur laquelle s'exécutent les pods du cluster. |
| **Pod** | Plus petite unité déployable dans Kubernetes, contenant un ou plusieurs conteneurs liés. |
| **Namespace** | Zone d'isolation logique au sein du cluster, chaque client ou projet dispose du sien. |
| **Deployment / StatefulSet / Rollout** | Objets Kubernetes gérant les pods : `Deployment` pour les applicatifs stateless, `StatefulSet` pour les applicatifs avec données persistantes, `Rollout` pour les déploiements canary via Argo Rollouts. |
| **Service** | Ressource Kubernetes exposant un ensemble de pods via une adresse IP stable et un nom DNS interne. |
| **Ingress** | Règle de routage HTTP/HTTPS qui associe un nom de domaine à un Service interne du cluster. |
| **PVC / PV** | `PersistentVolumeClaim` demande un stockage persistant ; `PersistentVolume` est le stockage effectivement provisionné par Longhorn. |
| **Helm** | Gestionnaire de packages Kubernetes qui paramètre et déploie des applications via des charts et des fichiers de valeurs. |
| **ArgoCD** | Outil de livraison continue basé sur GitOps, qui synchronise automatiquement l'état du cluster avec le contenu du dépôt Git. |
| **Argo Rollouts** | Extension Kubernetes qui remplace le `Deployment` natif pour offrir des stratégies de déploiement avancées (canary, bleu/vert). |
| **GitOps** | Pratique où l'état souhaité de l'infrastructure est versionné dans Git et appliqué automatiquement par des outils comme ArgoCD. |
| **Opérateur** | Logiciel qui automatise le cycle de vie d'une ressource complexe dans Kubernetes, comme l'opérateur Zalando pour PostgreSQL. |

> [!TIP]
>
> Si vous êtes déjà familier avec ces termes, vous pouvez passer directement à la [vue d'ensemble de la plateforme](https://infra-docs.kaeyros.org/comprendre/vue-d-ensemble.md) pour comprendre comment ils s'assemblent dans notre contexte.

Pour toute question ou suggestion d'amélioration de ce glossaire, contactez l'équipe DevOps à [devops@kaeyros-analytics.com](mailto:devops@kaeyros-analytics.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.