在Bash函数中传递YAML内容给kubectl命令遇阻求助

你的代码存在的核心问题 #

• 错误的输入传递方式：你用$(cat <<- END...)会将here-doc的内容作为kubectl的位置参数传入，而不是通过标准输入传递。但kubectl apply -f -是指定从标准输入读取YAML内容，这种写法完全不符合预期。
• YAML缩进错误：<<- END只会移除前导的Tab字符，而你的代码里用的是空格缩进，导致生成的YAML有多余的前导空格，违反YAML的缩进规则（比如metadata下的name需要缩进）。
• 变量展开与格式冲突：你的YAML里metadata下的name没有正确缩进，即使变量展开了也会导致YAML语法错误。

正确实现方式 #

方式1：用管道传递here-doc（和你可行的shell命令逻辑一致） #

直接在函数里通过管道将here-doc内容传给kubectl，同时修正YAML的缩进：

#!/bin/bash

AGENT_NAME="default"

deploy_agent_statefulset() {
  cat <<- END | kubectl apply -n default -f -
kind: ConfigMap
metadata:
  name: $AGENT_NAME
apiVersion: v1
data:
  agent.yaml: |    
    metrics:
      wal_directory: /var/lib/agent/wal
END
}

deploy_agent_statefulset

注意：这里<<- END的前导缩进要用Tab（不是空格），这样END之前的Tab会被移除，保证YAML格式正确。

方式2：用stdin重定向（更简洁） #

通过<< END直接重定向kubectl的标准输入：

#!/bin/bash

AGENT_NAME="default"

deploy_agent_statefulset() {
  kubectl apply -n default -f - << END
kind: ConfigMap
metadata:
  name: $AGENT_NAME
apiVersion: v1
data:
  agent.yaml: |    
    metrics:
      wal_directory: /var/lib/agent/wal
END
}

deploy_agent_statefulset

这种写法不需要管道，直接将here-doc作为kubectl的stdin输入，更高效。如果不需要移除前导缩进，就不用<<-，直接用<< END即可，注意YAML的缩进要严格正确。

方式3：如果需要避免变量意外展开（比如YAML里有$符号） #

如果你的YAML内容包含Bash变量符号（比如$var），不想被展开，可以用单引号包裹的here-doc（<<'END'），但这样$AGENT_NAME也不会被展开，需要提前替换：

#!/bin/bash

AGENT_NAME="default"

deploy_agent_statefulset() {
  cat <<'END' | sed "s/__AGENT_NAME__/$AGENT_NAME/" | kubectl apply -n default -f -
kind: ConfigMap
metadata:
  name: __AGENT_NAME__
apiVersion: v1
data:
  agent.yaml: |    
    metrics:
      wal_directory: /var/lib/agent/wal
END
}

deploy_agent_statefulset

这里用占位符__AGENT_NAME__，然后通过sed替换成变量值，避免YAML里的其他$符号被Bash展开。

关键原理说明 #

• kubectl apply -f -中的-是特殊参数，表示从标准输入读取资源配置，所以必须将YAML内容传入kubectl的标准输入，而不是作为位置参数。
• Bash的here-doc（<< END）会将分界符之间的内容输出到标准输出，通过管道（|）或者stdin重定向（command << END）可以将内容传递给kubectl。

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