Ilios Docker镜像文档

1. 镜像概述与主要用途

本仓库是Ilios官方Docker镜像的托管地，同时提供了将这些镜像协同运行的示例配置。其主要用途是帮助用户在容器化基础设施中部署和运行Ilios应用，通过预配置的容器组件和示例配置文件，简化多组件协同部署流程，降低环境搭建复杂度。

2. 核心功能与特性

2.1 核心功能

• 提供Ilios运行所需的完整容器化组件，支持应用全生命周期管理。
• 集成Docker Compose示例配置，实现多容器（Web服务、数据库等）一键协同启动。
• 镜像自动构建并发布至Docker Hub，确保用户获取最新稳定版本。

2.2 主要特性

• 组件预配置：所有容器均针对Ilios应用场景优化，如MySQL容器已适配Ilios数据结构和依赖。
• 多场景支持：提供开发、演示、管理等不同用途的专用容器，满足多样化需求。
• 环境一致性：通过容器化确保不同环境（开发、测试）的配置一致性，减少"环境差异"问题。

3. 使用场景与适用范围

3.1 适用场景

• 开发环境：供开发人员本地搭建Ilios开发环境，支持代码调试和功能开发。
• 测试环境：快速部署Ilios实例，验证新版本功能或自定义配置的有效性。
• 演示环境：通过预填充数据的演示容器，快速展示Ilios应用功能。

3.2 生产环境注意事项

重要：提供的示例配置文件暂不适用于生产环境。生产环境部署前，需根据实际需求定制配置，重点确保：

• MySQL和Ilios应用数据通过持久化卷（Volume）存储，避免容器移除/替换导致数据丢失。
• 配置安全加固（如网络隔离、密码策略、SSL加密等）。
• 优化性能参数（如资源限制、连接池配置等）。

4. 使用方法与配置说明

4.1 环境准备

1. 克隆或下载本仓库至本地：

   git clone [***]
   cd docker
   

2. 安装Docker Engine和Docker Compose。

4.2 演示环境部署步骤

通过以下命令启动演示环境（包含预配置的Web服务、数据库及演示数据）：

docker-compose -f demo-docker-compose.yml up -d

• 启动后等待数分钟（容器初始化及服务启动需时间）。
• 访问 http://localhost:8000 即可使用Ilios演示实例。

4.3 配置说明

具体配置参数（如端口映射、环境变量、数据卷挂载等）可参考仓库中的 demo-docker-compose.yml 文件。关键配置项说明：

• 数据持久化：示例配置可能未启用持久化卷，生产环境需添加 volumes 配置（如 ./mysql-data:/var/lib/mysql）。
• 端口映射：默认通过 8000 端口暴露Web服务，可通过修改 ports 配置调整（如 80:80 映射至宿主机80端口）。
• 环境变量：敏感信息（如数据库密码）建议通过环境变量注入，避免硬编码在配置文件中。

5. 容器组件说明

所有容器均托管于Docker Hub（[***]

5.1 php-apache

• 用途：提供Ilios Web服务，集成PHP运行环境和Apache服务器，处理HTTP请求并执行Ilios应用代码。

5.2 mysql

• 用途：Ilios应用的数据库服务，已针对Ilios数据结构、权限和性能需求预配置，存储应用核心数据（用户信息、课程数据等）。

5.3 mysql-demo

• 用途：演示环境专用MySQL容器，内置预填充的演示数据（如示例课程、用户账号），简化演示环境搭建。

5.4 php-apache-dev

• 用途：开发环境专用Web容器，包含额外开发工具（如Xdebug）和热重载支持，便于开发人员实时调试代码。

5.5 ssh-admin

• 用途：提供SSH管理接口，支持通过SSH连接容器内部进行配置修改、日志查看或问题排查。