OpenShift中StatefulSet结合普通与Headless Service对外暴露的实现咨询

一、Headless Service与普通Service的作用 #

• Headless Service：这是StatefulSet的必备组件，必须创建。它的核心作用是给每个Pod分配稳定的网络标识（比如pod-name.service-name.namespace.svc.cluster.local），哪怕Pod重启或被调度到其他节点，这个标识也不会变更——这是StatefulSet实现有状态服务的基础，和外部暴露无关，但没有它StatefulSet无法正常工作。
• 普通Service：这是实现外部访问的关键组件，负责将StatefulSet的Pod流量暴露给集群外部。没有它，外部请求无法触达你的StatefulSet Pod。

总结：Headless Service是StatefulSet的刚需，普通Service是外部暴露的刚需，两个都得创建。

二、一步步完成配置 #

1. 创建Headless Service #

编写YAML文件（比如命名为headless-svc.yaml）：

apiVersion: v1
kind: Service
metadata:
  name: my-statefulset-headless
  namespace: your-namespace # 替换为你的实际命名空间
spec:
  clusterIP: None # 这是Headless Service的核心标识
  selector:
    app: my-statefulset-app # 该标签需与后续StatefulSet的Pod标签匹配
  ports:
  - name: http
    port: 80
    targetPort: 80 # 对应容器内的业务端口

执行OpenShift命令创建：

oc apply -f headless-svc.yaml

2. 创建StatefulSet #

编写StatefulSet的YAML文件（比如statefulset.yaml），注意serviceName必须指向刚才创建的Headless Service：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: my-statefulset
  namespace: your-namespace
spec:
  serviceName: my-statefulset-headless # 与Headless Service的name保持一致
  replicas: 3 # 根据需求调整副本数量
  selector:
    matchLabels:
      app: my-statefulset-app # 与Headless Service的selector对应
  template:
    metadata:
      labels:
        app: my-statefulset-app # Pod的标签，需与上述selector匹配
    spec:
      containers:
      - name: my-app-container
        image: your-app-image:tag # 替换为你的应用镜像地址
        ports:
        - containerPort: 80 # 与前面的targetPort对应

执行创建命令：

oc apply -f statefulset.yaml

3. 创建普通Service实现外部暴露 #

根据你的环境需求，选择以下任意一种方式：

方式一：NodePort（适合测试或无负载均衡的环境）

编写NodePort类型的Service YAML（nodeport-svc.yaml）：

apiVersion: v1
kind: Service
metadata:
  name: my-statefulset-nodeport
  namespace: your-namespace
spec:
  type: NodePort
  selector:
    app: my-statefulset-app
  ports:
  - name: http
    port: 80
    targetPort: 80
    nodePort: 30080 # 可选，指定30000-32767范围内的端口，不指定则自动分配

创建完成后，使用任意集群节点的IP加上该nodePort即可访问服务。

方式二：LoadBalancer（适合云环境，自动分配公网IP）

编写LoadBalancer类型的Service YAML（lb-svc.yaml）：

apiVersion: v1
kind: Service
metadata:
  name: my-statefulset-lb
  namespace: your-namespace
spec:
  type: LoadBalancer
  selector:
    app: my-statefulset-app
  ports:
  - name: http
    port: 80
    targetPort: 80

创建后，执行oc get service my-statefulset-lb查看EXTERNAL-IP字段，使用该公网IP即可访问服务。

方式三：OpenShift Route（推荐，OpenShift原生方式）

Route是OpenShift特有的资源，无需依赖LoadBalancer，直接关联普通Service即可实现外部访问。编写Route的YAML（statefulset-route.yaml）：

apiVersion: route.openshift.io/v1
kind: Route
metadata:
  name: my-statefulset-route
  namespace: your-namespace
spec:
  to:
    kind: Service
    name: my-statefulset-nodeport # 替换为你的普通Service名称
  port:
    targetPort: http # 与Service中的port名称对应
  tls:
    termination: edge # 可选，开启HTTPS，OpenShift会自动生成证书

创建完成后，执行oc get route my-statefulset-route查看HOST/PORT字段，使用该域名即可访问服务。

三、验证配置是否生效 #

• 检查Headless Service：执行oc get service my-statefulset-headless，确认CLUSTER-IP显示为None
• 检查StatefulSet Pod：执行oc get pods，应看到命名为my-statefulset-0、my-statefulset-1、my-statefulset-2的有序Pod，且状态均为Running
• 测试外部访问：使用对应的NodePort+节点IP、LoadBalancer IP或Route域名访问服务，确认业务正常响应

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