Str8line Node.js Docker镜像文档

镜像概述

Str8line Node.js Docker镜像是一个专为CircleCI环境设计的容器镜像，旨在提供精选的Node.js长期支持（LTS）版本。该镜像通过镜像官方精选的LTS版本，确保在CircleCI的持续集成/持续部署（CI/CD）流程中使用稳定、可靠的Node.js运行环境，满足企业级项目对版本稳定性和长期维护的需求。

核心功能和特性

精选LTS版本

• 仅包含经过筛选的Node.js LTS版本，确保提供稳定、安全且有长期官方支持的运行环境，避免因版本频繁变更带来的兼容性风险。

CircleCI环境兼容

• 针对CircleCI的CI/CD流程进行优化，确保与CircleCI的构建环境、缓存机制及依赖管理工具（如npm、yarn）无缝集成。

官方版本镜像

• 严格镜像官方Node.js LTS版本的代码和配置，保持与官方发布的LTS版本完全一致，确保开发、测试与生产环境的版本统一性。

使用场景和适用范围

CircleCI CI/CD流程

适用于在CircleCI平台上运行Node.js项目的持续集成和持续部署流程，尤其适合需要稳定运行环境的企业级应用。

依赖LTS版本的项目

适用于明确依赖Node.js LTS版本的项目，如需要长期维护的生产系统、对稳定性要求高的业务应用等。

版本一致性需求场景

当团队或项目需要在CI/CD流程中严格控制Node.js版本，确保所有构建和部署使用统一LTS版本时，该镜像可提供可靠支持。

使用方法和配置说明

基本使用（本地测试）

如需在本地测试该镜像，可通过以下docker run命令启动容器：

docker run --rm -it str8line/node:<lts-version-tag> node -v

说明：<lts-version-tag>需替换为具体的LTS版本标签（如lts/18对应Node.js 18.x LTS，lts/20对应Node.js 20.x LTS），具体标签可参考镜像仓库文档。

在CircleCI中配置使用

在CircleCI配置文件（通常为项目根目录下的.circleci/config.yml）中，可将该镜像指定为作业的执行环境。示例配置如下：

version: 2.1
jobs:
  build-and-test:
    docker:
      - image: str8line/node:lts/20  # 使用Node.js 20.x LTS版本
    steps:
      - checkout  # 拉取代码
      - restore_cache:  # 恢复npm依赖缓存（CircleCI优化）
          keys:
            - npm-deps-{{ checksum "package-lock.json" }}
      - run: npm install  # 安装依赖
      - save_cache:  # 保存npm依赖缓存
          paths:
            - node_modules
          key: npm-deps-{{ checksum "package-lock.json" }}
      - run: npm run lint  # 代码检查
      - run: npm test  # 执行测试

workflows:
  main:
    jobs:
      - build-and-test

配置参数说明

版本标签

镜像标签格式通常为lts/<major-version>，其中<major-version>对应Node.js LTS版本的主版本号，例如：

• lts/18：Node.js 18.x LTS版本
• lts/20：Node.js 20.x LTS版本

注：具体可用标签需以镜像仓库实际提供的版本为准。

环境变量

支持与官方Node.js镜像一致的环境变量配置，常用变量包括：

• NODE_ENV：设置Node.js运行环境（如production、development），默认值为development
• NPM_CONFIG_LOGLEVEL：控制npm日志级别（如silent、warn、info）
• YARN_CONFIG_LOGLEVEL：控制yarn日志级别（如silent、warning、info）

依赖缓存配置

在CircleCI中使用时，建议结合CircleCI的缓存机制（如restore_cache和save_cache）优化依赖安装速度，具体配置可参考上述CircleCI示例。