Communitygithub.com

Moep90/kit-outils-pour-kapitan

Kit d'outils pour agent IA dédié à Kapitan : un serveur MCP, des compétences et des règles permettant aux agents de codage LLM d'inspecter, compiler et différencier les projets Kapitan en toute sécurité.

Qu'est-ce que kit-outils-pour-kapitan ?

Ce kit d'outils pour agent IA (MCP server, compétences, règles) permet à un assistant de codage LLM (comme Claude Code, Cursor ou Codex) d'interagir en toute sécurité avec des projets Kapitan. Il expose des capacités clés : inspection de l'inventaire, compilation de cibles, comparaison des rendus (`diff`), et validation de la configuration. Le serveur MCP agit comme une couche de contrôle, empêchant les modifications non autorisées des fichiers compilés tout en offrant une visibilité complète sur l'état du projet. L'agent peut ainsi exécuter des tâches courantes comme la mise à jour de chart Helm, l'ajout de nouvelle cible ou la résolution de conflits de compilation, le tout via des appels structurés. Le kit est conçu pour fonctionner avec Kapitan 0.34 à 0.36 et Helm 3.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Moep90/agent-toolkit-for-kapitan

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Rendu des charts Helm avec Kapitan

Kapitan effectue le rendu des charts Helm nativement avec input_type: helm. Vous déclarez le chart comme une dépendance (Kapitan le récupère) et une entrée de compilation (Kapitan le template avec vos valeurs). Les manifestes rendus atterrissent dans compiled/ ; vous ne vendez jamais le chart ni n'exécutez helm vous-même.

Deux moitiés vivent sous un seul bloc parameters.<app>, référencées par des auto-liens ${<app>:key} afin qu'une valeur ne soit écrite qu'une seule fois.

Structure

parameters:
  cert-manager:
    chart_name: cert-manager
    chart_version: "v1.4.0"
    chart_dir: system/sources/charts/${cert-manager:chart_name}
    application_version: "v1.4.0"
    namespace: ${namespace}
    helm_values:
      installCRDs: true
      prometheus:
        enabled: true
  kapitan:
    dependencies:
      - type: helm
        output_path: ${cert-manager:chart_dir}
        source: https://charts.jetstack.io/
        version: ${cert-manager:chart_version}
        chart_name: ${cert-manager:chart_name}
    compile:
      - input_type: helm
        input_paths:
          - ${cert-manager:chart_dir}
        output_path: .
        helm_params:
          namespace: ${cert-manager:namespace}
          release_name: ${cert-manager:chart_name}
        helm_values: ${cert-manager:helm_values}

Les deux moitiés

  • Dépendance (type: helm) récupère le chart depuis source à la version spécifiée dans output_path. Elle ne s'exécute que lorsque la récupération est activée, donc la première compilation d'une cible nécessite une récupération ; les compilations suivantes réutilisent le chart déjà récupéré.
  • Compilation (input_type: helm) template le chart récupéré. helm_params.release_name et helm_params.namespace sont les indicateurs de helm template ; helm_values est le document de valeurs passé au chart.

Contrat clé

chart_name, chart_version, namespace et helm_values sont les valeurs que vous définissez ; tout le reste les référence avec ${<app>:...}. Assurez-vous que chart_dir pointe vers l'endroit où la dépendance récupère le chart, sinon l'entrée de compilation templatera un répertoire vide et n'émettra rien.

Certains inventaires (notamment ceux utilisant omegaconf) encapsulent tout ce bloc dans un résolveur personnalisé afin qu'une seule ligne se développe en entrées de dépendance et de compilation, ce qui rend les charts duplicables. Le contrat sous-jacent reste les deux moitiés ci-dessus ; voir kapitan-omegaconf-resolvers pour ce mécanisme de réutilisation.

Après modification

Compilez et différenciez (kapitan_compile_diff) pour examiner les manifestes rendus. Un changement de chart est une modification de chart_version accompagnée d'une nouvelle récupération, jamais une édition manuelle de compiled/.

Validé avec

Kapitan 0.34 à 0.36 avec Helm 3.

Skills associés