Token导航 LogoToken导航TokenDH.com
MCP K8s Demo logo
运维云端未说明官方级别未说明来源级核验

MCP K8s Demo

MCP Server

一个演示Kubernetes中配置路径不匹配导致服务故障的场景,用于展示跨层故障排查技术。

工具数

0

提示词数

0

GitHub Stars

0

资源数

0
配置管理Kubernetes容器化Devops

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

VelmiraPetkova

提供方

VelmiraPetkova

最后核验

2026/5/17 20:22

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

MCP+Kubernetes故障排除演示

场景

基于Go的订单服务部署到Kubernetes。一切 外表 健康:

  • Pod状态: Running
  • 活体探针: passing
  • 准备就绪探针: passing

但每一个请求 /api/orders 回报 500内部服务器错误.

臭虫

应用程序希望其数据库配置文件位于:

/app/config/db-credentials.json

Kubernetes清单将秘密挂载在:

/etc/secrets/db-credentials.json

这种路径不匹配对Kubernetes是不可见的——pod启动,健康检查 通过(它们不接触配置),pod保持不变 Running 国家。

只有当实际流量到达业务端点时,才会出现故障。

为什么这是一个好的演示Bug

  1. 这很现实 --应用程序期望与K8s清单之间的路径不匹配

这种情况经常发生,尤其是当不同的团队拥有应用程序和infra时。

  1. 它是跨层的 --你无法通过查看来找到根本原因 *仅* 这

日志, *仅* K8s事件,或 *仅* 部署规范。你需要这三个。

  1. 这很微妙kubectl get pods 显示 Running 1/1 Ready问题是

在用户开始抱怨之前,标准监控是不可见的。

本地运行(无K8s)

# The service starts fine — no crash
cd app && go run main.go

# Health check passes
curl http://localhost:8080/healthz

# But orders fail (no config file at /app/config/)
curl http://localhost:8080/api/orders

# Run the traffic simulator
../scripts/simulate-traffic.sh

在Kubernetes上运行

# Create namespace
kubectl create namespace demo

# Build image (if using local cluster like kind/minikube)
docker build -t order-service:latest ./app

# Deploy
kubectl apply -f k8s/deployment.yaml

# Watch — pods will show Running, Ready 1/1
kubectl get pods -n demo -w

# Port-forward and test
kubectl port-forward -n demo svc/order-service 8080:80
./scripts/simulate-traffic.sh

MCP揭示了什么

当MCP上下文聚合器从该场景中收集数据时,它提供:

信号它显示了什么
Pod状态正在运行,准备就绪——具有误导性
日志CONFIG ERROR: failed to read config from /app/config/...
部署规范volumeMounts.mountPath: /etc/secrets
事件没有警告——K8s没有发现任何问题

AI代理交叉引用这些信号:

  • 日志显示:预期路径为 /app/config/
  • 规范说:安装在 /etc/secrets/
  • 结论:路径不匹配→ 修复volumeMount

这是一种跨层推理,没有一种工具可以开箱即用。

目录标签

目录标签

配置管理Kubernetes容器化DevopsPython本地部署故障排查

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

none

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP