livingdocs/node

livingdocs/node Docker 镜像文档

概述

livingdocs/node 是一个优化的 Docker 镜像，基于官方 Node.js 镜像构建，专为运行 Livingdocs 应用程序而设计。Livingdocs 是一个现代化的内容管理系统 (CMS)，专注于协作编辑和内容发布。该镜像提供了预配置的环境，包括必要的依赖项和工具，以简化 Livingdocs 应用程序的部署流程。

核心功能和特性

• 基于官方 Node.js 镜像：确保与 Node.js 生态系统的兼容性和稳定性
• 预配置依赖：包含运行 Livingdocs 所需的系统依赖和 Node.js 模块
• 非 root 用户运行：默认使用非特权用户增强安全性
• 环境变量支持：通过环境变量轻松配置应用程序设置
• 日志处理：优化的日志输出配置，便于集成到日志管理系统

使用场景

• 开发环境：快速搭建本地 Livingdocs 开发环境
• 测试环境：一致的测试环境配置，确保测试结果的可靠性
• 生产环境：简化 Livingdocs 应用程序的生产部署流程
• CI/CD 流水线：集成到持续集成和持续部署流程中

使用方法

基本用法

使用以下命令运行容器：

bash
docker run --rm -it livingdocs/node

运行 Livingdocs 应用程序

假设您的 Livingdocs 应用程序代码位于当前目录：

bash
docker run -d \
  --name livingdocs-app \
  -p 3000:3000 \
  -v $(pwd):/app \
  -e NODE_ENV=production \
  livingdocs/node \
  npm start

Docker Compose 示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  livingdocs:
    image: livingdocs/node
    ports:
      - "3000:3000"
    volumes:
      - ./app:/app
    environment:
      - NODE_ENV=production
      - DB_HOST=db
      - DB_USER=livingdocs
      - DB_PASSWORD=secret
      - DB_NAME=livingdocs
    depends_on:
      - db
  db:
    image: postgres:13
    environment:
      - POSTGRES_USER=livingdocs
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=livingdocs
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

启动服务：

bash
docker-compose up -d

环境变量配置

以下环境变量可用于配置容器：

持久化数据

为了持久化应用程序数据和配置，建议挂载以下目录：

• /app：应用程序代码目录
• /app/node_modules：Node.js 依赖项
• /app/data：应用程序数据（如果应用程序使用此路径）

构建自定义镜像

如果需要自定义镜像，可以创建 Dockerfile：

dockerfile
FROM livingdocs/node

# 安装额外依赖
RUN apt-get update && apt-get install -y \
  some-package \
  && rm -rf /var/lib/apt/lists/*

# 添加自定义配置
COPY custom-config.json /app/config/

构建并运行：

bash
docker build -t my-livingdocs-node .
docker run --rm -it my-livingdocs-node

故障排除

权限问题

如果遇到文件权限问题，可以尝试调整挂载目录的权限，或通过环境变量 NODE_USER=root 临时以 root 用户运行（仅用于调试）。

应用程序启动失败

检查容器日志以获取详细错误信息：

bash
docker logs <container-id>

确保所有必要的环境变量都已正确设置，并且应用程序代码已正确挂载。

相关链接

• Livingdocs 官方网站
• https://github.com/livingdocsIO
• https://hub.docker.com/_/node