如何用yq获取docker-compose.yaml中点表示法的完整路径？

问题场景 #

现有结构如下的docker-compose.yaml文件：

services:
  foo:
    image: docker.registry.url:version
  foo2:
    image: docker.registry.url2:version
  foo3:
    image: docker.registry.url3:version

需要遍历所有服务的image字段，批量更新私有镜像仓库URL，因此需要提取每个image字段对应的完整点表示法查询路径（如.services.foo.image），用于后续循环处理。之前尝试的命令仅能获取零散的路径片段，无法直接使用。

解决方案 #

使用yq的路径处理函数，将路径数组拼接为完整的点表示法路径：

1. 提取完整路径 #

执行以下命令直接输出所有image字段的完整点路径：

yq '.services.*.image | path | join(".") | prepend(".")' docker-compose.yaml

输出结果：

.services.foo.image
.services.foo2.image
.services.foo3.image

命令拆解 #

• path：获取当前image节点的路径数组（如["services", "foo", "image"]）
• join(".")：将路径数组用点连接成字符串（如"services.foo.image"）
• prepend(".")：在字符串开头添加点，转换为可直接用于yq查询的格式（如.services.foo.image）

2. 批量更新示例 #

将提取的路径用于循环，批量替换镜像仓库URL：

for key in $(yq '.services.*.image | path | join(".") | prepend(".")' docker-compose.yaml); do
  # 替换镜像仓库前缀，比如把docker.registry开头的替换为new.registry.url
  yq -i "$key |= sub(\"^docker.registry.*:\"; \"new.registry.url:\")" docker-compose.yaml
done

兼容旧版yq（v4.18之前） #

如果使用的yq版本不支持prepend函数，可改用字符串拼接：

yq '.services.*.image | path | "." + join(".")' docker-compose.yaml

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