基于KubeSphere部署MySQL单机：从基础到实践的完整指南

作者：php是最好的2025.09.17 11:04浏览量：11

简介：本文详细介绍了在KubeSphere容器平台上部署MySQL单机数据库的全流程，涵盖环境准备、资源定义、持久化存储配置、安全策略及高可用优化等关键环节，为开发者提供可落地的技术方案。

基于KubeSphere部署MySQL单机：从基础到实践的完整指南

一、KubeSphere与MySQL单机部署的适用场景

KubeSphere作为企业级开源容器平台，在数据库部署领域展现出独特优势。MySQL单机模式适用于开发测试环境、小型业务系统或需要快速验证的场景，其核心价值在于：

  1. 资源隔离：通过Kubernetes命名空间实现与业务应用的逻辑隔离
  2. 弹性扩展：结合HPA可实现垂直扩展（虽单机模式扩展性有限，但为后续集群化奠定基础）
  3. 运维简化：利用KubeSphere可视化界面完成生命周期管理，降低操作复杂度

典型应用场景包括：

二、部署前环境准备

2.1 集群资源要求

资源类型 最低配置 推荐配置
CPU 2核 4核
内存 4GB 8GB
存储 20GB 50GB

2.2 存储类配置

推荐使用支持动态供应的StorageClass，例如：

  1. apiVersion: storage.k8s.io/v1
  2. kind: StorageClass
  3. metadata:
  4.   name: mysql-sc
  5. provisioner: kubernetes.io/aws-ebs  # 根据实际云提供商调整
  6. parameters:
  7.   type: gp2
  8.   fsType: ext4

2.3 网络策略规划

需确保3306端口在集群内可访问，建议配置NetworkPolicy：

  1. apiVersion: networking.k8s.io/v1
  2. kind: NetworkPolicy
  3. metadata:
  4.   name: mysql-network-policy
  5. spec:
  6.   podSelector:
  7.     matchLabels:
  8.       app: mysql
  9.   policyTypes:
  10.   - Ingress
  11.   ingress:
  12.   - from:
  13.     - podSelector:
  14.         matchLabels:
  15.           app: backend
  16.     ports:
  17.     - protocol: TCP
  18.       port: 3306

三、核心部署步骤

3.1 通过KubeSphere工作台创建

  1. 进入「应用管理」→「部署新应用」
  2. 选择「自定义应用」→「通过YAML创建」
  3. 粘贴完整部署清单（见3.2节）

3.2 完整YAML配置示例

  1. apiVersion: apps/v1
  2. kind: Deployment
  3. metadata:
  4.   name: mysql-standalone
  5.   labels:
  6.     app: mysql
  7. spec:
  8.   replicas: 1
  9.   selector:
  10.     matchLabels:
  11.       app: mysql
  12.   template:
  13.     metadata:
  14.       labels:
  15.         app: mysql
  16.     spec:
  17.       containers:
  18.       - name: mysql
  19.         image: mysql:8.0.33
  20.         env:
  21.         - name: MYSQL_ROOT_PASSWORD
  22.           valueFrom:
  23.             secretKeyRef:
  24.               name: mysql-secret
  25.               key: password
  26.         - name: MYSQL_DATABASE
  27.           value: appdb
  28.         ports:
  29.         - containerPort: 3306
  30.         volumeMounts:
  31.         - name: mysql-persistent-storage
  32.           mountPath: /var/lib/mysql
  33.       volumes:
  34.       - name: mysql-persistent-storage
  35.         persistentVolumeClaim:
  36.           claimName: mysql-pvc
  37. ---
  38. apiVersion: v1
  39. kind: PersistentVolumeClaim
  40. metadata:
  41.   name: mysql-pvc
  42. spec:
  43.   accessModes:
  44.     - ReadWriteOnce
  45.   resources:
  46.     requests:
  47.       storage: 20Gi
  48.   storageClassName: mysql-sc
  49. ---
  50. apiVersion: v1
  51. kind: Secret
  52. metadata:
  53.   name: mysql-secret
  54. type: Opaque
  55. data:
  56.   password: <base64-encoded-password>  # echo -n 'yourpassword' | base64

3.3 服务暴露配置

  1. apiVersion: v1
  2. kind: Service
  3. metadata:
  4.   name: mysql-service
  5. spec:
  6.   selector:
  7.     app: mysql
  8.   ports:
  9.     - protocol: TCP
  10.       port: 3306
  11.       targetPort: 3306
  12.   type: ClusterIP  # 开发环境可用NodePort

四、关键配置优化

4.1 性能调优参数

在/etc/mysql/conf.d/custom.cnf中添加：

  1. [mysqld]
  2. innodb_buffer_pool_size = 1G  # 建议设为可用内存的50-70%
  3. innodb_log_file_size = 256M
  4. innodb_flush_log_at_trx_commit = 1
  5. sync_binlog = 1

4.2 备份策略实现

