Helm 部署#

1
2
3
4
5
6
7
8

# 添加仓库
helm repo add k8s-mcp https://mahmut-Abi.github.io/cloud-native-mcp-server

# 更新仓库
helm repo update

# 搜索 Chart
helm search repo k8s-mcp

1
2
3
4
5
6
7
8

# 安装
helm install cloud-native-mcp-server k8s-mcp/cloud-native-mcp-server

# 升级
helm upgrade cloud-native-mcp-server k8s-mcp/cloud-native-mcp-server

# 卸载
helm uninstall cloud-native-mcp-server

1
2
3
4

# 安装到指定命名空间
helm install cloud-native-mcp-server k8s-mcp/cloud-native-mcp-server \
  --namespace monitoring \
  --create-namespace

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

replicaCount: 2

image:
  repository: mahmutabi/cloud-native-mcp-server
  tag: latest
  pullPolicy: IfNotPresent

service:
  type: ClusterIP
  port: 8080

ingress:
  enabled: true
  annotations:
    cert-manager.io/cluster-issuer: "letsencrypt-prod"
  hosts:
    - host: k8s-mcp.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: k8s-mcp-tls
      hosts:
        - k8s-mcp.example.com

resources:
  requests:
    memory: "256Mi"
    cpu: "250m"
  limits:
    memory: "512Mi"
    cpu: "500m"

autoscaling:
  enabled: true
  minReplicas: 2
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80
  targetMemoryUtilizationPercentage: 80

config:
  server:
    mode: "sse"
    addr: "0.0.0.0:8080"
  logging:
    level: "info"
    format: "json"
  kubernetes:
    kubeconfig: ""
  grafana:
    enabled: true
    url: "http://grafana:3000"
    apiKey: "${GRAFANA_API_KEY}"
  prometheus:
    enabled: true
    address: "http://prometheus:9090"
  auth:
    enabled: true
    mode: "apikey"
    apiKey: "${MCP_AUTH_API_KEY}"

rbac:
  create: true
  rules:
  - apiGroups: ["*"]
    resources: ["*"]
    verbs: ["get", "list", "watch", "describe"]

serviceAccount:
  create: true
  name: ""

nodeSelector: {}

tolerations: []

affinity: {}

1
2
3
4

helm install cloud-native-mcp-server k8s-mcp/cloud-native-mcp-server \
  -f values.yaml \
  --namespace monitoring \
  --create-namespace

1
2
3
4
5

image:
  repository: mahmutabi/cloud-native-mcp-server
  tag: "v1.0.0"
  pullPolicy: IfNotPresent
  pullSecrets: []

1
2
3
4
5
6
7
8

replicaCount: 3

autoscaling:
  enabled: true
  minReplicas: 3
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80
  targetMemoryUtilizationPercentage: 80

1
2
3
4
5
6
7

resources:
  requests:
    memory: "512Mi"
    cpu: "500m"
  limits:
    memory: "1Gi"
    cpu: "1000m"

1
2
3
4
5
6
7

service:
  type: ClusterIP
  port: 8080
  annotations:
    prometheus.io/scrape: "true"
    prometheus.io/port: "8080"
    prometheus.io/path: "/metrics"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

ingress:
  enabled: true
  className: "nginx"
  annotations:
    cert-manager.io/cluster-issuer: "letsencrypt-prod"
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
  hosts:
    - host: k8s-mcp.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: k8s-mcp-tls
      hosts:
        - k8s-mcp.example.com

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

config:
  server:
    mode: "sse"
    addr: "0.0.0.0:8080"
  logging:
    level: "info"
    format: "json"
  kubernetes:
    kubeconfig: ""
  # ... 其他服务配置

1
2
3
4
5
6

secrets:
  create: true
  mcpApiKey: "your-api-key"
  grafanaApiKey: "your-grafana-key"
  # 或者使用现有 Secret
  existingSecret: "mcp-secrets"

1
2
3
4
5
6
7
8
9

rbac:
  create: true
  rules:
  - apiGroups: [""]
    resources: ["pods", "services", "configmaps", "secrets"]
    verbs: ["get", "list", "watch"]
  - apiGroups: ["apps"]
    resources: ["deployments", "replicasets"]
    verbs: ["get", "list", "watch"]

1
2
3
4

serviceAccount:
  create: true
  name: "cloud-native-mcp-server"
  annotations: {}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

nodeSelector:
  node.kubernetes.io/instance-type: "m5.large"

tolerations:
  - key: "workload"
    operator: "Equal"
    value: "monitoring"
    effect: "NoSchedule"

affinity:
  podAntiAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
    - labelSelector:
        matchExpressions:
        - key: app
          operator: In
          values:
          - cloud-native-mcp-server
      topologyKey: "kubernetes.io/hostname"

1
2
3

configMap:
  create: false
  name: "mcp-config"

1
2
3

secret:
  create: false
  name: "mcp-secrets"

1
2
3
4
5
6
7
8

env:
  - name: CUSTOM_VAR
    value: "custom-value"
  - name: SECRET_VAR
    valueFrom:
      secretKeyRef:
        name: mcp-secrets
        key: secret-var

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

volumes:
  - name: kubeconfig
    configMap:
      name: kubeconfig
      optional: true

volumeMounts:
  - name: kubeconfig
    mountPath: /root/.kube
    readOnly: true

1
2
3
4
5

podMonitor:
  enabled: true
  interval: 30s
  scrapeTimeout: 10s
  namespace: monitoring

1
2
3
4
5

serviceMonitor:
  enabled: true
  interval: 30s
  scrapeTimeout: 10s
  namespace: monitoring

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

helm status cloud-native-mcp-server -n monitoring

# 查看历史版本
helm history cloud-native-mcp-server -n monitoring

# 获取 Values
helm get values cloud-native-mcp-server -n monitoring

# 获取所有信息
helm get all cloud-native-mcp-server -n monitoring

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# Dry run
helm install cloud-native-mcp-server k8s-mcp/cloud-native-mcp-server \
  -f values.yaml \
  --namespace monitoring \
  --dry-run \
  --debug

# 渲染模板
helm template cloud-native-mcp-server k8s-mcp/cloud-native-mcp-server \
  -f values.yaml \
  --namespace monitoring

1
2
3
4
5
6
7
8

# 查看历史
helm history cloud-native-mcp-server -n monitoring

# 回滚到上一个版本
helm rollback cloud-native-mcp-server -n monitoring

# 回滚到特定版本
helm rollback cloud-native-mcp-server 2 -n monitoring