如何解决Genexus部署AWS ElasticBeanstalk时的实例配置文件关联错误

问题核心 #

非AWS控制台部署ElasticBeanstalk环境时，必须显式指定实例配置文件（Instance Profile），否则EB会因权限不足销毁环境，触发报错Environment must have instance profile associated with it.

具体解决步骤 #

1. 提前准备IAM实例配置文件

先在AWS IAM中创建符合要求的实例配置文件：

• 创建IAM角色，附加AWSElasticBeanstalkWebTier、AWSElasticBeanstalkWorkerTier或自定义EB权限策略
• 将该角色关联到实例配置文件（记录下实例配置文件名称，后续会用到）

2. 在Genexus中配置实例配置文件参数

有两种可行方式：

方式一：通过.ebextensions配置文件指定

• 在Genexus项目的Web模块根目录或项目根目录下创建.ebextensions文件夹
• 在文件夹内新建01-instance-profile.config文件，写入以下内容：

option_settings:
  aws:autoscaling:launchconfiguration:
    IamInstanceProfile: 你的实例配置文件名称

• 编译Genexus项目时，确保该文件夹和文件被包含在部署包中（默认会自动包含，若有部署排除规则需调整）

方式二：通过Genexus部署命令指定

若使用Genexus命令行工具部署，在部署命令中添加实例配置文件参数：

gxdeploy eb deploy --environment EnvironmentName --instance-profile 你的实例配置文件名称

注：命令格式可能因Genexus版本略有差异，以你使用的版本文档为准

3. 后续操作

• 清理之前被销毁的EB环境残留资源（若有）
• 重新执行Genexus部署流程，此时EB环境会正确关联实例配置文件，避免销毁报错

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