apluslms/run-gitmanager

Gitmanager 镜像文档

镜像概述和主要用途

Gitmanager是A+生态系统中的核心服务，用于构建和验证课程，并配置生态系统中的其他服务。课程通过Git加载后，在可配置容器内自动构建，验证通过后将课程及习题配置到A+平台和兼容的评分服务。该应用基于Django 5.2（配置文件路径：gitmanager/settings.py）开发，要求Python 3.10及以上版本。

Gitmanager可独立运行（无需完整栈环境），便于在本地系统环境中测试流程的任意环节。构建并发布后，课程和习题配置存储在COURSES_PATH目录（默认路径为courses）。

核心功能和特性

• Git课程加载：通过Git将课程文件下载至BUILD_PATH目录
• 自动构建与验证：在可配置容器内自动构建课程并进行验证
• 课程存储与发布：
  • 构建成功的课程复制到STORE_PATH目录（仅用于存储，未发布状态）
  • A+平台获取并更新课程配置时触发发布，将课程从STORE_PATH复制到COURSES_PATH（发布后可用状态）
• 独立运行能力：支持脱离完整栈环境运行，便于本地开发测试

使用场景和适用范围

• A+ LMS平台课程开发与测试
• 教育机构课程配置管理
• 本地环境中课程构建流程验证
• A+生态系统服务集成测试

使用方法和配置说明

开发环境安装

可通过Docker运行应用，无需在本地安装完整软件栈。推荐使用https://github.com/apluslms/aplus-manual%E8%AF%BE%E7%A8%8B%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B%EF%BC%8C.github/workflows%E4%B8%AD%E7%9A%84Dockerfile%E5%8C%85%E5%90%AB%E8%BF%90%E8%A1%8C%E6%89%80%E9%9C%80%E7%9A%84%E5%85%A8%E9%83%A8%E9%85%8D%E7%BD%AE%E3%80%82

Ubuntu 20.04环境部署步骤

1. 克隆软件

安装通用依赖：

bash
sudo apt-get install git libjpeg-dev
sudo apt-get install libxml2-dev libxslt-dev zlib1g-dev

克隆源码：

bash
git clone https://github.com/apluslms/gitmanager.git

2. Python环境配置

安装Python依赖：

bash
sudo apt-get install python3 python3-dev python3-pip python3-venv

创建虚拟环境并安装依赖：

bash
python3 -m venv venv
source venv/bin/activate
pip install wheel
pip install -r gitmanager/requirements.txt

3. 运行Gitmanager应用

bash
cd gitmanager
python manage.py runserver

4. 课程和习题配置

详见courses/README.md

完整栈安装（Ubuntu 20.04）

0. 创建服务用户

在服务器环境中，建议为gitmanager创建专用系统用户：

bash
sudo adduser --system --group \
  --shell /bin/bash --home /srv/gitmanager \
  --gecos "A-plus gitmanager service" \
  gitmanager
su - gitmanager

注意：创建用户后，需先完成上述"开发环境安装"步骤，再继续以下配置。

1. Web服务器配置

创建Socket临时目录

bash
echo "d /run/gitmanager 0750 gitmanager www-data - -" | \
  sudo tee /etc/tmpfiles.d/gitmanager.conf > /dev/null
sudo systemd-tmpfiles --create

uWSGI与systemd配置（Ubuntu >= 15.04）

安装uWSGI：

bash
source ~/venv/bin/activate
pip install uwsgi
cp ~/gitmanager/doc/etc-uwsgi-gitmanager.ini ~/gitmanager-uwsgi.ini
sudo cp ~/gitmanager/doc/etc-systemd-system-uwsgi.service /etc/systemd/system/gitmanager-uwsgi.service

配置文件编辑：

• 编辑~/gitmanager-uwsgi.ini设置正确的目录和用户
• 编辑/etc/systemd/system/gitmanager-uwsgi.service，在ExecStart中设置正确的uwsgi路径

服务管理：

bash
# 查看状态
systemctl status gitmanager-uwsgi
# 启动服务
systemctl start gitmanager-uwsgi
# 设置开机自启
systemctl enable gitmanager-uwsgi
# 平滑重启应用
touch ~/gitmanager-uwsgi.ini

Nginx配置

bash
apt-get install nginx
sed -e "s/__HOSTNAME__/$(hostname)/g" \
  ~/gitmanager/doc/etc-nginx-sites-available-gitmanager > \
  /etc/nginx/sites-available/$(hostname).conf
ln -s ../sites-available/$(hostname).conf /etc/nginx/sites-enabled/$(hostname).conf
# 必要时编辑配置文件
# 检查配置有效性
nginx -t
# 重新加载Nginx
systemctl reload nginx

Apache2配置

bash
apt-get install apache2 libapache2-mod-uwsgi
# 根据doc/etc-apache2-sites-available-gitmanager配置站点
a2enmod headers

部署详情

完整部署指南参见文档目录中的DEPLOYMENT.md。

关键配置路径说明

• COURSES_PATH：已发布课程存储目录，默认路径为courses
• BUILD_PATH：课程构建工作目录，用于临时存放从Git下载的课程文件
• STORE_PATH：构建成功课程的存储目录（未发布状态）