通过Helm在OpenShift部署容器化WebApp时容器启动失败排查

核心问题定位 #

错误日志显示：

exec: "python3 src/myapp.py": stat python3 src/myapp.py: no such file or directory

这说明Kubernetes尝试将python3 src/myapp.py作为单个完整命令去执行，而非将python3作为命令、src/myapp.py作为参数拆分处理。这种情况通常是容器的command字段被错误渲染为字符串，而非Kubernetes要求的数组格式导致的。

原因分析 #

你的Dockerfile采用了ENTRYPOINT ["python3"] + CMD ["src/myapp.py"]的标准拆分写法，手动运行时正常；但通过Helm部署时，values.yaml中定义的command: [ "python3" , "src/hepspecapp.py" ]没有被正确渲染为Kubernetes可识别的数组格式，反而被合并成了单个字符串命令，导致runc无法找到对应的可执行文件。

问题出在deployment.yaml中的{{- include "myapp.command" . | nindent 8 }}这一行：myapp.command模板没有正确处理数组类型的command参数，最终输出了错误的字符串格式。

解决方案 #

方案1：直接替换include模板为数组渲染 #

修改deployment.yaml中容器部分的command配置，替换原include语句为直接渲染数组：

containers:
- name: myapp
  image: {{ .Values.image.repository }}:{{ .Values.image.tag }}
  imagePullPolicy: {{ .Values.image.imagePullPolicy }}
  command: {{ .Values.image.command | toJson }}
  # 替换掉原来的{{- include "myapp.command" . | nindent 8 }}

toJson函数会将数组正确转换为Kubernetes可识别的YAML数组格式。

方案2：修复myapp.command模板 #

如果必须使用include模板，确保模板文件（通常是_helpers.tpl）中的myapp.command定义正确遍历数组：

{{- define "myapp.command" -}}
{{- if .Values.image.command }}
command:
  {{- range .Values.image.command }}
  - {{ . }}
  {{- end }}
{{- end }}
{{- end -}}

这个模板会将数组中的每个元素单独渲染为一行，符合Kubernetes的YAML格式要求。

方案3：移除自定义command，使用镜像默认启动命令 #

如果不需要覆盖镜像的启动逻辑，可以直接删除values.yaml中的command配置，让容器使用Dockerfile中定义的ENTRYPOINT和CMD，这样完全避免格式问题：

image:
  repository: gitlab-registry.cern.ch/batch-team/hepspec-query/hepspec-query
  tag: latest
  imagePullSecret: {}
  imagePullPolicy: Always
  # 删除 command: [ "python3" , "src/hepspecapp.py" ]
  args: {}

验证步骤 #

1. 执行helm upgrade --install <release-name> .重新部署
2. 用kubectl describe pod <pod-name>查看容器的Command字段，确认是数组格式（如Command: ["python3", "src/hepspecapp.py"]）而非单个字符串
3. 查看Pod日志，确认启动成功

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