如何借助oc process实现OpenShift模板资源的条件化部署管控？

问题描述 #

我目前通过Ansible自动化执行以下命令部署OpenShift资源：

oc process -f allresources.yaml | oc apply -f -

allresources.yaml模板包含路由、服务等资源，现在需要添加一条可选的HTTP路由，与必选的HTTPS路由一同部署——但开发者并非总是需要HTTP路由，希望通过Jenkinsfile配置开关控制。

核心疑问：能否给oc process添加选择器/条件，让它仅处理匹配条件的资源？最终将由Ansible解析Jenkins配置，执行对应的oc process命令。我尝试设想了类似这样的命令：

oc process -f allresources.yaml APP=someapp ENV=dev --ignore="HTTPRoute" | oc apply -f -

解决方案 #

oc process本身没有直接的资源选择器/条件过滤参数，但可以通过两种实用方式实现需求：

方法一：利用OpenShift模板的原生参数化条件渲染 #

这是最符合OpenShift设计规范的方案，把是否生成HTTP路由的逻辑嵌入模板，通过参数控制：

1. 在模板的parameters块新增一个布尔控制参数：

parameters:
- name: ENABLE_HTTP_ROUTE
  displayName: 启用HTTP路由
  description: 是否部署可选的HTTP路由
  value: "false"
  type: boolean

2. 给HTTP路由的定义加上条件判断块：

{{ if .Parameters.ENABLE_HTTP_ROUTE }}
apiVersion: route.openshift.io/v1
kind: Route
metadata:
  name: {{ .APP }}-http
spec:
  host: {{ .APP }}-{{ .ENV }}.example.com
  to:
    kind: Service
    name: {{ .APP }}-service
  # 根据需求配置TLS或明文
{{ end }}

3. 执行命令时通过参数开关控制：

# 启用HTTP路由
oc process -f allresources.yaml APP=someapp ENV=dev ENABLE_HTTP_ROUTE=true | oc apply -f -

# 禁用HTTP路由（使用默认值false）
oc process -f allresources.yaml APP=someapp ENV=dev | oc apply -f -

这种方式无需额外工具依赖，逻辑清晰，也很容易在Jenkinsfile中通过参数化构建配置开关，由Ansible读取参数后传递给oc process。

方法二：结合外部工具过滤资源 #

如果不想修改模板，可以在oc process生成资源后、oc apply之前，用yq或jq过滤掉不需要的资源：

1. 先给模板中的HTTP路由添加专属标签：

apiVersion: route.openshift.io/v1
kind: Route
metadata:
  name: {{ .APP }}-http
  labels:
    route-type: http-optional
spec:
  # ... 路由配置

2. 执行命令时过滤资源：

# 禁用HTTP路由：过滤带指定标签的资源
oc process -f allresources.yaml APP=someapp ENV=dev | yq 'del(select(.metadata.labels."route-type" == "http-optional"))' | oc apply -f -

# 启用HTTP路由：直接执行不做过滤
oc process -f allresources.yaml APP=someapp ENV=dev | oc apply -f -

如果用jq处理JSON格式输出：

oc process -f allresources.yaml APP=someapp ENV=dev -o json | jq 'del(.items[] | select(.metadata.labels."route-type" == "http-optional"))' | oc apply -f -

总结 #

优先推荐方法一，它完全基于OpenShift模板原生能力，维护成本更低，也更适配Jenkins参数化构建的场景。

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