K8s中Nginx Pod指定containerPort 8080未生效问题

核心原因 #

你对K8s的containerPort字段的作用存在误解，这是K8s新手最常见的误区之一：

• containerPort是声明性的标记字段，仅作参考用途，完全不会修改容器内部运行的服务实际监听的端口。你可以把它理解为给运维人员、后续配置Service/Ingress资源用的增强版注释，K8s不会校验这个字段的值和容器内服务实际监听端口是否一致，你填任何值都不会影响容器内程序的运行逻辑。
• 你使用的镜像ewoutp/docker-nginx-curl默认内置的Nginx配置就是监听80端口，你没有修改镜像内的Nginx配置，自然服务还是在80端口启动，和你在YAML里填的containerPort: 8080没有关联。
• 你用kubectl describe看到的Port: 8080/TCP只是读取了你YAML里填写的containerPort值，不是K8s探测到的容器内实际监听端口。

解决方案 #

根据你的实际需求二选一即可：

1. 需要让Nginx实际监听8080端口
   你需要修改Nginx的默认配置，可以通过以下任意一种方式实现：
   • 自己构建自定义镜像，把镜像内/etc/nginx/conf.d/default.conf里的listen 80;改为listen 8080;
   • 创建ConfigMap存储修改后的Nginx配置，在Pod里挂载这个ConfigMap覆盖默认配置文件
   • 在Pod的command字段添加启动命令，动态修改Nginx配置后再启动服务
2. 仅需要端口声明和实际监听一致
   直接把YAML里的containerPort: 8080改为containerPort: 80即可，不影响现有服务运行，只是方便后续配置Service等资源时对齐端口参数。

内容的提问来源于stack exchange，提问作者Kumar-Sandeep