在cluster.yaml中使用~/.ssh/id_rsa部署Kubernetes集群报错

问题原因 #

YAML配置文件里的波浪号~不会被自动解析为用户主目录，部署Kubernetes集群的工具（如kubeadm、k3s或自定义部署脚本）通常不处理这种shell风格的路径扩展，会直接把~/.ssh/id_rsa当作字面路径查找，因此出现文件不存在的错误。

解决方案 #

1. 使用绝对路径（最直接可靠） #

直接替换为密钥文件的绝对路径，比如你的用户是nikhil，配置修改为：

node_defaults:
  keyfile: "/home/nikhil/.ssh/id_rsa"
  username: "nikhil"

这种方式不依赖工具特性，兼容性最好。

2. 利用环境变量（需工具支持） #

如果你的部署工具支持解析环境变量，可以用$HOME代替~，配置如下：

node_defaults:
  keyfile: "$HOME/.ssh/id_rsa"
  username: "nikhil"

注意：并非所有部署工具都支持环境变量解析，需要先确认所用工具的文档说明。

3. 修改部署脚本（自定义场景） #

如果是自己编写的部署脚本读取YAML配置，可以在脚本中手动扩展波浪号：

• Python脚本示例：

import os
import yaml

with open('cluster.yaml', 'r') as f:
    config = yaml.safe_load(f)
# 扩展路径中的~为绝对路径
config['node_defaults']['keyfile'] = os.path.expanduser(config['node_defaults']['keyfile'])
# 后续使用处理后的配置执行部署逻辑

• Shell脚本示例：

# 从配置文件中提取keyfile路径
KEYFILE=$(grep -A2 node_defaults cluster.yaml | grep keyfile | awk -F': ' '{print $2}' | tr -d '"')
# 扩展波浪号为绝对路径
EXPANDED_KEYFILE=$(eval echo "$KEYFILE")
# 后续部署逻辑使用$EXPANDED_KEYFILE作为密钥路径

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