NGINX Ingress Controller启动报错：-tcp-services-configmap未定义

问题根源 #

你使用的是NGINX官方维护的Ingress控制器镜像（nginx/nginx-ingress:3.2.1），但参考的是Kubernetes社区维护的Ingress Nginx项目文档，两者的启动参数、配置逻辑完全不兼容，所以出现了参数未定义的报错。

正确配置TCP服务的步骤（针对NGINX官方Ingress控制器） #

1. 创建TCP转发规则的ConfigMap #

先定义需要转发的TCP端口与后端服务的映射，比如创建名为tcpservercm的ConfigMap：

apiVersion: v1
kind: ConfigMap
metadata:
  name: tcpservercm
  namespace: default
data:
  # 格式："监听端口": "命名空间/服务名:服务端口"
  "8080": "default/your-tcp-service:9000"

执行命令应用：

kubectl apply -f <configmap-file.yaml>

2. 通过Helm配置加载TCP ConfigMap #

不需要手动添加启动参数，直接修改Helm的values配置即可：

• 若使用values.yaml文件，添加以下配置：

  tcp:
    configMap: "default/tcpservercm"
  # 同时需要在Service中暴露对应的TCP端口
  service:
    tcpPorts:
      - port: 8080
        targetPort: 8080
  

• 若直接用命令行升级Helm release：

  helm upgrade <your-release-name> nginx-stable/nginx-ingress \
    --set tcp.configMap=default/tcpservercm \
    --set service.tcpPorts[0].port=8080 \
    --set service.tcpPorts[0].targetPort=8080
  

3. 验证 #

应用配置后，等待Pod重启完成，检查Pod状态：

kubectl get pods -n <your-ingress-namespace>

确认Pod正常运行后，即可通过Ingress Service的8080端口访问后端TCP服务。

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