2. 首页 > KubeSphere教程 > 正文

KubeSphere教程FG020-KubeSphere StatefulSet有状态应用部署实战

教程整理：风哥教程  |  更新时间：2026-03-13  |  教程分类：KubeSphere教程  |  文档学习：8

本教程详细介绍KubeSphere中StatefulSet有状态应用的部署实战，包括基础概念、生产环境规划、具体实施方案和实战案例。风哥教程参考KubeSphere官方文档KubeSphere容器平台使用指南、KubeSphere应用管理等相关内容。

目录大纲

Part01-基础概念与理论知识

1.1 StatefulSet核心概念

StatefulSet是Kubernetes中用于管理有状态应用的控制器，它为Pod提供了以下特性： 风哥提示：

  • 稳定的网络标识：每个Pod都有一个唯一的主机名，格式为<statefulset-name>-<ordinal>
  • 稳定的存储：每个Pod都有自己的持久化存储卷，即使Pod重建，存储卷也会保持不变
  • 有序的部署和扩缩容：按照顺序创建和删除Pod，确保应用的状态一致性
  • 有序的滚动更新：按照顺序更新Pod，确保应用的可用性

1.2 StatefulSet与Deployment的区别

StatefulSet与Deployment的主要区别在于：

  • Deployment适用于无状态应用，Pod之间没有顺序和依赖关系
  • StatefulSet适用于有状态应用，Pod之间有顺序和依赖关系
  • Deployment的Pod使用随机生成的主机名，而StatefulSet的Pod使用固定的主机名
  • Deployment的Pod共享存储卷，而StatefulSet的每个Pod有自己的存储卷

1.3 StatefulSet适用场景

StatefulSet适用于以下场景：

  • 数据库集群：如MySQL、PostgreSQL、MongoDB等
  • 分布式系统：如Kafka、Zookeeper、Elasticsearch等
  • 有状态的微服务：需要保持会话状态的应用
  • 需要稳定网络标识的应用：如需要固定主机名的应用

Part02-生产环境规划与建议

2.1 存储规划

在部署StatefulSet有状态应用时，存储规划是非常重要的。以下是一些建议：

  • 使用持久化存储：选择合适的存储类型，如NFS、Ceph、云存储等
  • 配置存储类：创建适合应用的StorageClass，设置合适的参数
  • 存储容量规划：根据应用需求和数据增长趋势，合理规划存储容量
  • 存储性能：根据应用对IOPS和延迟的要求，选择合适的存储方案

2.2 网络规划

网络规划对于StatefulSet有状态应用也非常重要：

  • 使用稳定的网络标识：确保Pod有固定的主机名和IP地址
  • 配置Headless Service：为StatefulSet创建Headless Service，用于服务发现
  • 网络策略：配置合适的网络策略，确保应用之间的通信安全
  • DNS配置：确保集群DNS正常工作，Pod可以通过主机名访问

2.3 资源规划

资源规划也是部署StatefulSet有状态应用的关键：

  • CPU和内存：根据应用需求，合理配置Pod的资源请求和限制
  • 节点选择：使用节点亲和性和反亲和性，将Pod部署在合适的节点上
  • 副本数：根据应用的高可用性需求，设置合适的副本数
  • 升级策略：选择合适的更新策略，确保应用的可用性

Part03-生产环境项目实施方案

3.1 StatefulSet配置要点

