gengjiawen/node-build

Node.js构建Docker镜像

![CircleCI]([***]

镜像概述和主要用途

Node.js构建Docker镜像是一个专为Node.js项目构建流程设计的容器化环境，提供完整的构建工具链和远程调试支持。该镜像旨在简化Node.js项目的构建过程，无需在主机环境中配置依赖，同时支持与IDE（如CLion）集成的远程调试场景。

核心功能和特性

• 内置Node.js项目构建所需的基础工具和依赖环境
• 支持本地项目目录挂载，直接在容器内执行构建命令
• 提供远程调试专用版本（:remote标签），集成SSH服务
• 支持sys_ptrace系统调用权限，满足调试器进程跟踪需求
• 轻量级设计，适合集成到自动化构建流程

使用场景和适用范围

• Node.js项目的本地化构建，避免主机环境依赖冲突
• 需通过CLion等IDE进行远程调试的Node.js开发工作流
• CI/CD管道中作为Node.js项目的标准化构建环境

详细的使用方法和配置说明

本地项目构建

将主机项目目录挂载到容器中，执行构建命令：

bash
docker run --rm --name build-node -v $PWD:/pwd -w /pwd gengjiawen/node-build bash -c "./configure && make -j4"

参数解析：

• --rm：构建完成后自动清理容器
• --name build-node：自定义容器名称为build-node
• -v $PWD:/pwd：挂载主机当前目录到容器内/pwd路径
• -w /pwd：设置容器工作目录为挂载的项目路径
• bash -c "./configure && make -j4"：依次执行项目配置和多线程编译（4线程）

CLion远程调试环境

启动支持远程调试的后台容器，供CLion连接：

bash
docker run -d --cap-add sys_ptrace -p 2222:22 --name clion_remote_env gengjiawen/node-build:remote

参数解析：

• -d：以守护进程模式运行容器
• --cap-add sys_ptrace：添加进程跟踪权限，支持调试器功能
• -p 2222:22：映射容器SSH端口22到主机2222端口（CLion默认远程调试端口）
• --name clion_remote_env：自定义容器名称为clion_remote_env
• gengjiawen/node-build:remote：使用带远程调试支持的remote标签镜像