docker-circleci 镜像文档

镜像概述和主要用途

用于在CircleCI 2.0上运行容器的基础镜像，旨在支持Web应用Docker镜像的构建、测试和部署流程。该镜像提供了必要的工具环境，使开发者能够在CircleCI 2.0中便捷地执行相关操作。

核心功能和特性

• 内置Python 3：支持运行各类Python脚本，满足自动化任务需求。
• 集成Docker工具链：包含docker和docker-compose工具，支持在CircleCI环境中构建、管理Docker镜像，实现Docker in Docker（DinD）功能。

使用场景和适用范围

适用于需要在CircleCI 2.0持续集成/持续部署（CI/CD）环境中进行Docker镜像构建、测试及部署的Web应用项目。特别适合需要通过Python脚本辅助自动化流程，或依赖Docker Compose管理多服务容器的场景。

详细使用方法和配置说明

在CircleCI配置中使用

在.circleci/config.yml文件中，将作业的Docker镜像设置为bayesimpact/circleci，示例配置如下：

version: 2
jobs:
  build-and-test:
    docker:
      - image: bayesimpact/circleci
    steps:
      - checkout
      - setup_remote_docker
      - run: |
          docker-compose build some-docker-service
          # 使用卷挂载组合Docker服务（CircleCI 2.0原生不支持此功能）
          docker-compose-up-remote-env.sh some-docker-service
          docker exec -t some-docker-service ./some-script-in-the-container.sh
          # 清理带有卷的Docker服务（因某些睡眠进程导致服务持续运行）
          stop-dockers-from-compose-up-remote-env.sh

关键步骤说明

1. 检出代码：通过checkout步骤获取项目代码。
2. 配置远程Docker：使用setup_remote_docker初始化远程Docker环境，支持Docker in Docker。
3. 构建服务：执行docker-compose build some-docker-service构建指定的Docker服务。
4. 启动带卷服务：通过docker-compose-up-remote-env.sh some-docker-service启动带卷的服务（解决CircleCI 2.0原生不支持卷的问题）。
5. 执行容器内脚本：使用docker exec -t some-docker-service ./some-script-in-the-container.sh在运行的容器中执行脚本。
6. 清理服务：通过stop-dockers-from-compose-up-remote-env.sh停止并清理持续运行的服务（因睡眠进程导致服务未自动停止）。