在KubeSphere中部署StatefulSet有状态应用时，需要注意以下配置要点： 学习交流加群风哥微信: itpux-com

  • 设置serviceName：指定Headless Service的名称
  • 配置podManagementPolicy：选择OrderedReady或Parallel
  • 设置updateStrategy：选择RollingUpdate或OnDelete
  • 配置revisionHistoryLimit：设置保留的历史版本数

    • 3.2 存储卷配置

    存储卷配置是StatefulSet的核心：

    • 使用volumeClaimTemplates：为每个Pod创建独立的PVC
    • 指定storageClassName：选择合适的StorageClass
    • 设置资源请求：指定存储容量
    • 配置访问模式：选择ReadWriteOnce、ReadOnlyMany或ReadWriteMany

    3.3 网络配置

    网络配置对于StatefulSet也非常重要：

    • 创建Headless Service：用于服务发现和DNS解析
    • 配置端口：设置应用的服务端口
    • 设置标签：用于Pod选择器
    • 配置网络策略：限制Pod之间的通信

    Part04-生产案例与实战讲解

    4.1 MySQL集群部署实战

    下面我们来实战部署一个MySQL集群： 学习交流加群风哥QQ113257174

    # 创建MySQL配置 ConfigMap
    kubectl create configmap mysql-config –from-file=my.cnf -n fgedu
    configmap/mysql-config created
    # 创建MySQL StatefulSet
    cat > mysql-statefulset.yaml << EOF
    apiVersion: apps/v1
    kind: StatefulSet
    metadata:
    name: mysql
    namespace: fgedu
    spec:
    serviceName: mysql
    replicas: 3
    selector:
    matchLabels:
    app: mysql
    template:
    metadata:
    labels:
    app: mysql
    spec:
    containers:
    – name: mysql
    image: mysql:5.7
    env:
    ，
    – name: MYSQL_ROOT_PASSWORD
    value: “fgedu123”
    ports:
    – containerPort: 3306
    volumeMounts:
    – name: mysql-data
    mountPath: /var/lib/mysql
    – name: mysql-config
    mountPath: /etc/mysql/conf.d
    volumes:
    – name: mysql-config
    configMap:
    name: mysql-config
    volumeClaimTemplates:
    – metadata:
    name: mysql-data
    spec:
    storageClassName: nfs-storage
    accessModes: [“ReadWriteOnce”]
    resources:
    requests:
    storage: 20Gi
    EOF
    kubectl apply -f mysql-statefulset.yaml
    statefulset.apps/mysql created
    # 创建Headless Service
    cat > mysql-service.yaml << EOF
    apiVersion: v1
    kind: Service
    metadata:
    name: mysql
    namespace: fgedu
    spec:
    clusterIP: None
    selector:
    app: mysql
    ports:
    – port: 3306
    targetPort: 3306
    EOF
    kubectl apply -f mysql-service.yaml
    service/mysql created
    # 检查StatefulSet状态
    kubectl get statefulset mysql -n fgedu
    NAME READY AGE
    mysql 3/3 5m
    # 检查Pod状态
    kubectl get pods -n fgedu -l app=mysql
    NAME READY STATUS RESTARTS AGE
    mysql-0 1/1 Running 0 5m
    mysql-1 1/1 Running 0 4m
    mysql-2 1/1 Running 0 3m

    4.2 Redis集群部署实战

    下面我们来实战部署一个Redis集群： 更多视频教程www.fgedu.net.cn

    # 创建Redis StatefulSet
    cat > redis-statefulset.yaml << EOF
    apiVersion: apps/v1
    kind: StatefulSet
    metadata:
    name: redis
    namespace: fgedu
    spec:
    serviceName: redis
    replicas: 3
    selector:
    matchLabels:
    app: redis
    template:
    metadata:
    labels:
    app: redis
    spec:
    containers:
    – name: redis
    image: redis:6.0
    command:
    – redis-server
    – –cluster-enabled yes
    – –cluster-config-file /data/nodes.conf
    – –cluster-node-timeout 5000
    – –appendonly yes
    ports:
    – containerPort: 6379
    – containerPort: 16379
    volumeMounts:
    – name: redis-data
    mountPath: /data
    volumeClaimTemplates:
    – metadata:
    name: redis-data
    spec:
    storageClassName: nfs-storage
    accessModes: [“ReadWriteOnce”]
    resources:
    requests:
    storage: 10Gi
    EOF
    kubectl apply -f redis-statefulset.yaml
    statefulset.apps/redis created
    # 创建Headless Service
    cat > redis-service.yaml << EOF
    apiVersion: v1
    kind: Service
    metadata:
    name: redis
    namespace: fgedu
    ，
    spec:
    clusterIP: None
    selector:
    app: redis
    ports:
    – port: 6379
    targetPort: 6379
    – port: 16379
    targetPort: 16379
    EOF
    kubectl apply -f redis-service.yaml
    service/redis created
    # 初始化Redis集群
    kubectl exec -it redis-0 -n fgedu — redis-cli –cluster create –cluster-replicas 0 $(kubectl get pods -n fgedu -l app=redis -o jsonpath='{range .items[*]}{.status.podIP}:6379 {end}’)
    >>> Performing hash slots allocation on 3 nodes…
    Master[0] -> Slots 0-5460
    Master[1] -> Slots 5461-10922
    Master[2] -> Slots 10923-16383
    M: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 10.233.64.10:6379
    slots:[0-5460] (5461 slots) master
    M: b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3 10.233.64.11:6379
    slots:[5461-10922] (5462 slots) master
    M: c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 10.233.64.12:6379
    slots:[10923-16383] (5461 slots) master
    Can I set the above configuration? (type ‘yes’ to accept): yes
    >>> Nodes configuration updated
    >>> Assign a different config epoch to each node
    >>> Sending CLUSTER MEET messages to join the cluster
    Waiting for the cluster to join
    …
    >>> Checking cluster health
    [OK] All nodes agree about slots configuration.
    >>> Check for open slots…
    >>> Check slots coverage…
    [OK] All 16384 slots covered.

    4.3 状态管理与扩缩容操作

    下面我们来演示StatefulSet的扩缩容操作： 更多学习教程公众号风哥教程itpux_com

    # 扩展StatefulSet副本数
    kubectl scale statefulset mysql -n fgedu –replicas=5
    statefulset.apps/mysql scaled
    # 检查扩缩容状态
    kubectl get pods -n fgedu -l app=mysql
    NAME READY STATUS RESTARTS AGE
    mysql-0 1/1 Running 0 10m
    mysql-1 1/1 Running 0 9m
    mysql-2 1/1 Running 0 8m
    mysql-3 1/1 Running 0 1m
    mysql-4 1/1 Running 0 30s
    # 缩容StatefulSet副本数
    kubectl scale statefulset mysql -n fgedu –replicas=3
    statefulset.apps/mysql scaled
    # 检查缩容状态
    kubectl get pods -n fgedu -l app=mysql
    NAME READY STATUS RESTARTS AGE
    mysql-0 1/1 Running 0 15m
    mysql-1 1/1 Running 0 14m
    mysql-2 1/1 Running 0 13m

    Part05-风哥经验总结与分享

    5.1 常见问题与解决方案

    在部署StatefulSet有状态应用时，常见的问题及解决方案： from K8S+DB视频:www.itpux.com

    • 存储卷挂载失败：检查StorageClass配置是否正确，确保存储后端可用
    • 网络标识不稳定：确保Headless Service配置正确，检查DNS解析是否正常
    • 扩缩容失败：检查资源是否充足，查看Pod事件日志
    • 滚动更新失败：检查更新策略配置，确保应用支持滚动更新

    5.2 最佳实践建议

    StatefulSet有状态应用部署的最佳实践：

    • 使用Headless Service：确保Pod有稳定的网络标识
    • 配置合适的存储类：根据应用需求选择合适的存储方案
    • 设置资源限制：避免资源竞争影响应用性能
    • 使用节点亲和性：将Pod部署在合适的节点上
    • 配置健康检查：确保应用的可用性

    5.3 性能优化技巧

    StatefulSet有状态应用的性能优化技巧：

    • 使用本地存储：对于对延迟敏感的应用，使用本地存储可以提高性能
    • 配置合适的存储参数：根据应用需求调整存储参数，如IOPS限制
    • 优化网络配置：使用高速网络，配置合适的网络策略
    • 合理设置副本数：根据应用需求和资源情况，设置合适的副本数
    • 使用批量操作：对于大规模StatefulSet，使用批量操作可以提高效率

    在部署StatefulSet有状态应用时，一定要确保存储后端的可靠性和性能，这是应用稳定运行的关键。

    本文由风哥教程整理发布,仅用于学习测试使用,转载注明出处:http://www.fgedu.net.cn/10327.html

    相关推荐

    联系我们

    在线咨询：点击这里给我发消息

    微信号：itpux-com

    工作日：9:30-18:30，节假日休息