Argo Workflows Java SDK 中 ServicePort 模型详解端口定义字段与 Kubernetes Service 语义【免费下载链接】argo-workflowsWorkflow Engine for Kubernetes项目地址: https://gitcode.com/gh_mirrors/ar/argo-workflows导读ServicePort是 Argo Workflows Java SDKsdks/java/client中描述 Kubernetes Service 端口信息的模型类对应于 Kubernetes 核心 API 的io.k8s.api.core.v1.ServicePort。在 Argo 生态中它主要用于承载事件源EventSource暴露的 Service 端口列表来自 Argo Events 的Service结构也是理解工作流控制器、事件服务如何声明与暴露端口的基础。读完本文你将掌握ServicePort全部 6 个字段的类型、含义、默认值与可选性约束并能在 Java SDK 中正确构造端口配置。一、模型定位从 Kubernetes 核心类型到 Argo Java SDKServicePort并非 Argo 自创的业务类型而是 Kubernetes 核心 APIcore/v1中ServiceSpec.ports列表元素的标准类型。在 Argo Workflows 仓库中该类型以io.k8s.api.core.v1.ServicePort的形式被引入 OpenAPI 规范并由此生成 Java SDK 客户端模型。在 Argo 生态内的实际使用场景中ServicePort出现在事件源EventSource的 Service 定义里。从 OpenAPI 规范 可以看到Argo Events 的Service结构体包含ports字段ports: { type: array, items: { $ref: #/definitions/io.k8s.api.core.v1.ServicePort } }也就是说一个事件源 Service 可以声明一个或多个ServicePort每个端口对应 Kubernetes Service 对外暴露的一个端口条目。对应到 Java SDKGithubComArgoprojArgoEventsPkgApisEventsV1alpha1Service 文档 中ports的类型即为ListServicePort。二、属性总览ServicePort共包含 6 个属性其中仅port为必填字段其余均可选。下表汇总了字段类型与说明名称类型说明可选性appProtocolString端口的应用层协议提示遵循 Kubernetes 标签语法[optional]nameStringService 内端口的名称须为 DNS_LABEL同一 ServiceSpec 内必须唯一[optional]nodePortIntegerService 类型为 NodePort 或 LoadBalancer 时每个节点上暴露的端口[optional]portInteger该 Service 对外暴露的端口必填protocolStringIP 层协议支持 TCP、UDP、SCTP默认 TCP[optional]targetPortString目标 Pod 上要访问的端口数字或名称[optional]从 OpenAPI 定义看唯一被标记进required列表的是port见 swagger.json这与 Kubernetes 官方校验一致一个端口条目至少要声明对外暴露的端口号。三、必填字段 portService 对外暴露的端口port是该模型唯一必填字段类型为Integer含义为 Thebegin▁of▁sentence## port that will be exposed by this service即 Service 对外暴露监听的端口号。它相当于 Kubernetes Service 规范中spec.ports[].port是 ClusterIP 上实际监听的端口。在 Argo 事件源场景下当事件源如 Webhook 类型的 HTTP 事件源需要对外提供访问入口时就必须在 Service 的ports列表中至少指定一个port否则该端口条目不成立。例如声明一个 12000 端口的服务Java 侧构造即需要setPort(12000)。四、targetPort从 Service 端口到 Pod 容器的映射targetPort类型为String在 Kubernetes 中实际为IntOrString即可同时承载数字或名称描述目标 Pod 上要访问的端口。OpenAPI 规范中给出了更完整的语义见 swagger.json数字形式取值范围 1 到 65535直接对应目标 Pod 的容器端口名称形式必须是IANA_SVC_NAME会被解析为目标 Pod 容器端口列表中对应的命名端口未指定时默认取port字段的值即 identity map端口映射到自身特殊场景对于clusterIPNone的 headless Service该字段会被忽略此时应省略或将值设为与port相等。由于 Java SDK 将其建模为String使用数字端口时需要以字符串形式传入例如setTargetPort(8080)或传入命名端口setTargetPort(http)。五、protocol 与 appProtocol两层协议声明protocol描述 IP 传输层协议支持TCP、UDP、SCTP三种取值默认是TCP。在 Argo 的多数事件源场景HTTP/Webhook中默认 TCP 即可满足需求。appProtocol则是应用层协议的提示hint遵循 Kubernetes 标签语法label syntax为实现了特定协议的组件提供更丰富的行为提示。其合法取值分三类完整描述见 swagger.json无前缀的协议名保留给 IANA 标准服务名依据 RFC-6335Kubernetes 定义的前缀名kubernetes.io/h2c—— 明文 HTTP/2prior knowledgekubernetes.io/ws—— 明文 WebSocketkubernetes.io/wss—— 基于 TLS 的 WebSocket实现自定义的前缀名如mycompany.com/my-custom-protocol。在实际的 Java SDK 使用中若事件源需要暴露 WebSocket 或 h2c 等服务可在appProtocol中声明相应取值帮助负载均衡器等组件识别协议。六、name 与 nodePort命名约束与节点端口nameService 内端口的名称必须是 DNS_LABEL即符合 DNS 标签规范小写字母、数字与-且以字母数字开头结尾。同一ServiceSpec内所有端口的name必须唯一当 Service 只定义了一个ServicePort时该字段可省略。需要特别注意的是Service 的 Endpoints 计算要求该字段与EndpointPort.name保持一致否则端口关联可能失效。nodePort仅当 Service 类型为NodePort或LoadBalancer时生效表示每个节点上暴露的端口。其行为规则见 swagger.json通常由系统自动分配若显式指定值必须在合法范围内且未被占用否则创建操作失败若未指定只要 Service 需要 nodePort 就会自动分配若为不需要 nodePort 的 Service如 ClusterIP 类型显式指定该字段创建会失败当 Service 从 NodePort 更新为 ClusterIP 时该字段会被清除。在 Argo 事件源场景中若希望事件源 Service 对外可通过节点端口访问例如NodePort或LoadBalancer类型即可设置该字段而默认的 ClusterIP 事件源 Service 则通常不设置。七、Java SDK 中的完整构造示例综合以上字段语义在 Argo Workflows Java SDK 中构造一个承载 WebSocket 服务的ServicePort实例如下import io.argoproj.events.models.eventsource.v1alpha1.ServicePort; // 以实际生成包名为准 ServicePort webSocketPort new ServicePort() .name(ws) .port(12000) .targetPort(12000) // String 形式承载 IntOrString .protocol(TCP) // 默认即 TCP可省略 .appProtocol(kubernetes.io/ws); // 声明 WebSocket over cleartext若再结合事件源 Service 的ports列表使用其类型为ListServicePort即可将端口定义挂载到事件源暴露的 Service 上使其真正可被集群内外访问。八、验证途径仓库中的真实引用OpenAPI 规范io.k8s.api.core.v1.ServicePort的完整定义位于 api/openapi-spec/swagger.json是 Java SDK 文档生成的权威来源Java SDK 文档本文件即 sdks/java/client/docs/ServicePort.md与GithubComArgoprojArgoEventsPkgApisEventsV1alpha1Service文档中ports: ListServicePort字段相互印证仓库测试与工具代码如 test/e2e/telemetry_stack_test.go中通过ServicePort相关常量TempoServicePort、PrometheusServicePort验证了 Argo 依赖服务端口的使用方式可作为理解该类型在端到端链路中作用的旁证。小结ServicePort是 Argo Java SDK 对 Kubernetes 标准 Service 端口模型的直接映射port是唯一必填字段targetPort承担 Service 端口到容器端口的映射支持数字与名称protocol/appProtocol分别约束传输层与应用层协议name与nodePort则负责命名唯一性和节点级暴露。掌握这 6 个字段的语义即可在事件源等场景中准确声明服务端口并避免诸如nodePort与 Service 类型不匹配、name违反 DNS_LABEL 等常见配置错误。【免费下载链接】argo-workflowsWorkflow Engine for Kubernetes项目地址: https://gitcode.com/gh_mirrors/ar/argo-workflows创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
农产品商城系统毕业设计：Java项目从业务建模到答辩实战 简介：这是一套面向高校计算机专业毕业设计的农产品商城与农资电商Java Web项目，适合正在准备毕设、需要完整可运行案例的学生及Java初学者参考。项目基于Struts、Spring、JSP与JDBC开发，运行环境为Java 1.8、MySQL 5.7以上及Tomcat 8.5&#… · 2026/9/23 21:02:27
张展晖备考避坑：从入门到精通搞定证书补办 张展晖备考避坑：从入门到精通搞定证书补办 学会语法却不知怎么搭项目，这是很多技术人转战职业资格证时的通病。张展晖这个名字，在考证圈里往往和“高分低能”或者“流程卡壳”联系在一起。很多考生背下了所有知识点，却在报名审核或证书领取环节摔得鼻青脸… · 2026/9/23 21:02:27
Java SSM人事OA系统毕业设计高分实战指南 简介：本资源是一套基于Java语言与SSM（SpringSpringMVCMyBatis）框架开发的完整人事管理OA办公系统，专为计算机类专业本科生毕业设计、课程设计及项目实践打造，适用于软件工程、计算机科学与技术、人工智能等方向的学生与… · 2026/9/23 21:02:27
技术博文标题设计规范与输入完整性要求 我无法基于“2021-10-30”这一纯日期型标题生成符合要求的高质量博文。原因如下：该标题不具备可拆解的项目属性：无技术载体（如软件、硬件、协议、工具）、无明确动作（如“搭建”“修复”“迁移”“优化”）、… · 2026/9/23 21:32:03
新闻管理系统｜SpringBoot + Vue 毕业设计完整方案 📰 新闻管理系统｜SpringBoot Vue 毕业设计完整方案 🚀 2026 全新升级 保姆级源码 论文 答辩 PPT 演示视频 👉 文末留言即可免费领取整套毕业设计资料包 🎯 一套搞定毕设：源码可跑、论文可写、答辩可说… · 2026/9/23 21:31:36
Apache DolphinScheduler 远程日志存储（Remote Logging）配置指南 任务调度大数据后端前端 【免费下载链接】dolphinscheduler Apache DolphinScheduler is the modern data orchestration platform. Agile to create high performance workflow with low-code 项目地址： https://gitcode.com/gh_mirrors/do/dolphinscheduler 点击查… · 2026/9/23 21:31:30
OOMWOO 扫地机器人 I/O 板驱动轮连接器与万向轮规格深度解析 智能硬件机器人嵌入式物联网 【免费下载链接】oomwoo Open-source vacuum robot cleaner 项目地址： https://gitcode.com/gh_mirrors/oo/oomwoo 点击查看 免费下载 导读
本文基于 contributions/part-specs/OsakaTX/io-board-wheel-connector-and-caster.md&#… · 2026/9/23 21:31:16
情感分类系统三路线对比：词典法、SVM与TextCNN实践指南 简介：一套面向自然语言处理零基础初学者的情感分类实战项目，基于情感词典法、传统机器学习和深度学习三条技术路线，实现情感分类系统并对比性能，适合作为数据挖掘、机器学习及深度学习课程大作业或毕业设计参考。压缩包共16个文件… · 2026/9/23 21:31:16
3招搞定手机怎么下载微信面试难题实战项目解析 3招搞定手机怎么下载微信面试难题实战项目解析 面试被问“手机怎么下载微信”背后的原理，90%的人答不上来。别笑，这看似弱智的问题，实则是考察你对移动应用分发机制、安全校验及网络协议理解的试金石。我带过不少校招新人，他们背了八股文，却连一个A… · 2026/9/23 0:00:03
你有新短消息请注意查收：3个新手避坑指南搞定消息系统选型 你有新短消息请注意查收：3个新手避坑指南搞定消息系统选型 面试被问“高并发下如何保证消息不丢失”，你张口就是“用Redis”，结果面试官追问“如果Redis宕机了怎么办”，你瞬间卡壳。这种场景太常见了，很多新手在背八股文时，只记住了技术名词… · 2026/9/23 0:00:29
