使用oc apply向OpenShift 3添加环境变量时提示'unrecognized type: string'错误

问题场景 #

通过Ansible脚本调用oc apply向OpenShift 3部署模板添加环境变量时，触发模糊的500内部服务器错误，错误信息仅为"unrecognized type: string"。调整--loglevel 10后仍无法获取更多细节，日志仅显示PATCH请求返回500。

进一步排查发现：

• 请求体包含metadata注解及spec.template.spec配置
• containers的env字段仅包含原有变量OLD_VAR_4和新增的NEW_VAR_1/NEW_VAR_2/NEW_VAR_3
• $setElementOrder/env字段包含所有新旧环境变量的名称
• 直接用oc patch执行相同请求体也会触发相同错误

临时解决方式：先执行失败的部署，再通过OpenShift控制台手动添加新变量后重新部署即可成功。

可能原因 #

1. 请求体结构不规范：env数组中存在格式错误的条目，比如将变量名直接以字符串形式写入，而非标准的{"name": "...", "value": "..."}对象结构
2. $setElementOrder配置异常：该字段的env数组中混入了非字符串类型的值，或与实际env字段的变量名称不匹配
3. OpenShift 3 API的PATCH兼容性bug：在处理数组元素顺序的合并PATCH时，类型校验逻辑存在缺陷

解决方案 #

1. 校验env数组格式
   确保请求体中containers的env字段每个条目都是标准对象结构，示例：

   "spec": {
     "template": {
       "spec": {
         "containers": [
           {
             "name": "your-container",
             "env": [
               {"name": "OLD_VAR_4", "value": "original-value"},
               {"name": "NEW_VAR_1", "value": "new-value-1"}
             ]
           }
         ]
       }
     }
   }
   

   禁止出现类似"OLD_VAR_4"的纯字符串条目。

2. 修正$setElementOrder配置
   确保$setElementOrder/env是严格的字符串数组，且所有元素与env字段的变量名称完全对应，示例：

   "$setElementOrder": {
     "env": ["OLD_VAR_1", "OLD_VAR_2", "OLD_VAR_3", "OLD_VAR_4", "NEW_VAR_1", "NEW_VAR_2", "NEW_VAR_3"]
   }
   

3. 替换部署方式
   若PATCH方式持续报错，改用oc replace命令直接覆盖部署配置，绕过合并PATCH的逻辑：

   oc replace -f your-deployment-template.yaml
   

4. 检查Ansible脚本逻辑
   排查Ansible中构建请求体的代码，确保在拼接环境变量和$setElementOrder时，没有将变量值错误处理为字符串类型，或引入格式混乱的内容。

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