Kubernetes 1.28 Job Sidecar功能使用及Kubelet特性门控配置求助

问题分析 #

你试图用K8s 1.28新增的Sidecar特性监控Job主容器，通过生命周期钩子触发后续操作，但当前配置存在两个核心问题：

• 错误将Sidecar容器定义为initContainers，而init容器本身不支持restartPolicy字段，这是部署失败的直接原因
• 未在Kubelet层面正确开启SidecarContainers特性门控

一、RedHat 9环境下开启Kubelet特性门控步骤 #

Kubelet的特性门控需通过配置文件或systemd参数开启，操作如下：

1. 修改Kubelet配置文件
   编辑/var/lib/kubelet/config.yaml，添加特性门控配置：

   featureGates:
     SidecarContainers: true
   

2. 针对systemd启动的Kubelet补充参数
   编辑/etc/systemd/system/kubelet.service.d/10-kubeadm.conf（或对应Kubelet服务配置文件），在KUBELET_ARGS中追加特性门控：

   Environment="KUBELET_ARGS=--feature-gates=SidecarContainers=true"
   

3. 重启Kubelet使配置生效

   systemctl daemon-reload
   systemctl restart kubelet
   

4. 验证特性门控状态
   执行命令检查Kubelet运行参数：

   ps aux | grep kubelet | grep feature-gates
   

   输出中需包含--feature-gates=SidecarContainers=true则说明配置成功

二、修正Job配置（符合Sidecar特性规范） #

将原配置中的initContainers替换为K8s 1.28新增的sidecars字段，同时调整信号传递逻辑：

apiVersion: batch/v1
kind: Job
metadata:
  name: job-wrapper
spec:
  template:
    spec:
      sidecars:
        - name: wrapper
          image: busybox
          command:
           - "/bin/sh"
           - "-c"
           - |
             while true; do
               if [ -e "/shared/start" ]; then
                 echo "Main container started, monitoring logs..."
                 # 可选：实时监控主容器日志，示例：tail -f /var/log/application.log
               elif [ -e "/shared/stop" ]; then
                 echo "Main container stopped, executing post-processing..."
                 # 在这里添加你的业务操作：发送含日志邮件、移动文件等
                 # 示例：echo "Sending completion alert..." && sleep 3
                 # 操作完成后退出，避免无意义运行
                 exit 0
               else
                 echo "Waiting for main container signal"
               fi
               sleep 1
             done
          volumeMounts:
            - name: shared-dir
              mountPath: /shared
      containers:
      - name: application
        image: busybox
        command: ["sh", "-c", "echo Processing && sleep 10 && echo Processing end!"]
        volumeMounts:
          - name: shared-dir
            mountPath: /shared
        lifecycle:
          postStart:
            exec:
              command: [ "sh", "-c", "touch /shared/start" ]
          preStop:
            exec:
              command: [ "sh", "-c", "touch /shared/stop" ]
      volumes:
        - name: shared-dir
          emptyDir: {}
      restartPolicy: OnFailure

配置说明： #

• 使用sidecars字段定义监控容器，这是K8s 1.28 Sidecar特性的标准用法，默认restartPolicy为Always无需额外指定
• 通过emptyDir卷实现主容器与sidecar的信号传递，避免进程间通信的复杂配置
• 主容器的postStart/preStop钩子通过创建文件触发sidecar的状态切换，逻辑清晰易维护

三、部署验证 #

1. 创建Job：

   kubectl apply -f job-sidecar.yaml
   

2. 查看容器日志验证逻辑：

   kubectl logs -l job-name=job-wrapper -c wrapper
   kubectl logs -l job-name=job-wrapper -c application
   

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