---
title: "Kodama : documentation opérateur et développeur"
description: "Installer et utiliser Kodama, l’usine logicielle API-first pour le CI/CD, le développement agentique, les processus métier et l’automatisation événementielle."
canonical_url: https://optimi.com/fr/docs/kodama
md_url: https://optimi.com/fr/docs/kodama.md
language: fr
alternates:
  - lang: en
    url: https://optimi.com/en/docs/kodama
    md_url: https://optimi.com/en/docs/kodama.md
---

# Kodama

Kodama est une **usine logicielle API-first, native Kubernetes**. Elle relie les
besoins métier aux espaces de travail Git, pipelines durables, agents, preuves
de revue et livraisons contrôlées. Le même modèle d’exécution sert au CI/CD
classique, au développement assisté par agents et à l’automatisation métier.

Kodama est publié sur **[github.com/optimiware/kodama](https://github.com/optimiware/kodama)**
sous licence **Apache-2.0**. Installez le chart Helm dans votre cluster Kubernetes,
puis connectez-vous avec le CLI ou l’API HTTP.

## Choisir un premier cas d’usage

| Cas d’usage | Pipeline type | Éléments conservés par Kodama |
| --- | --- | --- |
| CI/CD classique | Tester un commit, construire une image, approuver et déployer son empreinte | Source, rapports de test, provenance de l’image et historique de livraison |
| Développement agentique | Implémenter une spécification, tester le candidat et demander une revue humaine | Instructions et profil figés, commit candidat, preuves de conformité et décision |
| Processus métier | Valider une demande, préparer une proposition, approuver et appliquer | Référence métier, rapport de validation, décision et reçu de résultat |
| Signaux métier | Recevoir un événement, évaluer son importance et déclencher une réponse autorisée | Identité de l’événement, analyse, exécution dédupliquée et preuves d’action |

Le **[guide développeur](/fr/docs/kodama/guide-developpeur)** propose un exemple
pour chacun de ces cas. Un pipeline peut n’utiliser que des conteneurs ; un
agent intervient lorsque le raisonnement d’un modèle ou l’usage d’outils apporte
une valeur supplémentaire.

## Parcours documentaire

| Page | Objectif |
| --- | --- |
| **Vue d’ensemble** — cette page | Comprendre le produit et choisir un usage |
| **[Concepts](/fr/docs/kodama/concepts)** | Comprendre tenants, travail, espaces Git, exécutions, tentatives, preuves et validations |
| **[Architecture](/fr/docs/kodama/architecture)** | Comprendre le plan de contrôle, l’exécution Kubernetes et les services durables |
| **[Premiers pas](/fr/docs/kodama/premiers-pas)** | Installer les charts des backends puis Kodama, authentifier le CLI et lancer un pipeline |
| **[Guide développeur](/fr/docs/kodama/guide-developpeur)** | Écrire des pipelines, intégrer les signaux métier et utiliser l’API de façon fiable |
| **[Exploitation](/fr/docs/kodama/exploitation)** | Configurer autorité et identifiants, observer, mettre à niveau et restaurer |

## Utiliser Kodama

1. **Installer une usine.** Fournissez PostgreSQL, JetStream, stockage objets,
   Git, registre d’images, OIDC et gestion des clés, puis déployez le chart Helm.
2. **Créer un tenant et un projet.** Attribuez des rôles explicites, configurez
   le dépôt et choisissez le namespace d’exécution et les cibles de livraison.
3. **Décrire le travail.** Enregistrez le résultat attendu et ses critères
   d’acceptation. Provisionnez son espace pour préserver la continuité du code.
4. **Enregistrer un pipeline.** Définissez un graphe immuable d’étapes conteneur,
   agent et validation humaine. Figez les images par empreinte.
5. **Lancer une exécution.** Sélectionnez définition, révision de contenu, commit
   source et entrées typées. Fournissez une clé d’idempotence.
6. **Examiner le résultat.** Suivez l’exécution, récupérez les preuves, prenez
   les décisions explicites et promouvez le candidat identifié vers sa cible.

Une exécution survit à la déconnexion du client. Une validation peut attendre
une personne sans garder de conteneur actif. La reprise du travail lance une
autre exécution en conservant code, preuves et décisions précédents.

## Ce que vous maîtrisez

Votre organisation contrôle le cluster Kubernetes, les dépôts, les fournisseurs
de modèles, les outils enregistrés et les identifiants de livraison. La
politique d’installation fixe les droits maximaux ; le projet les restreint.
Un profil d’agent ne peut s’accorder d’autres modèles, outils ou permissions runtime.

Kodama répartit les responsabilités :

- **Opérateurs :** backends, identités, politique runtime, chiffrement et reprise.
- **Administrateurs :** tenants, projets, appartenances et identifiants.
- **Ingénieurs et analystes :** travail, pipelines et critères d’acceptation.
- **Reviewers :** décision sur des preuves et un sujet précisément identifiés.

Les installations autonomes utilisent OIDC et les appartenances Kodama. Dans
une intégration Optimi Platform, Platform conserve l’autorité transverse des
tenants, les droits d’usage et l’accès commercial ; Kodama fournit la couche
de livraison logicielle.

## Interfaces

- **CLI :** authentification interactive, gestion du travail et des espaces,
  enregistrement de pipelines, observation, validations et déploiements.
- **API HTTP :** opérations publiques versionnées sous `/api/v1`, accès limité
  au périmètre, versions, clés d’idempotence et flux d’événements reprenables.
- **Git :** édition ordinaire et publication des commits par les développeurs.
- **Intégrations d’agents :** passerelle de modèles et proxy MCP, bornés par
  les politiques de l’installation et du projet.
- **Intégrations métier :** clients API authentifiés et webhooks configurés
  reliant signaux externes, exécutions et notifications de livraison.

Commencez par **[l’installation avec Helm](/fr/docs/kodama/premiers-pas)**.