adil22/node-app

simple-hello-world-node-app 镜像文档

镜像概述和主要用途

本镜像为基于Node.js的极简Hello World应用容器化方案，旨在通过最简单的应用场景展示Docker容器化的完整流程。镜像包含一个基础Node.js HTTP服务，启动后可响应HTTP请求并返回"Hello World"文本。主要用于Docker入门学习，帮助用户理解镜像构建、容器运行、端口映射等核心概念。

核心功能和特性

• 轻量级基础：基于Node.js官方node:slim镜像构建，减小镜像体积，优化部署效率
• 零配置启动：内置默认配置，无需额外参数即可快速运行
• 标准HTTP服务：默认监听3000端口，符合HTTP标准协议，支持浏览器和curl直接访问
• 可扩展性：应用代码结构清晰，可作为基础模板修改扩展为复杂Node.js应用
• 跨平台兼容：支持Linux/Windows/macOS等主流Docker运行环境

使用场景和适用范围

• Docker初学者入门实践（学习镜像拉取、容器启停、端口映射等基础操作）
• 容器化教学演示（课堂或技术分享中展示容器化与传统部署的差异）
• CI/CD流程测试（作为最小化应用示例验证流水线有效性）
• Node.js容器化基础学习（了解Node.js应用在容器中的运行机制）

使用方法和配置说明

前提条件

• 已安装Docker Engine（版本20.10+）
• 网络环境可访问Docker Hub（如需拉取基础镜像）

构建镜像（本地构建）

1. 创建项目目录并编写基础文件：

   bash
   mkdir hello-world-node-app && cd hello-world-node-app
   # 创建应用代码文件
   cat > app.js << 'EOF'
   const http = require('http');
   const port = process.env.PORT || 3000;
   const server = http.createServer((req, res) => {
     res.statusCode = 200;
     res.setHeader('Content-Type', 'text/plain');
     res.end('Hello World\n');
   });
   server.listen(port, () => {
     console.log(`Server running on port ${port}`);
   });
   EOF
   # 创建Dockerfile
   cat > Dockerfile << 'EOF'
   FROM node:slim
   WORKDIR /app
   COPY app.js .
   EXPOSE 3000
   CMD ["node", "app.js"]
   EOF
   

2. 构建镜像：

   bash
   docker build -t simple-hello-world-node-app:latest .
   

运行容器

1. 基础运行命令（映射主机3000端口到容器3000端口）：

   bash
   docker run -p 3000:3000 --name hello-world-app simple-hello-world-node-app:latest
   

2. 后台运行模式：

   bash
   docker run -d -p 3000:3000 --name hello-world-app simple-hello-world-node-app:latest
   

访问应用

容器启动后，通过以下方式访问服务：

• 浏览器访问：http://localhost:3000
• 命令行访问：curl http://localhost:3000 响应内容应为：Hello World

停止和清理容器

bash
# 停止容器
docker stop hello-world-app
# 删除容器
docker rm hello-world-app
# （可选）删除镜像
docker rmi simple-hello-world-node-app:latest

Docker部署示例

docker run命令示例

bash
# 基础交互式运行（查看日志输出）
docker run -it -p 3000:3000 simple-hello-world-node-app:latest

# 指定自定义端口映射（主机端口8080映射到容器3000端口）
docker run -p 8080:3000 simple-hello-world-node-app:latest

# 带自动重启策略（容器退出时自动重启）
docker run -d --restart=always -p 3000:3000 --name hello-world-service simple-hello-world-node-app:latest

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  hello-world-app:
    build: .  # 本地构建（如已构建镜像可替换为image: simple-hello-world-node-app:latest）
    ports:
      - "3000:3000"
    container_name: hello-world-app
    restart: unless-stopped  # 除非手动停止，否则容器退出时重启
    # 如需自定义环境变量可添加environment字段
    # environment:
    #   - PORT=3000  # 应用默认监听3000端口，此为示例

使用docker-compose启动：

bash
docker-compose up -d

查看运行状态：

bash
docker-compose ps

停止服务：

bash
docker-compose down