如何在同一AWS CodeDeploy部署组的不同EC2实例部署不同web.config

我之前刚好处理过几乎一模一样的场景——web.config里有几个配置项需要根据实例环境动态调整，同一个部署组里的实例要用上不同的配置。给你三个经过实践验证的方案，你可以根据自己的场景选：

方案1：EC2实例标签+模板替换脚本 #

这是最灵活也最容易维护的方案，核心思路是用标签区分实例，再通过脚本把模板文件替换成对应实例的配置：

• 第一步：给实例打标签
  给每个需要不同配置的EC2实例打上专属标签，比如ConfigProfile=US-East-Web、ConfigProfile=EU-West-Web，标签值对应你的配置分组。

• 第二步：准备模板文件
  把你的web.config改成模板文件web.config.template，把需要动态替换的配置项用占位符标记，比如：

  <add key="ApiEndpoint" value="{{API_ENDPOINT}}" />
  <add key="MaxConnections" value="{{MAX_CONN}}" />
  

  同时在部署包里创建一个configs文件夹，存放每个标签对应的参数文件，比如US-East-Web.config里写：

  API_ENDPOINT=https://api.us-east.example.com
  MAX_CONN=100
  

• 第三步：编写部署后替换脚本
  在CodeDeploy的appspec.yml里，给AfterInstall阶段添加一个脚本（Linux用bash，Windows用PowerShell），逻辑如下：

  1. 获取当前实例的ID和对应的标签值：

     INSTANCE_ID=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)
     CONFIG_PROFILE=$(aws ec2 describe-tags --filters "Name=resource-id,Values=$INSTANCE_ID" "Name=key,Values=ConfigProfile" --query 'Tags[0].Value' --output text)
     

  2. 加载对应配置文件的参数，替换模板里的占位符：

     source /path/to/deployment/configs/$CONFIG_PROFILE.config
     sed -e "s/{{API_ENDPOINT}}/$API_ENDPOINT/g" -e "s/{{MAX_CONN}}/$MAX_CONN/g" /path/to/web.config.template > /path/to/web.config
     

  3. 别忘了给EC2实例的IAM角色加上ec2:DescribeTags权限，不然脚本拿不到标签信息。

方案2：SSM Parameter Store存储实例专属配置 #

如果你的配置比较敏感（比如数据库密码），用SSM参数存储更安全，还能统一管理：

• 第一步：在SSM里创建实例专属参数
  给每个EC2实例创建一个对应的SSM参数，比如路径设为/webapp/config/${INSTANCE_ID}/full-web-config，把该实例完整的web.config内容存进去（支持加密存储）。

• 第二步：编写部署脚本拉取配置
  在appspec.yml的AfterInstall阶段添加脚本：

  INSTANCE_ID=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)
  aws ssm get-parameter --name "/webapp/config/$INSTANCE_ID/full-web-config" --with-decryption --query 'Parameter.Value' --output text > /path/to/web.config
  

  同样要给EC2实例的IAM角色加上ssm:GetParameter权限，如果用了KMS加密，还要加上对应的KMS权限。

方案3：结合CodeDeploy环境变量与实例属性 #

如果你的配置差异只和实例的基础属性（比如可用区、实例类型）相关，可以直接用实例元数据结合CodeDeploy环境变量：

• 在CodeDeploy部署组里提前设置好不同属性对应的环境变量，比如US_EAST_API=https://api.us-east.example.com、EU_WEST_API=https://api.eu-west.example.com。
• 在部署脚本里获取实例的可用区：

  AZ=$(curl -s http://169.254.169.254/latest/meta-data/placement/availability-zone)
  

• 根据可用区选择对应的环境变量值，替换web.config里的配置项。

几个通用注意事项 #

• 不管用哪个方案，都要先在单个测试实例上验证脚本逻辑，没问题再推广到整个部署组。
• 脚本里要加上错误处理，比如获取标签或参数失败时，要输出错误日志，避免部署失败还找不到原因。
• 如果是Windows实例，所有命令要换成PowerShell语法，比如获取实例ID的命令是：

  $instanceId = Invoke-RestMethod -Uri http://169.254.169.254/latest/meta-data/instance-id
  

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