如何在StatefulSet管理的Pod内部获取该StatefulSet的当前副本数

fieldRef是Kubernetes Downward API提供的字段引用能力，仅支持引用当前Pod自身的属性字段，而spec.replicas属于StatefulSet资源的配置，不属于Pod的字段范围，因此会出现字段不支持的报错。

以下是两种生产环境常用的实现方式：

方案1：Pod内调用Kubernetes API实时查询（适配动态扩缩容） #

这种方式可以实时获取最新的副本数，适配StatefulSet动态扩缩容的场景。

操作步骤 #

1. 配置RBAC权限，给Pod授予StatefulSet的查询权限
   创建如下权限配置：

apiVersion: v1
kind: ServiceAccount
metadata:
  name: sts-reader
  namespace: demo
---
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: sts-reader-role
  namespace: demo
rules:
- apiGroups: ["apps"]
  resources: ["statefulsets"]
  verbs: ["get"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: sts-reader-binding
  namespace: demo
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: Role
  name: sts-reader-role
subjects:
- kind: ServiceAccount
  name: sts-reader
  namespace: demo

执行kubectl apply -f rbac.yaml生效。

2. 修改StatefulSet配置，注入必要环境变量并绑定ServiceAccount

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: sample-mariadb
  namespace: demo
spec:
  replicas: 3
  serviceName: "sample-mariadb"
  template:
    spec:
      serviceAccountName: sts-reader
      containers:
      - name: mariadb
        image: mariadb:10.6
        env:
        # 注入Pod所在的命名空间
        - name: POD_NAMESPACE
          valueFrom:
            fieldRef:
              fieldPath: metadata.namespace
        # 注入所属StatefulSet的名称
        - name: STATEFULSET_NAME
          value: "sample-mariadb"

3. 容器内获取副本数
   如果容器内置了kubectl命令，直接执行：

# 获取配置的期望副本数
REPLICAS=$(kubectl get sts $STATEFULSET_NAME -n $POD_NAMESPACE -o jsonpath='{.spec.replicas}')
# 如果要获取实际就绪的副本数，替换为 {.status.readyReplicas} 即可

如果没有内置kubectl，也可以直接调用APIServer接口，使用Pod默认挂载的Service Account凭证即可完成认证查询。

方案2：部署时直接注入固定副本数（无额外依赖） #

如果业务不需要感知动态扩缩容后的副本数变化，只需要获取部署时设定的副本数值，可以直接通过Helm、Kustomize等打包工具在渲染YAML时直接写入环境变量，不需要额外权限配置。
以Helm为例，配置如下：

env:
- name: REPLICAS
  value: {{ .Values.replicaCount }}

注意：不建议通过解析Pod名称的序号来推算副本数，该方式在Pod故障、集群扩缩容的场景下会出现数据不准的问题。

内容的提问来源于stack exchange，提问作者Alif Biswas