Istio版本冲突导致Istio-sidecar-injector模板解析报错咨询

根因确认 #

该故障确实是控制面版本不匹配导致的：

• Template_Version_And_Istio_Version_Mismatched_Check_Installation是Istio 1.6及以上版本才内置的注入模板校验函数，你正在运行的1.3.8版本sidecar-injector的代码中完全没有该函数的实现
• 新增的1.11.3版本istiod部署时，会默认更新集群内的istio-sidecar-injector ConfigMap（即sidecar注入模板配置），新模板引用了低版本注入器不识别的函数，就会抛出模板解析失败的错误

紧急恢复步骤 #

优先恢复业务侧Pod正常注入能力：

• 临时删除误装的1.11.3版本istiod相关资源：

  # 先确认1.11.3版本istiod对应的revision名称
  kubectl get deploy -n istio-system -l app=istiod
  # 卸载对应revision的控制面
  istioctl x uninstall --revision <1.11.3版本对应的revision值>
  

• 回滚sidecar注入模板到1.3.8版本对应配置：
  如果你有1.3.8版本的Istio部署包，直接重新apply对应版本的注入模板ConfigMap即可：

  kubectl apply -f <1.3.8部署包路径>/install/kubernetes/istio-sidecar-injector-configmap.yaml
  

• 重启sidecar-injector Pod，确认日志中不再有模板解析报错

后续升级注意事项 #

• Istio 1.3.8版本已经停止维护多年，且不支持多控制面灰度共存能力，如需升级到高版本，建议遵循小版本迭代原则：1.3.x→1.4.x→1.5.x→1.6.x，每一步升级验证无误后再往下走，不要直接跨多个大版本部署
• 1.6及以上版本支持基于revision的多控制面共存，可以先升级到1.6版本之后，再按灰度流程引入更高版本的istiod，避免出现单点故障

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