amazon/aws-codebuild-local

AWS CodeBuild本地构建镜像

镜像概述和主要用途

AWS CodeBuild本地构建镜像提供本地代理环境，用于模拟AWS CodeBuild构建环境，支持用户在本地测试和调试构建流程。无需完全配置云端CodeBuild即可验证BuildSpec文件中的命令和设置，帮助开发者在提交代码前发现并解决构建问题，缩短开发周期。

核心功能和特性

• 本地环境模拟：通过本地代理复现AWS CodeBuild构建环境，还原云端构建配置
• 快速调试能力：支持即时排查BuildSpec文件中的命令、参数及依赖问题
• 预提交验证：允许在提交代码前本地执行构建流程，减少云端构建失败概率
• 托管镜像支持：可通过克隆官方仓库在本地构建AWS CodeBuild托管镜像

使用场景和适用范围

• 开发阶段验证构建流程正确性
• 调试BuildSpec文件语法或逻辑错误
• 测试构建命令、环境变量及依赖配置
• 降低云端构建资源消耗，优化开发迭代效率

详细使用方法和配置说明

拉取镜像

使用以下命令拉取签名的本地代理镜像：

bash
docker pull amazon/aws-codebuild-local:latest --disable-content-trust=false

验证镜像SHA

可通过AWS CodeBuild最新发布文档验证镜像SHA值。新镜像版本推送后，文档中的SHA更新可能延迟至少4小时。

运行构建

使用官方提供的https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/codebuild_build.sh%E6%89%A7%E8%A1%8C%E6%9E%84%E5%BB%BA%EF%BC%9A

bash
# 示例：使用脚本运行本地构建
./codebuild_build.sh -i <构建镜像名称> -a <输出目录>

本地构建托管镜像

如需使用AWS CodeBuild托管镜像，可通过以下步骤本地构建：

1. 克隆官方仓库：

   bash
   git clone https://github.com/aws/aws-codebuild-docker-images
   

2. 进入目标镜像目录，执行Docker构建：

   bash
   cd aws-codebuild-docker-images/<镜像类型目录>
   docker build -t <自定义镜像标签> .
   

订阅AWS CodeBuild本地代理更新通知

通过Amazon SNS可接收AWS CodeBuild本地代理新版本发布通知。

订阅步骤

1. 打开Amazon SNS控制台：[***]
2. 导航栏区域选择美国东部（弗吉尼亚北部）（必须选择此区域，因通知主题创建于此）
3. 导航窗格选择订阅
4. 点击创建订阅
5. 在创建订阅对话框中配置：
   • 主题ARN：arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates
   • 协议：选择Email或SMS
   • 终端节点：输入接收通知的***地址（Email）或手机号（SMS需包含区号）
   • 点击创建订阅

若选择Email协议，需打开确认邮件并完成订阅验证。

取消订阅步骤

1. 打开Amazon SNS控制台
2. 导航窗格选择订阅
3. 选中目标订阅，点击操作 > 删除订阅，确认删除即可。

许可证信息

https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/