circle-ci-base 镜像文档

概述

circle-ci-base 是一个集成了Node.js、Docker和Docker Compose的基础镜像，旨在为服务提供统一的构建、测试和部署环境，特别适用于CI/CD流程（如CircleCI）中的服务基础镜像。

核心功能与特性

• 集成Node.js环境：提供Node.js运行时环境，支持JavaScript/TypeScript项目的依赖安装、代码构建和脚本执行。
• 内置Docker引擎：包含完整的Docker客户端和服务端组件，支持容器镜像的构建、推送和运行管理。
• 预装Docker Compose：集成Docker Compose工具，支持多容器应用的配置编排、服务启动和依赖管理。

使用场景与适用范围

• 作为CI/CD流程（尤其是CircleCI环境）中的基础镜像，用于服务的自动化构建、测试和部署流程。
• 适用于需要Node.js开发环境同时依赖Docker容器化部署的服务项目。
• 提供一致的开发、测试和生产环境，减少因环境差异导致的构建或运行问题。

使用方法与配置说明

镜像拉取

通过以下命令从镜像仓库拉取最新版本：

docker pull circle-ci-base:latest

基本使用示例

运行容器并进入交互式终端：

docker run -it --rm circle-ci-base:latest /bin/bash

在CircleCI配置中使用

在.circleci/config.yml中指定该镜像作为执行环境：

version: 2.1
jobs:
  build-and-deploy:
    docker:
      - image: circle-ci-base:latest
    steps:
      - checkout
      - run: npm install  # 使用Node.js安装项目依赖
      - run: npm run build  # 执行构建脚本
      - run: docker build -t my-service:${CIRCLE_SHA1} .  # 构建Docker镜像
      - run: docker-compose -f docker-compose.prod.yml up -d  # 启动生产环境服务

注意事项

• 该镜像作为基础环境镜像，建议根据具体服务需求在其基础上构建自定义镜像。
• 运行时需确保容器具有足够权限（如Docker守护进程访问权限）以正常使用Docker功能。