Hello OpenShift 示例实战：在 OpenShift 集群中部署与定制一个可配置响应消息的 HTTP 应用

测试云原生质量保障【免费下载链接】originConformance test suite for OpenShift项目地址https://gitcode.com/gh_mirrors/or/origin点击查看免费下载本篇技术指南以 OpenShift origin 仓库自带的 examples/hello-openshift 示例为核心完整讲解其工作原理、Pod 部署、响应定制与镜像重建全流程。读者读完本篇后将掌握在 OpenShift 集群中通过oc create快速拉起一个 HTTP 示例应用、借助环境变量动态修改应用行为、从外部网络访问集群内应用以及基于 Go 源码重新构建静态镜像的完整实战能力。示例概览一个最小可运行的 HTTP 服务examples/hello-openshift是一个专为 OpenShift v3 设计的入门级示例它启动一个 HTTP 服务默认对每个请求返回文本Hello OpenShift!。该示例的价值在于用最小的资源形态串起 OpenShift 应用开发的关键环节——镜像、Pod、环境变量注入、服务暴露与重建是验证集群网络、镜像拉取与调度能力的理想测试载体。示例目录的核心文件构成如下文件作用examples/hello-openshift/hello_openshift.goHTTP 服务源码负责响应文本生成与端口监听examples/hello-openshift/hello-pod.jsonPod 定义清单描述容器的镜像、端口与挂载examples/hello-openshift/hello-project.json示例项目Project定义用于演示 v3 的项目概念examples/hello-openshift/Dockerfile基于scratch的极简镜像构建文件examples/hello-openshift/go.modGo 模块定义go 1.21examples/hello-openshift/OWNERS维护者与审批者清单源码解剖响应文本与环境变量的底层实现hello_openshift.go是整个示例的行为来源。其核心逻辑非常清晰从源码结构看包含两个关键设计RESPONSE默认响应文本helloHandler首先读取环境变量RESPONSEresponse : os.Getenv(RESPONSE) if len(response) 0 { response Hello OpenShift! }即只要容器环境中设置了RESPONSE变量HTTP 响应内容就会被替换为该变量的值未设置时回退到默认值Hello OpenShift!。这就是文档所述通过环境变量定制响应消息的源码依据无需修改代码仅需在 Pod 定义中注入环境变量即可改变应用行为。请求端口回显x-request-port 响应头处理器还从请求上下文取出本地监听地址将实际接收请求的端口以x-request-port响应头回传给客户端addr : r.Context().Value(http.LocalAddrContextKey).(net.Addr) if tcpAddr, ok : addr.(*net.TCPAddr); ok { w.Header().Set(x-request-port, strconv.Itoa(tcpAddr.Port)) }当示例应用同时监听多个端口时该响应头可用于验证流量究竟落在哪个端口上——在集群负载均衡或多端口探活场景下是实用的排障手段。双端口监听PORT 与 SECOND_PORTmain函数同时启动两个 HTTP 服务port : os.Getenv(PORT) if len(port) 0 { port 8080 // 第一监听端口默认 8080 } go listenAndServe(port) port os.Getenv(SECOND_PORT) if len(port) 0 { port 8888 // 第二监听端口默认 8888 } go listenAndServe(port) select {}从源码可以推断示例支持通过PORT与SECOND_PORT两个环境变量分别定制监听端口默认值为 8080 与 8888select {}使主协程永久阻塞避免进程退出。listenAndServe在监听失败时会直接panic保证异常状态能被集群及时感知。快速上手创建 Pod 并验证响应第一步部署 Pod在已通过oc登录的集群中直接用仓库内的 Pod 清单创建资源$ oc create -f examples/hello-openshift/hello-pod.jsonhello-pod.json 声明了一个名为hello-openshift的 Pod关键字段包括spec.containers[0].image镜像为openshift/hello-openshiftports[0].containerPort容器内监听端口 8080TCPvolumes/volumeMounts挂载名为tmp的emptyDir卷到/tmprestartPolicy: AlwaysPod 异常退出后自动重启imagePullPolicy: IfNotPresent本地已有镜像则优先复用。第二步获取 Pod 的集群内部 IP创建成功后查询 Pod 并提取其集群内网 IP$ oc get pod hello-openshift -o yaml | grep podIP podIP: 10.1.0.2podIP是 OpenShift SDN 分配给该 Pod 的集群内部地址仅在集群网络内可达。第三步从集群内部访问在集群内任一节点或可访问集群网络的容器中执行$ curl 10.1.0.2:8080 Hello OpenShift!若响应如上说明 Pod 已成功调度、镜像正常拉取、8080 端口正常监听——一次完整的部署闭环就此打通。用环境变量定制响应消息默认响应固定为Hello OpenShift!而示例支持通过RESPONSE环境变量动态改写。操作方式编辑 hello-pod.json在容器定义中加入env子句紧跟image字段之后containers: [ { name: hello-openshift, image: openshift/hello-openshift, env: [ { name: RESPONSE, value: Hello World! } ], ... } ],完整的env条目结构为namevalue键值对与源码中os.Getenv(RESPONSE)的读取逻辑一一对应。结合上一节源码可知此处同样可以扩展PORT、SECOND_PORT来调整监听端口。修改清单后先删除旧 Pod 再重新创建旧 Pod 不会自动感知清单变更$ oc delete pod hello-openshift $ oc create -f examples/hello-openshift/hello-pod.json重新获取新的podIP后再次访问响应即为自定义消息$ curl 10.1.0.2:8080 Hello World!对外暴露从外部网络访问应用Pod 的podIP属于集群内网地址外部网络无法直接访问。如需从集群外部测试该示例需要创建 Router即 OpenShift 的路由层将外部流量转发到集群内的服务。常规做法是先创建一个指向该 Pod 的 Serviceoc expose pod hello-openshift再创建 Route 将域名映射到该 ServiceRouter 组件负责实际的流量负载与转发。由于本仓库未包含 routing 文档具体路由配置请以你所用 OpenShift 版本的路由管理文档为准。从源码重新构建镜像若需要修改源码例如调整默认响应文本、新增监听端口或重新打包镜像可按以下步骤执行$ go build -tags netgo # 避免动态链接构建静态二进制 $ mv hello-openshift bin $ docker build -t docker.io/openshift/hello-openshift .其中go build -tags netgo强制使用 Go 原生的纯 Go 网络栈产出静态链接的二进制避免依赖宿主机的动态库——这是容器镜像尤其是scratch基础镜像能够直接运行的前提。构建完成的二进制移动到bin/目录后由 Dockerfile 打包FROM scratch COPY bin/hello-openshift /hello-openshift EXPOSE 8080 8888 USER 1001 ENTRYPOINT [/hello-openshift]该 Dockerfile 的要点FROM scratch从零构建镜像镜像体积极小只包含一个静态二进制EXPOSE 8080 8888声明容器对外开放 8080 与 8888 两个端口与源码中PORT/SECOND_PORT的默认值一致USER 1001以非 root 用户运行契合 OpenShift 默认的禁止以 root 身份运行容器安全策略属于示例刻意为之的容器安全实践ENTRYPOINT [/hello-openshift]直接以该二进制作为容器启动入口。重建完成后可用docker push推送到镜像仓库再以新镜像部署 Pod 验证改动。配套资源与进一步探索examples/hello-openshift/hello-project.json 演示了 OpenShift v3 的 Project 概念通过project.openshift.io/v1API 创建名为hello-openshift-project的项目并用openshift.io/description、openshift.io/display-name注解设置描述与显示名可配合oc create -f体验多租户隔离模型examples/hello-openshift/go.mod 声明模块路径为github.com/openshift/origin/examples/hello-openshiftGo 版本要求1.21复现构建环境时需保证工具链不低于该版本examples/hello-openshift/OWNERS 列出了该示例的评审者与审批者可供贡献者了解代码归属仓库内其他镜像类示例如 examples/image-streams与本文示例同属 OpenShift 平台验证体系可对比学习镜像流与部署对象的使用方式。小结hello-openshift示例以最小的代码与资源开销完整覆盖了 OpenShift 应用生命周期中的核心动作源码编译go build -tags netgo、镜像构建scratch 非 root 用户、Pod 创建oc create -f hello-pod.json、环境变量注入RESPONSE、集群内验证curl podIP:8080与外部流量接入Router。其源码中os.Getenv(RESPONSE)与双端口监听的设计为理解环境变量驱动容器行为这一 OpenShift/容器平台通用范式提供了最直观的参考样本。赞分享测试云原生质量保障【免费下载链接】originConformance test suite for OpenShift项目地址https://gitcode.com/gh_mirrors/or/origin点击查看免费下载相关推荐sealed-secrets与OpenShift集成在OpenShift集群中的部署sealed secrets与OpenShift集成在OpenShift集群中的部署 引言解决OpenShift密钥管理的核心痛点 你是否正在OpenShi云原生应用安全运维origin 示例实战使用 OpenShift Template 配合已有 PVC 一键部署 GlusterFS 持久化 NGINX 应用origin 示例实战使用 OpenShift Template 配合已有 PVC 一键部署 GlusterFS 持久化 NGINX 应用 本文基于 orig测试云原生质量保障Reloader在OpenShift环境中的部署与配置Reloader在OpenShift环境中的部署与配置 你是否还在为OpenShift集群中配置变更后需要手动重启应用而烦恼本文将详细介绍如何在OpenShi云原生运维上一篇Apache Airflow 指南项目常见问题解决方案下一篇完整SwiftUI手势交互清单基于SwiftUI-experiments的最佳实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考