kubectl edit编辑资源后YAML的script块被转义格式化如何解决

Kubernetes API 仅存储资源字段的实际值，不会保留提交时的 YAML 原始格式。kubectl edit 拉取资源时默认的 YAML 序列化策略，会将包含换行的字符串序列化为带转义符的单行格式，和提交时是否使用|多行块语法无关。

• 方案1：配置kubectl环境变量（优先推荐，适配kubectl v1.21及以上版本）
  执行编辑操作前，先配置如下环境变量，只要字符串中包含换行符，kubectl就会自动使用|多行块格式输出：

  export KUBECTL_YAML_MULTILINE_STRING_THRESHOLD=1
  

  配置完成后再正常执行kubectl edit <资源类型> <资源名称>即可。如果需要永久生效，可将上述环境变量配置写入你的shell配置文件（.bashrc/.zshrc等）。

• 方案2：使用本地YAML文件管理资源
  始终在本地保留原始的YAML配置文件（保留你编写的多行script块格式），每次修改后直接用kubectl apply -f <本地资源文件路径>提交生效，避免直接使用kubectl edit修改资源，从根源上避免格式被改写。

• 方案3：自定义编辑器前置转换逻辑
  如果必须使用kubectl edit且kubectl版本低于v1.21，可以配置KUBE_EDITOR环境变量，在编辑器打开前先通过yq工具自动将带换行的字符串转换为多行块格式：

  # 需提前安装yq v4及以上版本
  export KUBE_EDITOR='bash -c "yq eval \"(.. | select(type == \\\"string\\\" and test(\\\"\\n\\\"))) style=literal\" \"$0\" > \"$0.tmp\" && mv \"$0.tmp\" \"$0\" && vim \"$0\""'
  

  配置后打开kubectl edit时会自动完成格式转换，打开后即可看到正常的多行块结构。

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