如何在Capistrano部署Symfony时将Bitbucket密钥配置到.env文件中

我之前部署Symfony项目时也碰到过类似的问题，用Capistrano往.env文件里塞敏感变量总是踩坑，给你分享几个亲测有效的解决办法：

方案一：用Capistrano任务手动替换占位符 #

这个方法不需要额外插件，直接通过Shell命令替换.env模板里的变量，稳定性很高：

1. 先在项目根目录创建一个.env模板文件，比如.env.production，里面留好变量占位符：

# .env.production
BITBUCKET_SECRET=$BITBUCKET_SECRET
DATABASE_URL=$DATABASE_URL
# 其他需要的环境变量...

注意不要把这个模板文件里的敏感变量填实，只留占位符即可，并且把它提交到版本控制。

2. 在Capistrano的deploy.rb里添加一个部署任务，用来替换模板里的占位符：

namespace :deploy do
  namespace :env do
    desc "替换.env文件中的环境变量占位符"
    task :update do
      on roles(:app) do
        # 先把模板复制为正式的.env文件
        execute :cp, "#{release_path}/.env.production", "#{release_path}/.env"
        
        # 替换Bitbucket密钥（注意转义$符号，避免Shell解析）
        execute :sed, "-i", "s/\\$BITBUCKET_SECRET/#{fetch(:bitbucket_secret)}/g", "#{release_path}/.env"
        
        # 同理替换数据库链接
        execute :sed, "-i", "s/\\$DATABASE_URL/#{fetch(:database_url)}/g", "#{release_path}/.env"
      end
    end
  end

  # 把这个任务挂在代码部署完成之后执行
  after "deploy:updated", "deploy:env:update"
end

3. 传递敏感变量：
   不要把密钥硬编码在deploy.rb里，建议通过本地环境变量传递。比如部署时执行：

BITBUCKET_SECRET=你的密钥 DATABASE_URL=你的数据库链接 cap production deploy

然后在deploy.rb开头加上：

set :bitbucket_secret, ENV['BITBUCKET_SECRET']
set :database_url, ENV['DATABASE_URL']

方案二：修正envsubst的用法（解决你之前的失败问题） #

你之前用envsubst没成功，大概率是因为没有把本地的环境变量正确传递到服务器的执行环境中。试试这个写法：

1. 同样先准备好.env.production模板文件，和方案一一样。

2. 在deploy.rb里添加任务：

namespace :deploy do
  namespace :env do
    desc "用envsubst替换.env中的变量"
    task :substitute do
      on roles(:app) do
        # 先确保服务器上安装了envsubst（Debian/Ubuntu系统）
        execute :which, "envsubst" do |_, status|
          if status.exit_code != 0
            execute :sudo, :apt, :install, "-y", "gettext-base"
            # 如果你用CentOS/RHEL，替换成：execute :sudo, :yum, :install, "-y", "gettext"
          end
        end

        # 把需要的变量传递给服务器，再执行envsubst替换
        execute "BITBUCKET_SECRET=#{fetch(:bitbucket_secret)} DATABASE_URL=#{fetch(:database_url)} envsubst < #{release_path}/.env.production > #{release_path}/.env"
      end
    end
  end

  after "deploy:updated", "deploy:env:substitute"
end

这个写法的关键是：在执行envsubst前，先把要替换的变量临时注入到服务器的Shell环境中，这样envsubst才能找到对应的变量值来替换模板里的$BITBUCKET_SECRET和$DATABASE_URL。

额外注意事项 #

• 永远不要把.env文件提交到版本控制，确保.gitignore里包含.env
• 如果是Symfony项目，替换完.env后建议加上缓存清理的步骤，比如在deploy.rb里添加：

after "deploy:env:update", "symfony:console", "cache:clear", "--no-warmup"
after "deploy:env:update", "symfony:console", "cache:warmup"

（前提是你已经安装了capistrano/symfony插件）

备注：内容来源于stack exchange，提问作者Alexandre Grué