单体GitHub项目集成AWS CodeBuild按需部署问题咨询

一、CodeBuild跨脚本传递动态环境变量的正确方式 #

你之前遇到的环境变量失效问题，本质是CodeBuild的每个阶段（install/pre_build/build）都是独立的Shell进程，直接export的变量不会被后续阶段继承。正确的做法是把变量写入CodeBuild官方提供的环境变量加载文件：

# 在01_install.sh中，不要用export，而是写入这个文件
echo "export SHOULD_INSTALL=true" >> /codebuild/output/env.sh
echo "export DEPLOY_API=false" >> /codebuild/output/env.sh

CodeBuild会在每个阶段启动前自动加载/codebuild/output/env.sh里的变量，后续的02_prebuild.sh、03_build.sh直接用$SHOULD_INSTALL这类变量就可以了，无需额外处理权限。

二、更优雅的按需部署方案 #

比起用文件存标识，结合Git diff判断变更模块是更可靠的方式，步骤如下：

1. 在pre_build阶段检测变更：
   在02_prebuild.sh里加入Git diff逻辑，对比当前提交和上一次成功部署的提交（如果是首次部署可以对比HEAD~1）：

   # 获取变更的文件列表
   CHANGED_FILES=$(git diff --name-only HEAD~1 HEAD)
   
   # 初始化部署标记
   DEPLOY_API=false
   DEPLOY_REACT=false
   
   # 判断变更是否涉及API模块
   if echo "$CHANGED_FILES" | grep -q "^API/"; then
       DEPLOY_API=true
   fi
   
   # 判断变更是否涉及React模块
   if echo "$CHANGED_FILES" | grep -q "^REACTAPP/"; then
       DEPLOY_REACT=true
   fi
   
   # 写入环境变量文件
   echo "export DEPLOY_API=$DEPLOY_API" >> /codebuild/output/env.sh
   echo "export DEPLOY_REACT=$DEPLOY_REACT" >> /codebuild/output/env.sh
   

2. 在build阶段按需执行部署：
   在03_build.sh里根据标记执行对应操作：

   if [ "$DEPLOY_API" = "true" ]; then
       echo "开始部署API到Elastic Beanstalk..."
       # 你的API部署命令，比如eb deploy
   fi
   
   if [ "$DEPLOY_REACT" = "true" ]; then
       echo "开始部署静态文件到S3..."
       # 你的S3同步命令，比如aws s3 sync REACTAPP/build/ s3://your-bucket/
   fi
   

也可以直接在buildspec.yml的commands里用条件判断，减少脚本依赖：

build:
  commands:
    - |
      if [ "$DEPLOY_API" = "true" ]; then
        eb deploy your-eb-environment
      fi
    - |
      if [ "$DEPLOY_REACT" = "true" ]; then
        aws s3 sync REACTAPP/build/ s3://your-react-bucket --delete
      fi

三、解决CodeBuild未预装EB CLI的问题 #

CodeBuild的标准镜像默认没有EB CLI，你可以在install阶段手动安装：

# 针对Ubuntu-based镜像
pip install awsebcli --upgrade --user
# 将EB CLI加入PATH（--user安装的路径在~/.local/bin）
echo "export PATH=\$PATH:~/.local/bin" >> /codebuild/output/env.sh
# 验证安装
eb --version

如果是Amazon Linux镜像，可以先用yum install python3-pip -y安装pip，再执行上面的命令。

四、修复.ebextensions不生效的问题 #

这个问题通常和部署包结构或配置语法有关，按以下步骤排查：

1. 确认部署包结构：.ebextensions目录必须在Elastic Beanstalk部署包的根目录，而不是API子目录下。打包时要把API代码和.ebextensions一起打包：

   zip -r deploy-api.zip API/ .ebextensions/
   

2. 验证配置语法：用EB CLI本地验证配置文件：

   eb validate .ebextensions/
   

3. 查看EB日志：在Elastic Beanstalk控制台的「日志」选项里下载完整日志，搜索.ebextensions相关的错误信息（比如权限不足、脚本执行失败等），针对性修复。
4. 确认平台兼容性：比如你用的是Node.js平台，.ebextensions里的container_commands要符合Node.js环境的要求，避免用其他平台的配置语法。

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