codacy/ci-aws

ci-aws

镜像概述和主要用途

ci-aws是一个适用于CircleCI等持续集成(CI)环境的Docker镜像，内置与AWS交互的工具，旨在简化CI流程中与AWS相关的操作，如资源部署、配置管理等。

核心功能和特性

• 预装awscli等与AWS交互的必备工具
• 支持在CI环境中配置AWS凭证及角色切换
• 兼容CircleCI等主流CI平台的运行环境

使用场景和适用范围

适用于需要在持续集成流程中执行AWS相关操作的场景，例如：

• 部署AWS云资源
• 管理S3存储桶
• 配置IAM角色和权限
• 执行AWS CloudFormation或Sceptre等工具命令

使用方法和配置说明

CircleCI配置示例

直接在CircleCI配置中使用该镜像执行步骤：

yaml
version: 2
jobs:
  build:
    working_directory: /app
    docker:
      - image: codacy:ci-aws:1.0.0
    steps:
      - checkout
      - setup_credentials:
          name: 配置AWS凭证
          command: |
            mkdir -p ~/.aws && touch ~/.aws/credentials
            cat >> ~/.aws/credentials << EOF
            [default]
            aws_access_key_id=$ACCESS_KEY_ID
            aws_secret_access_key=$SECRET_ACCESS_KEY
            [ci_role]
            source_profile = default
            role_arn = arn:aws:iam::$PRODUCTION_AWS_ACCOUNT_ID:role/$PRODUCTION_ROLE
            EOF
      - run:
          name: 获取新版本
          command: sceptre lunch-env dev
          environment:
            AWS_PROFILE: ci_role

环境变量说明

• ACCESS_KEY_ID: AWS访问密钥ID
• SECRET_ACCESS_KEY: AWS密钥
• PRODUCTION_AWS_ACCOUNT_ID: 生产环境AWS账户ID
• PRODUCTION_ROLE: 要切换的IAM角色名称
• AWS_PROFILE: 指定使用的AWS凭证配置文件

构建和发布

通过CircleCI流水线

当代码推送到远程仓库时，CircleCI流水线会自动部署该镜像。

本地构建与发布

可使用Makefile在本地执行构建和发布操作：

bash
$ make help
---------------------------------------------------------------------------------------------------------
构建和部署帮助
---------------------------------------------------------------------------------------------------------
build                          构建Docker镜像
get-next-version-number        获取下一个版本号
git-tag                        为当前提交打上版本标签并推送
push-docker-image              将Docker镜像推送到仓库（需设置DOCKER_USER和DOCKER_PASS）
push-latest-docker-image       将Docker镜像以"latest"标签推送到仓库（需设置DOCKER_USER和DOCKER_PASS）

注意：执行推送操作前需确保已设置环境变量DOCKER_USER和DOCKER_PASS。