technekes/circleci

CircleCI构建镜像

镜像概述和主要用途

这是一个基于Alpine的Docker镜像，满足CircleCI 2.0主镜像的https://circleci.com/docs/2.0/custom-images/#required-tools%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E5%8C%85%E5%90%AB%60docker%60%E5%92%8C%60docker-compose%60%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%85%81%E8%AE%B8%E6%9E%84%E5%BB%BA%E8%BF%87%E7%A8%8B%E7%9B%B4%E6%8E%A5%E5%88%A9%E7%94%A8%E7%8E%B0%E6%9C%89Docker%E9%85%8D%E7%BD%AE%EF%BC%8C%E7%AE%80%E5%8C%96%E5%AE%B9%E5%99%A8%E5%8C%96%E9%A1%B9%E7%9B%AE%E5%9C%A8CircleCI%E7%8E%AF%E5%A2%83%E4%B8%AD%E7%9A%84%E6%9E%84%E5%BB%BA%E6%B5%81%E7%A8%8B%E3%80%82

核心功能和特性

• 基于Alpine Linux，具有轻量级、高效的特点
• 完全符合CircleCI 2.0主镜像的必要工具要求
• 内置docker和docker-compose，无需额外安装即可使用容器化构建工具
• 可无缝集成到CircleCI配置文件中，支持标准CI/CD工作流

使用场景和适用范围

适用于CircleCI 2.0环境下的持续集成/持续部署(CI/CD)任务，特别适合需要使用Docker和Docker Compose进行应用构建、测试和部署的项目。可广泛应用于微服务架构、多容器应用以及需要容器化环境的自动化构建流程。

使用方法和配置说明

基本配置步骤

在.circleci/config.yml配置文件中，将此镜像指定为主要构建镜像，然后添加所需的docker-compose命令步骤。

完整配置示例

yaml
version: 2
jobs:
  build:
    docker:
      - image: technekes/circleci:alpine

    working_directory: /tmp/app

    steps:
      - checkout  # 检出代码仓库
      - setup_remote_docker  # 配置远程Docker环境

      - run:
          name: 构建镜像
          command: |
            docker-compose build

      - run:
          name: 运行测试
          command: |
            docker-compose run ci

配置说明

1. 指定镜像：在docker部分设置image: technekes/circleci:alpine作为主构建镜像
2. 工作目录：通过working_directory指定构建工作目录（示例中为/tmp/app，可根据项目需求调整）
3. 关键步骤：
   • checkout：从代码仓库检出源代码
   • setup_remote_docker：初始化远程Docker环境，支持Docker命令执行
   • 构建步骤：使用docker-compose build命令构建项目镜像
   • 测试步骤：通过docker-compose run ci执行测试（ci为docker-compose配置中定义的测试服务名）

使用注意事项

• 确保项目中存在有效的docker-compose.yml配置文件
• setup_remote_docker步骤是使用Docker命令的必要前提
• 可根据项目需求添加更多run步骤，执行如docker-compose push推送镜像等操作