Bash脚本调用yq工具提取值后无法替换至YAML文件的问题

问题根源 #

你的脚本中，yq表达式里的$name和$namespace被yq当作自身的未定义变量处理，而非Bash环境变量，因此最终写入YAML的是null。这是因为yq的变量语法（$var）指向自身的变量体系，和Bash变量不互通。

解决方案 #

有两种可靠的方式将Bash变量传递给yq：

方法1：使用yq的env()函数引用Bash环境变量

yq（v4+版本）支持通过env(var_name)直接读取Bash环境变量，这种方式安全且避免字符串注入问题：

#!/bin/bash

# Set the path to the folder containing your YAML files
folder_path="./secrets"

# Loop through each YAML file in the folder
for yaml_file in "$folder_path"/*.yaml; do
  if [ -f "$yaml_file" ]; then
    # Extract the metadata.name field using yq
    name=$(yq eval '.metadata.name' "$yaml_file")
    namespace=$(yq eval '.metadata.namespace' "$yaml_file")

    # Update labels (已正常工作)
    yq eval '.metadata.labels."app.kubernetes.io/managed-by" = "Helm"' -i "$yaml_file"
    # 使用env()引用Bash变量更新annotations
    yq eval '.metadata.annotations."meta.helm.sh/release-name" = env(name) | .metadata.annotations."meta.helm.sh/release-namespace" = env(namespace)' -i "$yaml_file"
  fi
done

方法2：通过Bash字符串替换嵌入变量值

将yq表达式用双引号包裹，让Bash先替换掉表达式中的$name和$namespace变量，再传递给yq执行。注意需要转义表达式内的双引号：

#!/bin/bash

folder_path="./secrets"

for yaml_file in "$folder_path"/*.yaml; do
  if [ -f "$yaml_file" ]; then
    name=$(yq eval '.metadata.name' "$yaml_file")
    namespace=$(yq eval '.metadata.namespace' "$yaml_file")

    yq eval '.metadata.labels."app.kubernetes.io/managed-by" = "Helm"' -i "$yaml_file"
    # 双引号包裹表达式，Bash替换变量后传递给yq
    yq eval ".metadata.annotations.\"meta.helm.sh/release-name\" = \"$name\" | .metadata.annotations.\"meta.helm.sh/release-namespace\" = \"$namespace\"" -i "$yaml_file"
  fi
done

额外注意事项 #

• 始终用双引号包裹$yaml_file，避免文件名包含空格时出现错误。
• 确保你使用的是mikefarah/yq的v4及以上版本，旧版本语法差异较大。

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