搭建Bitbucket流水线实现配置文件自动部署至EFS的技术问询

核心结论 #

完全可以实现，核心思路是通过Bitbucket Pipeline触发自动化流程，将仓库中更新的配置文件同步到已挂载EFS的Ubuntu服务器（或直接同步到EFS），确保EFS上的配置始终与Bitbucket仓库保持一致。

1. 前置准备：完成EFS与Ubuntu服务器的挂载 #

这是实现同步的基础，先确保EFS已正确挂载到服务器：

• 在AWS控制台创建EFS文件系统，配置安全组允许Ubuntu服务器通过NFS协议（端口2049）访问
• 在Ubuntu服务器安装NFS客户端：sudo apt-get install nfs-common
• 创建挂载目录（例如/mnt/app-config），执行挂载命令：sudo mount -t nfs4 <EFS文件系统ID>.efs.<AWS区域>.amazonaws.com:/ /mnt/app-config
• 配置/etc/fstab实现开机自动挂载，添加一行：<EFS文件系统ID>.efs.<AWS区域>.amazonaws.com:/ /mnt/app-config nfs4 defaults,_netdev 0 0

2. 配置Bitbucket Pipeline实现自动同步 #

Bitbucket Pipeline会在配置文件推送到仓库时触发，通过SSH连接到Ubuntu服务器，将仓库中的配置同步到EFS挂载目录。

步骤1：配置Bitbucket仓库变量

进入仓库「设置」→「Pipeline」→「变量」，添加以下敏感信息（设为「安全变量」避免泄露）：

• SERVER_IP：Ubuntu服务器的公网/私网IP（优先用VPC内网IP提升安全性）
• SERVER_USER：服务器的SSH登录用户名（例如ubuntu）
• SSH_PRIVATE_KEY：服务器的SSH私钥（需提前将对应公钥添加到服务器~/.ssh/authorized_keys）

步骤2：编写bitbucket-pipelines.yml配置

在仓库根目录创建该文件，示例配置如下：

image: atlassian/default-image:3

pipelines:
  default:
    - step:
        name: Sync config to EFS
        deployment: production
        script:
          # 安装SSH客户端
          - apt-get update && apt-get install -y openssh-client
          # 配置SSH免密登录
          - mkdir -p ~/.ssh
          - echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
          - chmod 600 ~/.ssh/id_rsa
          - ssh-keyscan $SERVER_IP >> ~/.ssh/known_hosts
          # 同步仓库中config目录的所有文件到EFS挂载点
          - scp -r ./config/* $SERVER_USER@$SERVER_IP:/mnt/app-config/
          # 可选：重启Node应用使新配置生效
          - ssh $SERVER_USER@$SERVER_IP "sudo systemctl restart your-node-app.service"

3. 可选优化方案 #

• 直接同步到EFS（跳过服务器中转）：如果将Bitbucket Runner部署在AWS VPC内，可直接将EFS挂载到Runner，同步时直接把仓库文件复制到EFS挂载目录，减少中转环节
• 版本回滚机制：利用Git版本记录，在Pipeline中添加回滚逻辑，若同步失败则自动恢复到上一个稳定版本的配置
• 权限适配：确保EFS挂载目录的权限与Node应用运行用户一致，例如执行chown -R node:node /mnt/app-config，避免应用无法读取配置

注意事项 #

• 确保Bitbucket Pipeline的IP段被允许访问Ubuntu服务器的SSH端口（22），可在服务器安全组添加Bitbucket官方IP段，或通过VPC peering实现内网访问
• 敏感配置（如数据库密码、API密钥）不要直接存入Git仓库，应使用Bitbucket安全变量存储，在Pipeline中动态生成配置文件

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