healthium/nutrium

Nutrium项目Docker镜像文档

1. 镜像概述

本镜像为Nutrium项目的官方Docker容器化解决方案，旨在通过容器技术实现Nutrium应用的标准化部署、环境隔离与快速交付。镜像封装了Nutrium项目运行所需的基础环境及依赖组件，确保应用在不同环境中具有一致的运行表现，简化部署流程并提升运维效率。

2. 核心功能与特性

• 标准化部署环境：统一应用运行依赖，避免因环境差异导致的"在我机器上能运行"问题
• 资源隔离：通过容器化技术隔离Nutrium应用与主机系统及其他应用，提升系统安全性与稳定性
• 轻量级部署：镜像体积经过优化，减少资源占用，支持快速拉取与启动
• 跨环境一致性：在开发、测试、生产等不同环境中提供一致的运行环境，降低部署风险
• 易于扩展：支持与容器编排工具（如Kubernetes、Docker Compose）集成，满足应用横向扩展需求

3. 使用场景与适用范围

• 开发环境搭建：供开发人员快速搭建本地Nutrium开发环境，无需手动配置依赖
• 测试环境部署：在CI/CD流程中用于自动化测试，确保代码变更在标准化环境中验证
• 生产环境运行：作为Nutrium应用的生产环境载体，提供稳定、隔离的运行实例
• 演示环境交付：快速部署Nutrium应用演示实例，方便展示功能特性

4. 使用方法与配置说明

4.1 前提条件

• 已安装Docker Engine（推荐版本20.10+）
• 已安装Docker Compose（如使用编排部署，推荐版本2.0+）
• 网络环境可访问Docker镜像仓库（如需要拉取镜像）

4.2 镜像拉取

从Docker仓库拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/nutrium/project:latest

如需指定版本，可替换latest为具体版本号，如：

bash
docker pull docker.xuanyuan.run/nutrium/project:1.0.0

4.3 快速启动（docker run）

使用以下命令快速启动Nutrium应用容器：

bash
docker run -d \
  --name nutrium-app \
  -p 8080:8080 \
  -e NUTRIUM_ENV=production \
  -e DB_CONNECTION_STRING="mysql://user:password@db-host:3306/nutrium" \
  docker.xuanyuan.run/nutrium/project:latest

参数说明：

• --name nutrium-app：指定容器名称为nutrium-app
• -p 8080:8080：端口映射，将容器内8080端口映射到主机8080端口（根据实际应用端口调整）
• -e NUTRIUM_ENV=production：设置环境变量，指定应用运行环境（可选值：development、test、production）
• -e DB_CONNECTION_STRING：设置数据库连接字符串，根据实际数据库配置调整

4.4 Docker Compose部署

创建docker-compose.yml文件，配置如下：

yaml
version: '3.8'
services:
  nutrium-app:
    image: docker.xuanyuan.run/nutrium/project:latest
    container_name: nutrium-app
    restart: always
    ports:
      - "8080:8080"
    environment:
      - NUTRIUM_ENV=production
      - DB_CONNECTION_STRING="mysql://user:password@db-host:3306/nutrium"
      - LOG_LEVEL=info
    volumes:
      - ./data:/app/data  # 挂载数据卷，持久化应用数据
    networks:
      - nutrium-network

networks:
  nutrium-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

4.5 环境变量配置

4.6 数据持久化

为避免容器重启导致数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name nutrium-app \
  -p 8080:8080 \
  -v /host/path/to/data:/app/data \  # 主机目录:/容器内数据目录
  nutrium/project:latest

其中/host/path/to/data为宿主机上用于持久化存储的目录，/app/data为容器内应用数据存储路径（具体路径需根据Nutrium应用实际数据目录调整）。

5. 注意事项

• 生产环境中建议使用指定版本号而非latest标签，确保部署版本可控
• 敏感配置（如数据库密码）建议通过Docker Secrets或环境变量加密方式管理，避免明文暴露
• 容器运行过程中，可通过docker logs nutrium-app查看应用日志
• 如需更新镜像，建议先停止旧容器，拉取新版本镜像后重新启动