canerko/node-demo

简单Hello World Node.js应用Docker镜像

镜像概述

本镜像包含一个基于Node.js 18和Express框架的简单Hello World应用，运行在Red Hat UBI9基础镜像上。该镜像旨在提供一个基础的Docker部署示例，展示Node.js应用的容器化过程。

核心功能和特性

• 基础环境：基于Red Hat UBI9（Universal Base Image 9）和Node.js 18运行时
• Web服务：使用Express框架提供HTTP服务
• 安全配置：以非root用户（default）运行应用，遵循容器安全最佳实践
• 端口暴露：默认暴露3000端口，用于接收HTTP请求
• 简化部署：包含完整的Dockerfile构建流程，支持快速构建和运行

使用场景

• Docker容器化入门学习示例
• Node.js应用基础部署演示
• 容器镜像构建流程教学
• 轻量级Web服务测试环境

使用方法

构建镜像

1. 将Dockerfile和应用代码（包含index.js和package.json）放在同一目录
2. 执行构建命令：

   bash
   docker build -t hello-world-nodejs .
   

运行容器

基本运行

bash
docker run -d -p 3000:3000 --name hello-world-app hello-world-nodejs

查看应用

容器启动后，通过浏览器或curl访问 http://localhost:3000 即可看到Hello World响应。

Dockerfile解析

dockerfile
# 使用Red Hat UBI9的Node.js 18基础镜像
FROM registry.access.redhat.com/ubi9/nodejs-18

# 设置工作目录
WORKDIR /opt/app-root/src

# 切换到非root用户
USER default

# 复制依赖文件并安装依赖
COPY --chown=default package.json ./
RUN npm install

# 复制应用代码
COPY --chown=default . .

# 暴露服务端口
EXPOSE 3000

# 启动应用
CMD [ "node", "index.js" ]

应用代码要求

应用需包含以下基本文件：

• package.json：需包含express依赖，示例：

  json
  {
    "name": "hello-world",
    "version": "1.0.0",
    "dependencies": {
      "express": "^4.18.2"
    }
  }
  

• index.js：Express应用入口文件，示例：

  javascript
  const express = require('express');
  const app = express();
  const port = 3000;
  
  app.get('/', (req, res) => {
    res.send('Hello World!');
  });
  
  app.listen(port, () => {
    console.log(`Example app listening on port ${port}`);
  });