Skip to main content
Glama
deenesjakoruzh
felipeassis10

gitops-drift-agent

by felipeassis10
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

GitOps ドリフト修復エージェント

License: Apache 2.0 Node.js Version TypeScript

Kubernetes クラスターと GitOps リポジトリに接続し、未承認の状態ドリフトを特定し、安全な修復戦略を生成し、自動化された API パッチまたはプルリクエストを実行する、本番グレードの自律エージェント。

目次

Related MCP server: kube-lint-mcp

概要

GitOps ドリフト修復エージェントは、Kubernetes リソースのライブ状態を宣言された GitOps ソース・オブ・トゥルースと継続的に監視する、自律的かつポリシー駆動型のプラットフォームです。ドリフトが検出されると、エージェントは適用可能な修復ポリシーを評価し、最小限の JSON パッチ操作を計算し、Kubernetes API を介して直接適用するか、GitOps リポジトリに対してプルリクエストを開きます。すべての操作には完全な監査証跡が付随します。

基本原則

  • 最小限の影響範囲: パッチは可能な限り小さな差分として計算され、リソース全体の置き換えは行いません

  • ポリシー優先: すべての修復アクションは、リスク階層を持つ設定可能かつバージョン管理されたポリシーによってゲートキープされます

  • 不変の監査ログ: すべての決定、検出、変更は暗号化コンテキストとともに記録されます

  • GitOps ネイティブ: エージェント自体が GitOps によって管理され、リポジトリに PR を発行します

  • MCP 対応: すべての機能を MCP ツールとして公開し、LLM エージェントとの統合を可能にします

アーキテクチャ

┌─────────────────────────────────────────────────────────────────────┐
│                    GitOps Drift Remediation Agent                   │
│                                                                     │
│  ┌─────────────┐    ┌──────────────┐    ┌────────────────────────┐ │
│  │  AST Differ │───▶│ Policy Engine│───▶│    Patch Engine        │ │
│  │             │    │              │    │                        │ │
│  │ • Deep diff │    │ • Risk tiers │    │ • JSON Patch RFC 6902  │ │
│  │ • Field     │    │ • Allow/deny │    │ • K8s API apply        │ │
│  │   tracking  │    │ • Dry-run    │    │ • PR generation        │ │
│  │ • Severity  │    │ • Approvals  │    │ • Rollback support     │ │
│  └─────────────┘    └──────────────┘    └────────────────────────┘ │
│         │                  │                       │                │
│         └──────────────────┴───────────────────────┘                │
│                            │                                        │
│                   ┌────────▼────────┐                               │
│                   │  Audit Logger   │                               │
│                   │                 │                               │
│                   │ • Structured    │                               │
│                   │   JSON logs     │                               │
│                   │ • Event chain   │                               │
│                   │ • Pino backend  │                               │
│                   └─────────────────┘                               │
│                                                                     │
│  ┌──────────────────────────────────────────────────────────────┐  │
│  │                      MCP Server                              │  │
│  │  detect_drift │ list_policies │ remediate │ get_audit_trail  │  │
│  └──────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────┘
         │                                          │
         ▼                                          ▼
  ┌─────────────┐                          ┌───────────────┐
  │  Kubernetes │                          │  GitOps Repo  │
  │  Cluster(s) │                          │  (Git/GitHub) │
  └─────────────┘                          └───────────────┘

機能

機能

説明

ドリフト検出

ライブと望ましい Kubernetes リソース状態の深い AST ベースの差分比較

リスク分類

フィールドパスごとの自動重大度スコアリング（重大 / 高 / 中 / 低）

ポリシーエンジン

許可/拒否ルール、ドライラン、承認ゲートを備えた宣言的かつバージョン管理されたポリシー

パッチエンジン

K8s サーバーサイド適用をサポートする RFC 6902 JSON パッチ計算

GitOps PR

ドリフト差分と修復根拠を含む自動プルリクエスト生成

監査証跡

完全な決定チェーンを備えた不変の構造化監査ログ

MCP サーバー

AI エージェントオーケストレーション用にすべてのエージェント機能を MCP ツールとして公開

CLI

対話型および自動運用のためのフル機能 CLI

インストール

前提条件

  • Node.js >= 20.0.0

  • ターゲットクラスターへのアクセスが設定された kubectl

  • GitOps リポジトリ用の Git 認証情報（PR モード用）

ソースからのインストール

git clone https://github.com/your-org/gitops-drift-remediation-agent.git
cd gitops-drift-remediation-agent
npm install
npm run build
npm link   # optional: makes `drift-agent` available globally

設定

すべての設定は環境変数または設定ファイルを介して渡されます。

環境変数

変数

必須

デフォルト

説明

KUBECONFIG

いいえ

~/.kube/config

kubeconfig ファイルへのパス

KUBECONTEXT

いいえ

current-context

使用する Kubernetes コンテキスト

GITOPS_REPO_URL

いいえ

—

PR モード用の GitOps リポジトリ URL

GITOPS_BRANCH

いいえ

main

PR のターゲットブランチ

GITOPS_TOKEN

いいえ

—

Git プロバイダートークン（GitHub/GitLab）

POLICY_CONFIG_PATH

いいえ

./policies.yaml

修復ポリシー設定へのパス

AUDIT_LOG_PATH

