Astria校园管理系统(ACMS)镜像文档

镜像概述

Astria校园管理系统(ACMS)是Astria Learning开发的功能丰富的学校管理系统，旨在简化从入学到毕业的学生信息管理流程。本镜像包含运行该应用所需的所有依赖（Ruby、二进制文件、Gems等），但不包含应用源代码或数据库引擎，必须配合MySQL 5.7或兼容的MariaDB数据库部署。

核心依赖与版本

部署要求

必要条件

• 源代码部署：应用源代码需从内部Git仓库部署至主机的/srv/acms_app目录，并将该目录映射到容器的/acms目录（强制步骤，镜像通过符号链接配置支持附件处理）。
• 数据库：必须部署MySQL 5.7或兼容的MariaDB数据库。

安装与部署步骤

内部代码仓库包含用于部署所需服务的docker-compose.yml文件。初始安装请按以下步骤执行：

部署命令序列

# 1. 克隆代码仓库至主机目录并进入
git clone ***:astrialearning/acms-v2.git /srv/acms && cd /srv/acms

# 2. 复制环境变量示例文件并编辑（配置数据库等参数）
cp .env.example .env && nano .env

# 3. 构建Docker镜像
docker-compose build

# 4. 编辑Rails凭据（如需指定编辑器）
docker-compose run --rm -e EDITOR=nano acms bin/rails credentials:edit

# 5. 数据库初始化（创建数据库、执行迁移、填充种子数据）
docker-compose run --rm acms bundle exec rake db:create db:migrate db:seed 

# 6. 预编译静态资产
docker-compose run --rm acms bundle exec rake assets:precompile

# 7. 启动服务（后台运行）
docker-compose up -d

关键配置说明

• 环境变量：.env文件需配置必要参数（如数据库连接信息、应用密钥等），具体参考.env.example。
• 数据库配置：MySQL需添加以下sql_mode配置：

  sql_mode = 'NO_AUTO_VALUE_ON_ZERO,STRICT_TRANS_TABLES,STRICT_ALL_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION'
  

技术支持

如在镜像使用过程中遇到问题，请联系：***