把 JSON 转换成基于缩进的 YAML。大括号和大部分引号都会消失,作为配置文件手动维护起来更轻松,key 的顺序也与源 JSON 完全一致。
当你要把用 kubectl get -o json 取到的资源移进 manifest,或把从 API 拿到的设置粘贴进 docker-compose.yml、application.yml 或 GitHub Actions workflow 时,它会派上用场。
JSON 框中。语法无效时结果中会显示 JSON parsing failed;必要时先用 JSON 校验工具检查一遍。结果 下查看 YAML,缩进为两个空格。{
"services": {
"web": {
"image": "nginx:1.27",
"ports": ["8080:80"],
"environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
}
}
}services:
web:
image: nginx:1.27
ports:
- 8080:80
environment:
FEATURE_FLAG: "on"
GREETING: |-
hello
world
字符串 "on" 保留了引号:如果直接写成 on,YAML 1.1 解析器会把它读成布尔值 true。GREETING 包含换行,因此输出为 |- 块,每一行按原样显示。
yes、no、on、off、y、n、~、null 这类字符串,以及 "0777"、"1.0"、"2024-01-01" 这类容易被误读的值都会加上引号,确保 PyYAML(1.1)和较新的 1.2 解析器读到相同的值。22:22 这类在 YAML 1.1 中可能被当作六十进制数字的字符串也会加引号,避开了 docker-compose 端口映射的经典 bug。|- 字面量块。[] 和 {}。把从集群以 JSON 形式取出的 Deployment 或 ConfigMap 转换过来,删掉 status、metadata.uid 等字段,就得到一份可以放进 Git 的 manifest。
从配置服务器或文档中拿到的一段 JSON 属性会变成 YAML 层级结构,不必再手动给 spring.datasource.url 这样的 key 逐级缩进。
&)或别名(*);JSON 中重复出现的对象在 YAML 中也会重复出现。--- 分隔的多资源文件,请分别转换每个资源后自行拼接。只有在不加引号会被读成其他类型时才加引号。nginx:1.27 无论如何都是字符串,但 on、010 和 22:22 在某些解析器中会变成布尔值或数字,所以要加引号。
结构本身是有效的。不过 kubectl get -o json 的输出带有 status、resourceVersion、managedFields 等由服务器填充的字段,最好在 apply 之前删掉。
没有这个选项,固定为两个空格,这也是 Kubernetes、docker-compose 和 GitHub Actions 文档中通用的约定。