Kubernetes中Service正确引用ContainerPort端口名称的配置方法

报错根因 #

你把Pod容器上定义的字符串类型端口名bananaport，直接填给了Service端口配置里的port字段。按照Kubernetes 1.19的API定义，spec.ports[].port是Service自身对外暴露的集群访问端口，必须使用整数类型，传入字符串就会直接触发类型校验失败，和命名端口本身的配置规则无关。

正确的字段使用逻辑 #

Service的每个端口配置块里，和端口转发、命名相关的字段职责完全独立，不能混填：

• port：必填字段，整数类型，代表Service本身在集群网络中开放的端口，集群内其他工作负载通过服务名:这个端口号访问服务。
• targetPort：流量最终转发的目标位置，既可以填整数形式的容器端口号，也可以填字符串形式的、对应Pod容器上已经定义好的端口名称。Kubernetes会自动把匹配到的服务访问流量，转到对应命名的容器端口上，不需要手动写目标端口的数字值。
• 如果需要给Service自身的端口起名字（方便后续Ingress等上层资源关联引用），才需要在Service端口块中填写name字段。这个名称需要符合IANA_SVC_NAME规范，且在同一个Service的所有端口配置范围内唯一。

对应现有配置的修正 #

你的配置存在明显的字段错配，修正后的Service完整片段如下：

kind: Service
apiVersion: v1
metadata:
  name: banana-service
spec:
  selector:
    app: banana
  ports:
    - port: 5678 # 填整数形式的Service暴露端口
      targetPort: bananaport # 在这里引用Pod容器上定义的命名端口

容易混淆的注意事项 #

• 容器端口名称、Service端口名称的作用域完全独立：容器端口的名称只要在同一个Pod内唯一即可，Service端口的名称只要在当前Service的端口列表内唯一即可，两者不需要强制保持一致。
• 所有要求整数类型的端口字段，都不能传入字符串形式的端口名，否则都会触发和本次相同的校验报错。

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