创建CronJob进行定期备份：

  1. apiVersion: batch/v1beta1
  2. kind: CronJob
  3. metadata:
  4.   name: mysql-backup
  5. spec:
  6.   schedule: "0 2 * * *"
  7.   jobTemplate:
  8.     spec:
  9.       template:
  10.         spec:
  11.           containers:
  12.           - name: backup
  13.             image: mysql:8.0
  14.             command: ["/bin/sh", "-c"]
  15.             args:
  16.               - mysqldump -h mysql-service -uroot -p$MYSQL_ROOT_PASSWORD appdb > /backup/appdb-$(date +\%Y\%m\%d).sql
  17.             envFrom:
  18.             - secretRef:
  19.                 name: mysql-secret
  20.             volumeMounts:
  21.             - name: backup-storage
  22.               mountPath: /backup
  23.           volumes:
  24.           - name: backup-storage
  25.             persistentVolumeClaim:
  26.               claimName: backup-pvc
  27.           restartPolicy: OnFailure

五、运维管理最佳实践

5.1 监控指标配置

通过Prometheus监控关键指标：

  1. - job_name: 'mysql'
  2.   static_configs:
  3.   - targets: ['mysql-service:9104']  # 使用mysqld-exporter
  4.   metrics_path: '/metrics'

重点关注指标：

  • mysql_global_status_threads_connected
  • mysql_global_status_innodb_buffer_pool_read_requests
  • mysql_global_status_questions

5.2 故障排查流程

  1. 连接失败：

    • 检查Service端点：kubectl get endpoints mysql-service
    • 验证网络策略：kubectl describe networkpolicy mysql-network-policy

  2. 存储异常：

    • 检查PVC状态：kubectl get pvc mysql-pvc
    • 查看PV详情：kubectl describe pv <pv-name>

  3. 性能瓶颈：

    • 使用kubectl top pod mysql-standalone查看资源使用
    • 检查慢查询日志：kubectl exec mysql-standalone -- grep slow /var/log/mysql/mysql-slow.log

六、安全加固方案

6.1 访问控制策略

  1. 创建专用ServiceAccount：

    1. apiVersion: v1
    2. kind: ServiceAccount
    3. metadata:
    4. name: mysql-sa

  2. 配置RBAC权限：
    ```yaml
    apiVersion: rbac.authorization.k8s.io/v1
    kind: Role
    metadata:
    name: mysql-role
    rules:

  • apiGroups: [“”]
    resources: [“pods”, “endpoints”]
    verbs: [“get”, “list”]

apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: mysql-rolebinding
subjects:

  • kind: ServiceAccount
    name: mysql-sa
    roleRef:
    kind: Role
    name: mysql-role
    apiGroup: rbac.authorization.k8s.io
    ```

6.2 数据加密方案

  1. 启用TLS连接：
    ```yaml

    在Deployment中添加

    volumeMounts:
  • name: mysql-certs
    mountPath: /etc/mysql/ssl
    volumes:
  • name: mysql-certs
    secret:
    secretName: mysql-certs
    ```
  1. 创建自签名证书：
    1. openssl req -newkey rsa:2048 -nodes -keyout server-key.pem -out server-req.pem -subj "/CN=mysql-service"
    2. openssl rsa -in server-key.pem -out server-key.pem
    3. openssl x509 -req -in server-req.pem -days 365 -signkey server-key.pem -out server-cert.pem
    4. kubectl create secret generic mysql-certs --from-file=server-cert.pem --from-file=server-key.pem

七、升级与迁移策略

7.1 版本升级流程

  1. 创建新版本Deployment（如mysql:8.0.34）
  2. 执行数据迁移：
    1. kubectl exec -it old-mysql -- mysqldump -uroot -p appdb > dump.sql
    2. kubectl exec -it new-mysql -- mysql -uroot -p appdb < dump.sql
  3. 使用KubeSphere的「金丝雀发布」功能逐步切换流量

7.2 跨集群迁移

  1. 使用Velero备份应用：
    1. velero backup create mysql-backup --include-namespaces default
  2. 在目标集群恢复：
    1. velero restore create --from-backup mysql-backup

八、常见问题解决方案

8.1 密码泄露处理

  1. 立即旋转密码：
    1. kubectl create secret generic mysql-secret --dry-run=client -o yaml \
    2. --from-literal=password=newpassword | kubectl apply -f -
  2. 重启Deployment应用新密码

8.2 存储空间不足

  1. 扩展PVC容量（需StorageClass支持）：
    1. kubectl patch pvc mysql-pvc --type='json' -p='[{"op": "replace", "path": "/spec/resources/requests/storage", "value":"30Gi"}]'
  2. 清理无用数据：
    1. -- 在MySQL客户端执行
    2. OPTIMIZE TABLE large_table;

通过以上系统化的部署方案，开发者可以在KubeSphere平台上快速构建稳定可靠的MySQL单机环境。实际生产环境中，建议结合具体业务需求进行参数调优，并定期进行容灾演练以确保系统高可用性。对于关键业务系统，可考虑从单机模式逐步升级为主从复制或集群架构，KubeSphere提供的可视化运维界面将极大简化这一演进过程。

最热文章