Communitygithub.com

Moep90/agent-toolkit-for-kapitan

Kapitan용 AI 에이전트 툴킷: LLM 코딩 에이전트가 Kapitan 프로젝트를 안전하게 검사하고, 컴파일하며, diff할 수 있게 해주는 MCP 서버, 에이전트 스킬 및 규칙입니다.

agent-toolkit-for-kapitan란 무엇인가요?

이 툴킷은 LLM 코딩 에이전트(예: Claude Code, Cursor 등)가 Kapitan 프로젝트와 상호작용할 때, 안전성과 생산성을 극대화하도록 설계되었습니다. Kapitan은 Kubernetes 매니페스트를 템플릿화하고 관리하는 도구로, Helm 차트를 기본적으로 렌더링합니다. 이 스킬은 에이전트가 `kapitan compile` 및 `kapitan-compile-diff` 명령을 통해 프로젝트를 검사하고 컴파일하며, 변경 사항을 diff로 검토할 수 있도록 지원합니다. MCP 서버와 사전 정의된 규칙을 활용하여 에이전트가 실수로 `compiled/` 디렉토리를 직접 수정하는 등의 위험한 작업을 방지하고, 차트 버전 업데이트 후 재페치(re-fetch)와 같은 모범 사례를 따르도록 안내합니다. Kapitan 0.34~0.36 및 Helm 3에서 검증되었으며, omegaconf 리졸버와의 통합을 통해 차트를 재사용 가능하게 만드는 고급 패턴도 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Moep90/agent-toolkit-for-kapitan

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Kapitan으로 Helm 차트 렌더링하기

Kapitan은 input_type: helm을 사용하여 Helm 차트를 네이티브로 렌더링합니다. 차트를 종속성(Kapitan이 가져옴)과 컴파일 항목(Kapitan이 사용자 값으로 템플릿화)으로 선언합니다. 렌더링된 매니페스트는 compiled/에 저장됩니다. 차트를 직접 관리하거나 helm을 직접 실행할 필요가 없습니다.

두 부분이 하나의 parameters.<app> 블록 아래에 있으며, ${<app>:key} 셀프 링크로 참조되므로 값은 한 번만 작성됩니다.

구조

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}

두 부분

  • 종속성 (type: helm) : source에서 version의 차트를 가져와 output_path에 저장합니다. 페치가 활성화된 경우에만 실행되므로, 타겟의 첫 번째 컴파일에는 페치가 필요합니다. 이후 컴파일은 가져온 차트를 재사용합니다.
  • 컴파일 (input_type: helm) : 가져온 차트를 템플릿화합니다. helm_params.release_name과 helm_params.namespace는 helm template 플래그이며, helm_values는 차트에 전달되는 값 문서입니다.

핵심 규약

chart_name, chart_version, namespace, helm_values는 사용자가 설정하는 값입니다. 나머지는 모두 ${<app>:...}로 이를 참조합니다. chart_dir이 종속성이 가져오는 위치를 가리키도록 유지해야 합니다. 그렇지 않으면 컴파일 항목이 빈 디렉토리를 템플릿화하여 아무것도 출력하지 않습니다.

일부 인벤토리(특히 omegaconf 기반)는 이 전체 블록을 사용자 정의 리졸버로 감싸서 한 줄로 종속성 및 컴파일 항목을 확장하므로 차트를 복제할 수 있습니다. 기본 규약은 여전히 위의 두 부분이며, 해당 재사용 메커니즘에 대해서는 kapitan-omegaconf-resolvers를 참조하십시오.

편집 후

렌더링된 매니페스트를 검토하려면 컴파일 및 diff(kapitan_compile_diff)를 수행하십시오. 차트 업데이트는 chart_version 변경 후 재페치를 통해 이루어지며, compiled/를 직접 편집하지 않아야 합니다.

검증 환경

Kapitan 0.34~0.36, Helm 3.

관련 스킬