Kubeblocks中ApeCloud MySQL代理集群创建状态异常问题分析

问题现象

在使用Kubeblocks部署ApeCloud MySQL代理集群时，发现集群状态一直停留在"Creating"状态，无法正常完成创建。具体表现为：

1. 虽然所有Pod（包括etcd和MySQL实例）都已正常运行且READY状态正常
2. 集群组件(Component)中wescale-ctrl组件状态缺失
3. 描述wescale-ctrl组件时没有显示任何事件信息

环境信息

• Kubernetes版本：v1.31.1-aliyun.1
• KubeBlocks版本：1.0.0-beta.17
• kbcli版本：1.0.0-beta.6

技术分析

集群架构理解

ApeCloud MySQL代理集群架构包含多个组件：

1. MySQL组件：实际的数据存储节点，通常配置为3个副本
2. etcd组件：用于存储集群元数据和状态信息
3. wescale-ctrl组件：负责集群的自动扩展控制
4. wescale组件：代理层组件

问题根源

从现象分析，问题可能出在wescale-ctrl组件的部署和状态检测上。该组件未能正确报告其状态，导致KubeBlocks控制器无法确认整个集群是否已就绪。

解决方案验证

经过验证，使用最新版本的addons可以解决此问题。以下是经过验证可用的集群配置示例：

apiVersion: apps.kubeblocks.io/v1
kind: Cluster
metadata:
  name: acmysql-cluster
  namespace: default
  annotations:
    kubeblocks.io/extra-env: '{"KB_PROXY_ENABLED":"on","ETCDCTL_API": "3"}'
spec:
  terminationPolicy: Delete
  clusterDef: apecloud-mysql
  topology: apecloud-mysql-proxy-etcd
  componentSpecs:
    - name: mysql
      disableExporter: false
      replicas: 3
      resources:
        limits:
          cpu: "0.5"
          memory: "0.5Gi"
        requests:
          cpu: "0.5"
          memory: "0.5Gi"
      volumeClaimTemplates:
        - name: data
          spec:
            accessModes:
              - ReadWriteOnce
            resources:
              requests:
                storage: 20Gi
    - name: wescale-ctrl
      volumeClaimTemplates:
        - name: data
          spec:
            storageClassName: ""
            accessModes:
              - ReadWriteOnce
            resources:
              requests:
                storage: 20Gi
      replicas: 1
      resources:
        limits:
          cpu: 500m
          memory: 128Mi
    - name: wescale
      replicas: 1
      resources:
        requests:
          cpu: "0.5"
          memory: 500Mi
        limits:
          cpu: "0.5"
          memory: 500Mi
    - name: etcd
      volumeClaimTemplates:
        - name: data
          spec:
            storageClassName: ""
            accessModes:
              - ReadWriteOnce
            resources:
              requests:
                storage: 20Gi
      replicas: 3
      resources:
        requests:
          cpu: 500m
          memory: 500Mi
        limits:
          cpu: 500m
          memory: 500Mi

最佳实践建议

1. 版本兼容性：确保使用最新版本的KubeBlocks和相关addons组件
2. 资源分配：为wescale-ctrl组件分配足够的资源，特别是内存资源
3. 状态监控：部署后应检查所有组件的状态，而不仅仅是Pod状态
4. 日志收集：当遇到类似问题时，应收集所有相关组件的日志进行分析

总结

在KubeBlocks中部署ApeCloud MySQL代理集群时，确保所有组件都能正确报告其状态是关键。遇到集群状态卡在"Creating"的情况时，应优先检查wescale相关组件的状态和日志。使用最新版本的addons通常可以解决此类兼容性问题。