node 镜像文档

镜像概述和主要用途

countingup/node 是一个基于 node:22-alpine 的轻量级Docker镜像，旨在为CI/CD作业提供开箱即用的工具支持。该镜像在保持最小化体积的同时，集成了开发和部署流程中常用的实用工具，减少了CI环境中额外安装依赖的步骤，提升自动化流水线效率。

核心功能和特性

基础环境

• 底层镜像：基于官方 node:22-alpine，包含Node.js 22运行时和Alpine Linux轻量级系统，确保基础环境稳定且体积小巧。

集成工具集

• bash：提供完整shell环境，支持复杂脚本逻辑
• coreutils：基础系统工具集（如ls、cp、mv等），满足文件操作需求
• git：版本控制工具，支持代码拉取、提交检查等操作
• ssh client：远程服务器连接工具，用于跨主机部署或文件传输
• lftp：支持FTP/FTPS/SFTP等协议的文件传输工具
• GNU make：构建自动化工具，通过Makefile定义和执行构建流程
• AWS cli：亚马逊云服务命令行工具，支持S3、ECS等服务操作
• zip：文件压缩工具，用于打包构建产物
• jq：轻量级JSON处理器，支持解析、过滤和转换JSON数据

使用场景和适用范围

• CI/CD流水线：适用于GitHub Actions、GitLab CI、Jenkins等主流CI平台，作为作业运行环境
• 自动化构建部署：结合make、git和ssh实现代码拉取、构建、打包和远程部署全流程自动化
• 云服务交互：通过AWS cli执行云资源管理、构建产物上传（如S3）等任务
• 数据处理任务：使用jq解析API响应或配置文件，配合bash脚本实现数据处理逻辑
• 跨环境文件传输：通过lftp或ssh在CI环境与远程服务器/存储服务间传输文件

使用方法和配置说明

基础运行示例

验证镜像环境及工具版本：

docker run --rm countingup/node:12 sh -c "node -v && git --version && aws --version && jq --version"

在CI配置中使用（以GitHub Actions为例）

在.github/workflows/main.yml中定义作业：

jobs:
  build:
    runs-on: ubuntu-latest
    container: countingup/node:12
    steps:
      - name: Checkout code
        run: git clone [***] .
      
      - name: Install dependencies
        run: npm install
      
      - name: Build project
        run: make build
      
      - name: Package and upload
        run: |
          zip -r build.zip dist/
          aws s3 cp build.zip s3://your-bucket/ --region us-east-1

环境变量配置

Node.js相关环境变量

继承自node:22-alpine，支持标准Node.js环境变量：

• NODE_ENV：设置运行环境（如production、development）
• NODE_OPTIONS：自定义Node.js运行参数（如--max-old-space-size=4096）

工具认证配置（以AWS cli为例）

通过环境变量传递AWS凭证：

docker run --rm \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=your-secret-key \
  -e AWS_REGION=us-west-2 \
  countingup/node:12 \
  aws ec2 describe-instances  # 示例：查询EC2实例信息

挂载本地目录（开发调试）

挂载本地项目目录到容器，实现代码实时同步：

docker run --rm -v $(pwd):/app -w /app countingup/node:12 sh -c "npm run dev"

注意事项

• 镜像标签：建议使用具体版本标签（如:12）而非:latest，避免因基础镜像更新导致环境变化
• 工具版本：工具版本随node:22-alpine基础镜像更新，如需固定版本，可基于此镜像构建自定义版本
• 安全最佳实践：敏感信息（如AWS密钥）优先通过CI平台的密钥管理功能注入，避免硬编码在配置文件中
• 权限控制：运行容器时避免使用--privileged权限，必要时通过--user指定非root用户运行