zeplin/amazon-linux-ami

镜像概述和主要用途

该镜像为CircleCI构建环境提供定制化的Amazon Linux基础镜像，基于Amazon Linux系统构建，针对CI/CD流程进行专项优化。通过预装常用构建工具、配置适配CircleCI的系统参数，旨在简化用户在CircleCI平台上的构建环境配置，提高构建效率，确保环境一致性和稳定性。

核心功能和特性

• 系统兼容性：基于官方Amazon Linux系统，确保与Amazon Linux生态工具和库的兼容性，适合AWS相关应用开发场景。
• CI/CD优化：针对CircleCI构建流程优化系统启动速度和资源占用，减少环境初始化时间。
• 工具预装：内置常用构建工具（如Git、Docker、AWS CLI、编译工具链等），避免重复安装步骤。
• 灵活配置：支持通过环境变量或配置文件自定义构建环境参数，满足不同项目需求。
• 安全合规：遵循Amazon Linux安全标准，定期更新系统组件，降低安全风险。

使用场景和适用范围

• AWS应用开发：适用于基于Amazon Linux开发的AWS服务（如EC2、ECS、Lambda等）相关应用的构建和测试。
• 特定系统依赖项目：需要依赖Amazon Linux特有系统库或工具的项目构建任务。
• CircleCI自动化流程：用于CircleCI pipeline中的构建、测试、打包等阶段，替代默认镜像以获得更贴合项目需求的环境。
• 多阶段构建：支持作为基础镜像用于多阶段构建流程，优化最终镜像体积。

使用方法和配置说明

在CircleCI中配置使用

在CircleCI配置文件（.circleci/config.yml）中，通过docker关键字指定该镜像作为构建环境：

yaml
version: 2.1
jobs:
  build:
    docker:
      - image: custom-amazonlinux-ami:latest  # 指定本镜像
    steps:
      - checkout
      - run: echo "Starting build with custom Amazon Linux AMI on CircleCI"
      # 执行具体构建命令（如编译、测试、部署等）

本地测试（Docker环境）

如需本地验证镜像功能，可通过以下命令运行容器：

bash
docker run -it --rm docker.xuanyuan.run/custom-amazonlinux-ami:latest /bin/bash

进入容器后，可直接使用预装工具（如验证AWS CLI版本）：

bash
aws --version  # 验证AWS CLI是否预装
git --version  # 验证Git是否预装

环境变量配置

通过环境变量自定义镜像行为，常用变量说明：

示例：在CircleCI配置中设置环境变量

yaml
jobs:
  build:
    docker:
      - image: custom-amazonlinux-ami:latest
        environment:
          AWS_REGION: us-west-2
          BUILD_CACHE_DIR: /custom/cache
    steps:
      - checkout
      - run: echo "Using AWS region: $AWS_REGION"