sellpy/circle-ci-base

sellpy/circle-ci-base 镜像文档

镜像概述

sellpy/circle-ci-base 是针对CircleCI环境设计的基础镜像，标签格式为 node<NODE_VERSION>（如 node10.16），用于标准化CI/CD流程中的Node.js运行环境，确保不同项目或阶段使用一致的依赖版本，简化CircleCI配置。

核心功能与特性

• Node.js版本标签化：镜像标签明确包含Node.js版本，便于快速识别和选择所需运行环境（如 node10.16 对应Node.js 10.16版本）。
• 跨平台构建支持：针对Apple Silicon芯片（ARM架构）构建时，可通过 --platform linux/amd64 参数指定x86架构，确保与CircleCI环境兼容。
• 完整Docker流程集成：提供从构建、标记到推送的全流程Docker命令，支持CI/CD基础设施的自动化维护。

使用场景

• CircleCI任务环境：作为Node.js项目在CircleCI中的基础镜像，用于运行构建、测试、部署等CI/CD任务。
• 环境标准化：在多项目或团队间统一Node.js版本，避免因环境差异导致的构建失败。
• 基础镜像更新：用于维护和发布不同Node.js版本的CircleCI基础镜像，支持业务对Node版本的升级需求。

使用方法与配置说明

1. 构建镜像

在Dockerfile所在目录执行构建命令：

bash
docker build .

注意：若在Apple Silicon芯片设备（ARM架构）上构建，需添加平台参数以适配CircleCI的x86环境：

bash
docker build . --platform linux/amd64

2. 获取镜像ID

构建完成后，通过以下命令列出本地镜像，查找新构建的镜像ID（或直接从 docker build 命令输出中获取构建结果ID）：

bash
docker images

3. 创建版本标签

使用镜像ID创建带有Node.js版本的标签，格式为 sellpy/circle-ci-base:node<NODE_VERSION>，其中 <NODE_VERSION> 替换为具体版本号：

bash
docker tag <IMAGE_ID> sellpy/circle-ci-base:node<NODE_VERSION>

示例：若镜像ID为 a1b2c3d4，目标Node版本为10.16，标签命令为：

bash
docker tag a1b2c3d4 sellpy/circle-ci-base:node10.16

4. 推送镜像至仓库

推送标签至Docker仓库，推送前需通过个人Docker账号登录（使用 docker login 命令输入凭证）：

bash
docker push sellpy/circle-ci-base:node<NODE_VERSION>

注意：仅授权用户可推送至 sellpy 命名空间，需确保个人账号拥有仓库写入权限。