withinboredom/nodejs

nodejs 镜像文档

镜像概述

nodejs镜像是一个用于在容器中运行Node.js应用的Docker镜像，基于Ubuntu系统构建，并集成了s6进程管理工具。该镜像继承自smebberson/ubuntu-base，提供了便捷的Node.js应用启动方式，并通过s6确保应用在崩溃时自动重启，提升应用可靠性。

核心功能与特性

• 基于Ubuntu系统：构建于Ubuntu基础镜像，提供稳定的运行环境
• s6进程管理：集成s6工具，自动启动Node.js应用并在其崩溃时重启
• 标准日志支持：支持通过Docker标准日志命令查看应用输出（如console.log）
• 灵活部署：可轻松集成用户的Node.js源代码和依赖管理流程

使用场景

适用于需要在容器环境中稳定运行的Node.js应用场景，包括：

• Web服务应用
• API服务
• 后台任务处理程序
• 微服务组件

使用方法与配置说明

基础使用

在Dockerfile中继承此镜像：

dockerfile
FROM smebberson/nodejs

应用部署步骤

1. 添加应用源代码
   将Node.js应用代码复制到容器中，建议放置在/app目录：

   dockerfile
   COPY . /app
   

2. 安装依赖
   使用npm安装应用所需依赖：

   dockerfile
   RUN cd /app && npm install
   

3. 配置s6进程管理
   通过以下步骤配置s6以管理应用启动：

   • 创建s6配置目录（需位于/etc/s6/下，名称可自定义）：

     dockerfile
     RUN mkdir -p /etc/s6/app
     

   • 创建run文件并赋予执行权限，文件内容为应用启动命令：

     dockerfile
     RUN echo '#!/usr/bin/env bash\ncd /app\nexec node server.js' > /etc/s6/app/run && chmod +x /etc/s6/app/run
     

   注：上述示例假设应用入口文件为server.js，需根据实际情况调整

4. 暴露端口
   根据应用需求暴露端口，例如暴露3000端口：

   dockerfile
   EXPOSE 3000
   

构建与运行示例

完整Dockerfile示例：

dockerfile
FROM smebberson/nodejs

# 复制应用代码
COPY . /app

# 安装依赖
RUN cd /app && npm install

# 配置s6启动脚本
RUN mkdir -p /etc/s6/app && \
    echo '#!/usr/bin/env bash\ncd /app\nexec node server.js' > /etc/s6/app/run && \
    chmod +x /etc/s6/app/run

# 暴露端口
EXPOSE 3000

构建镜像：

bash
docker build -t my-nodejs-app .

运行容器：

bash
docker run -d -p 3000:3000 my-nodejs-app

日志查看

应用通过console.log输出的日志可通过Docker标准日志命令查看：

bash
docker logs <容器ID或名称>

异常处理建议

为确保应用稳定性，建议处理未捕获异常：捕获异常、记录日志并退出进程，由s6自动重启应用。示例代码：

javascript
process.on('uncaughtException', function (e) {
    console.log('未捕获异常:', e);
    process.exit(1); // 退出进程，s6将自动重启
});

参考链接

• s6进程管理工具
• Docker日志命令文档