いいえ

./audit.log

監査ログ出力パス

AUDIT_LOG_LEVEL

いいえ

info

ログレベル（debug/info/warn/error）

DRY_RUN

いいえ

false

グローバルドライランモード

MCP_PORT

いいえ

3000

MCP サーバー HTTP ポート

NAMESPACE_FILTER

いいえ

*

カンマ区切りの名前空間フィルター

使用方法

CLI コマンド

# Detect drift across all namespaces
drift-agent detect --namespace production --output json

# Detect and auto-remediate with policy gate
drift-agent remediate --namespace production --policy strict --dry-run

# List active policies
drift-agent policy list

# Show audit trail for a resource
drift-agent audit --resource deployments/my-app --namespace production

# Start MCP server
drift-agent mcp-server --port 3000

プログラム API

import { AstDiffer } from './src/detector/ast-differ';
import { RemediationPolicy } from './src/policy/remediation-policy';
import { PatchEngine } from './src/remediator/patch-engine';

const differ = new AstDiffer();
const drifts = await differ.detectDrift(liveResource, desiredResource);

const policy = new RemediationPolicy(policyConfig);
const decision = await policy.evaluate(drifts, resourceContext);

if (decision.approved) {
  const engine = new PatchEngine(k8sClient);
  await engine.applyRemediation(decision.patches, resourceRef);
}

MCP サーバー

エージェントは MCP（Model Context Protocol）サーバーを公開し、すべてのエージェント機能を LLM ベースのエージェント（Claude、GPT-4 など）向けのツールとして利用可能にします。

サーバーの起動

drift-agent mcp-server --port 3000
# or
npm run mcp:server

利用可能な MCP ツール

ツール

説明

detect_drift

リソースまたは名前空間のドリフトを検出

list_policies

設定済みのすべての修復ポリシーを一覧表示

evaluate_policy

特定のポリシーに対してドリフトを評価

apply_remediation

計算された修復パッチを適用

get_audit_trail

リソースの監査イベントを取得

generate_pr

ドリフト修復用の GitOps PR を生成

rollback_remediation

以前に適用した修復をロールバック

MCP クライアント設定

{
  "mcpServers": {
    "gitops-drift-agent": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

ポリシーエンジン

ポリシーは宣言的に定義され、修復ライフサイクルのすべての側面を制御します。

ポリシー構造

apiVersion: drift.gitops.io/v1
kind: RemediationPolicy
metadata:
  name: production-strict
spec:
  riskTier: high
  autoRemediate: false
  requireApproval: true
  dryRunFirst: true
  rules:
    - field: "spec.replicas"
      action: restore
      severity: high
    - field: "spec.template.spec.containers[*].image"
      action: block
      severity: critical
  excludeFields:
    - "metadata.annotations['kubectl.kubernetes.io/last-applied-configuration']"
    - "metadata.resourceVersion"
    - "metadata.uid"

監査とテレメトリ

すべてのエージェントアクションは構造化 JSON 形式で記録されます：

{
  "timestamp": "2024-06-01T12:00:00.000Z",
  "eventId": "evt_01J0ABC123",
  "eventType": "DRIFT_DETECTED",
  "severity": "high",
  "resource": {
    "kind": "Deployment",
    "name": "my-app",
    "namespace": "production",
    "apiVersion": "apps/v1"
  },
  "drift": {
    "field": "spec.replicas",
    "desired": 3,
    "live": 1,
    "changeType": "edited"
  },
  "policy": {
    "name": "production-strict",
    "decision": "remediate",
    "riskTier": "high"
  },
  "actor": {
    "agentVersion": "1.0.0",
    "kubeContext": "prod-cluster"
  }
}

開発

# Install dependencies
npm install

# Run in development mode (ts-node)
npm run dev -- detect --namespace default

# Type check only
npm run typecheck

# Lint
npm run lint

# Format
npm run format

# Build
npm run build

テスト

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Run in watch mode
npm run test:watch

テストは tests/ の下に整理され、Jest と ts-jest を使用します。Kubernetes クライアントとファイルシステム操作にはモックが提供されています。

セキュリティに関する考慮事項

  1. 最小権限: エージェントはターゲットリソースに対して get、list、watch、patch の権限のみを必要とし、delete や create は決して必要としません

  2. デフォルトでドライラン: すべてのポリシーティアは、明示的に有効化されるまでデフォルトでドライランになります

  3. 承認ゲート: 高リスクおよび重大リスクの変更には、ポリシーによる明示的な承認が必要です

  4. 監査の不変性: 監査ログは追記専用です。ログのローテーションは外部で処理されます

  5. シークレットのマスキング: シークレットリソースの値は、ログと PR で常に編集されます

  6. kubeconfig の分離: エージェントは kubeconfig を決して変更しません

貢献

CONTRIBUTING.md を参照してください。すべての貢献には以下が必要です：

  • 80% 以上のカバレッジでテストスイートに合格すること

  • 新しい lint 警告がないこと

  • 新しい変更パスに対する監査ログエントリ

  • 新しい修復アクションに対するポリシー評価

ライセンス

Apache 2.0 — LICENSE を参照してください。

This server cannot be installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/felipeassis10/gitops-drift-remediation-agent'

If you have feedback or need assistance with the MCP directory API, please join our Discord server