Chef部署环境中安装rbenv后无需重启Shell的解决方案

这个问题我之前部署Ruby环境时也碰到过，核心原因很简单：Chef执行的每个bash资源都是一个独立的子shell会话，你写入.bashrc或.bash_profile的环境变量，只会在新启动的终端会话中生效，而当前正在运行的Chef子shell（包括后续的Chef资源）不会自动加载这些配置。下面给你几个实用的解决方案：

方案1：在调用rbenv的脚本中手动加载环境配置 #

最直接的方式，就是在需要执行rbenv命令的bash资源里，先手动source对应的配置文件，再执行命令。比如你要安装Ruby版本，可以这么写：

bash 'install_and_set_ruby' do
  interpreter "bash"
  cwd '/home/vagrant'
  user 'vagrant'
  code <<-EOH
    # 先加载.bashrc里的rbenv配置
    source ~/.bashrc
    # 安装指定Ruby版本
    rbenv install 3.2.2
    # 设置全局默认版本
    rbenv global 3.2.2
  EOH
end

如果不想依赖.bashrc，也可以直接在脚本里手动设置PATH并初始化rbenv：

bash 'install_and_set_ruby' do
  interpreter "bash"
  cwd '/home/vagrant'
  user 'vagrant'
  code <<-EOH
    export PATH="$HOME/.rbenv/bin:$PATH"
    eval "$(rbenv init -)"
    rbenv install 3.2.2
    rbenv global 3.2.2
  EOH
end

注意：eval "$(rbenv init -)"这一步不能省，它会帮你配置rbenv的shims路径，确保安装的Ruby版本能被正确调用。

方案2：在安装rbenv的同一块脚本中立即生效配置 #

如果你的rbenv安装和后续操作（比如安装ruby-build插件）在同一个bash资源里，可以在写入.bashrc后，立即在当前shell中export环境变量并初始化rbenv，这样同一块脚本里的后续命令就能直接调用rbenv了：

bash 'install_rbenv_with_plugins' do
  interpreter "bash"
  cwd '/home/vagrant'
  user 'vagrant'
  code <<-EOH
    git clone https://github.com/rbenv/rbenv.git ~/.rbenv
    # 写入.bashrc配置
    echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
    echo 'eval "$(rbenv init -)"' >> ~/.bashrc
    # 立即加载配置，供当前脚本使用
    export PATH="$HOME/.rbenv/bin:$PATH"
    eval "$(rbenv init -)"
    # 安装ruby-build插件
    git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
  EOH
end

方案3：通过Chef的environment属性传递环境变量 #

你也可以给需要调用rbenv的bash资源设置environment属性，直接把rbenv的路径加入PATH：

bash 'install_ruby' do
  interpreter "bash"
  cwd '/home/vagrant'
  user 'vagrant'
  # 传递包含rbenv路径的环境变量
  environment ({ 'PATH' => '/home/vagrant/.rbenv/bin:$PATH' })
  code <<-EOH
    eval "$(rbenv init -)"
    rbenv install 3.2.2
    rbenv global 3.2.2
  EOH
end

这种方式的好处是不用依赖.bashrc文件，适合一些不需要持久化环境变量的场景。

避坑提醒 #

不要尝试用source ~/.bashrc的方式让整个Chef运行环境生效——因为Chef本身是在一个主进程中运行，它不会继承子shell的环境变量，每个bash资源都是独立的，所以必须在每个需要调用rbenv的资源里单独处理。

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