在Kubernetes中部署11notes/docker-kMS服务器的完整指南

11notes/docker-kms是一个开源的KMS(密钥管理服务)服务器容器化解决方案，可以用于Windows和Office产品的授权服务。本文将详细介绍如何在Kubernetes集群中正确部署和配置这个服务。

核心组件与架构

该KMS解决方案包含两个主要容器组件：

1. kms-server：处理实际的KMS授权请求，监听1688端口
2. kms-gui：提供Web管理界面，监听8080端口

两个容器共享同一个持久化存储卷，用于保存配置和状态数据。

Kubernetes部署配置

持久化存储配置

首先需要创建PVC(Persistent Volume Claim)来确保数据持久化：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: kms-pvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: longhorn  # 根据集群实际情况调整
  resources:
    requests:
      storage: 1Gi

部署配置

部署配置需要注意以下几点：

1. 两个容器共享同一个PVC
2. 正确设置时区环境变量
3. 确保端口映射正确

apiVersion: apps/v1
kind: Deployment
metadata:
  name: kms
spec:
  selector:
    matchLabels:
      app: kms
  template:
    spec:
      volumes:
      - name: kms-var
        persistentVolumeClaim:
          claimName: kms-pvc
      containers:
      - name: kms
        image: 11notes/kms:465f4d1
        volumeMounts:
        - name: kms-var
          mountPath: /var/kms
        ports:
        - containerPort: 1688
        env:
        - name: TZ
          value: Asia/Shanghai  # 根据实际时区调整
      - name: kms-gui
        image: 11notes/kms-gui:stable
        volumeMounts:
        - name: kms-var
          mountPath: /var/kms
        ports:
        - containerPort: 8080
        env:
        - name: TZ
          value: Asia/Shanghai

服务暴露

需要创建两个Service来暴露服务：

1. Web管理界面服务（ClusterIP类型）：

apiVersion: v1
kind: Service
metadata:
  name: kms-webui-svc
spec:
  type: ClusterIP
  ports:
  - port: 8080
    targetPort: 8080

2. KMS授权服务（LoadBalancer类型）：

apiVersion: v1
kind: Service
metadata:
  name: kms-svc
spec:
  type: LoadBalancer
  loadBalancerIP: 192.168.1.100  # 根据实际环境调整
  ports:
  - port: 1688
    targetPort: 1688

可选：Ingress配置

如果需要通过域名访问Web管理界面，可以配置Ingress：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: kms-ingress
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt
spec:
  ingressClassName: nginx
  tls:
  - hosts:
    - kms.yourdomain.com
    secretName: kms-tls
  rules:
    - host: kms.yourdomain.com
      http:
        paths:
        - path: /
          pathType: Prefix
          backend:
            service:
              name: kms-webui-svc
              port:
                number: 8080

常见问题解决

1. 容器不断重启：

   • 确保PVC已正确创建并挂载到/var/kms路径
   • 检查PVC的storageClass是否适用于你的集群

2. 无法授权产品：

   • 确认KMS服务的1688端口已正确暴露
   • 检查防火墙规则是否允许1688端口的流量

3. 时区不正确：

   • 确保TZ环境变量设置为正确的时区值

最佳实践建议

1. 资源限制：为容器设置适当的资源限制，防止资源占用过高
2. 监控：配置Prometheus监控或健康检查端点
3. 备份：定期备份PVC中的数据
4. 安全：通过NetworkPolicy限制对KMS服务的访问

通过以上配置，你可以在Kubernetes集群中稳定运行11notes/docker-kms服务，为Windows和Office产品提供授权服务。