Elastic Beanstalk无法推送更新代码至EC2的问题求助

问题核心 #

你遇到的情况里，Immutable部署策略下GitLab流水线上传应用版本成功，但现有EC2实例没更新；手动部署正常、新实例能拉到新代码，说明GitLab流水线的部署操作没正确触发EB的Immutable部署流程——Immutable部署本应创建新实例替换旧实例，但流水线仅完成了版本上传，未触发环境更新。

排查修复步骤 #

1. 核对GitLab流水线的EB部署命令 #

确保流水线不仅上传了应用版本，还执行了环境更新命令，且参数正确：

• 用AWS CLI的正确命令示例：

  # 上传新版本（若流水线未包含此步骤）
  aws elasticbeanstalk create-application-version --application-name your-app --version-label v1.0.1 --source-bundle S3Bucket=your-bucket,S3Key=your-app-v1.0.1.zip
  # 触发环境版本更新
  aws elasticbeanstalk update-environment --environment-name your-env --version-label v1.0.1
  

• 用EB CLI的正确命令示例：

  eb deploy your-env --version v1.0.1
  

  注意：如果流水线只执行了版本上传命令，未触发环境更新，EB不会自动部署新版本。

2. 验证Terraform的EB部署策略配置 #

检查aws_elastic_beanstalk_environment资源的setting块，确保Immutable策略配置完整：

resource "aws_elastic_beanstalk_environment" "main" {
  name                = "your-env"
  application_name    = aws_elastic_beanstalk_application.main.name
  solution_stack_name = "64bit Amazon Linux 2 v3.4.10 running Node.js 16"

  setting {
    namespace = "aws:elasticbeanstalk:command"
    name      = "DeploymentPolicy"
    value     = "Immutable"
  }
  setting {
    namespace = "aws:elasticbeanstalk:command"
    name      = "BatchSize"
    value     = "1" # 匹配ASG min_size=1的配置，保证每次替换一个实例
  }
  setting {
    namespace = "aws:autoscaling:asg"
    name      = "MinSize"
    value     = "1"
  }
  setting {
    namespace = "aws:autoscaling:asg"
    name      = "MaxSize"
    value     = "2"
  }
}

如果Terraform未明确设置DeploymentPolicy，EB可能使用默认的Rolling策略，导致和预期行为不符。

3. 对比EB事件日志 #

在AWS控制台的EB环境「事件」页面，对比GitLab部署和手动部署的事件流：

• 手动部署会出现「Starting deployment of new version」「Launching new EC2 instance」「Terminating old EC2 instance」等完整流程
• 如果GitLab部署后仅显示「Application version updated」事件，说明流水线未触发实际的部署流程

4. 检查GitLab的IAM权限 #

确保GitLab流水线使用的IAM角色具备elasticbeanstalk:UpdateEnvironment权限，且权限范围覆盖目标EB环境。权限不足会导致命令返回成功但实际未执行部署操作。

5. 排查ASG生命周期挂钩 #

如果Terraform配置了自定义ASG生命周期挂钩，可能干扰EB的Immutable部署流程。检查aws_autoscaling_lifecycle_hook资源，确保没有阻止实例创建/终止的逻辑。

总结 #

优先排查GitLab流水线是否完整执行了「上传版本+更新环境」两步操作，其次验证Terraform的部署策略配置，最后通过EB事件日志和IAM权限定位问题。

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