基于qduoj的二次开发

部署

操做步骤

这个部分没什么特别要强调的，就是按照 QDUOJ部署上的方法跟着复制粘贴就行了，根本不用动脑子。

可能碰见的问题

部署前

因为在2020年一月后官方正式宣布放弃了对py2的维护，因此如今使用pip时会遇到一些小问题，如下是解决方法。

python3与pip3安装

sudo add-apt-repository ppa:fkrull/deadsnakes
sudo apt-get update
sudo apt-get install python3.7
sudo apt-get install python3-pip #装pip3
复制代码

若提示add-apt-repository: command not found则运行sudo apt-get install python-software-properties便可。

python3版本切换

输入alias python='/usr/bin/python3.7'便可切换python对应版本

其它可能出现的问题

1.ModuleNotFoundError: No module named 'pip._internal'

wget https://bootstrap.pypa.io/get-pip.py https://bootstrap.pypa.io/get-pip.py --no-check-certificate
sudo python3.7 get-pip.py http://get-pip.py/
复制代码

2.如有如下报错

Building wheels for collected packages: cffi
  Building wheel for cffi (setup.py) ... error
  ERROR: Command errored out with exit status 1:
   command: /home/starx/pythonvirtualenv/starxteam/bin/python3 -u -c 'import sys, setuptools, tokenize; sys.argv[0] = '"'"'/tmp/pip-install-0xuyhqlj/cffi/setup.py'"'"'; __file__='"'"'/tmp/pip-install-0xuyhqlj/cffi/setup.py'"'"';f=getattr(tokenize, '"'"'open'"'"', open)(__file__);code=f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' bdist_wheel -d /tmp/pip-wheel-4glw5w36 --python-tag cp37
       cwd: /tmp/pip-install-0xuyhqlj/cffi/
  Complete output (36 lines):
  running bdist_wheel
  running build
  running build_py
  creating build
  creating build/lib.linux-x86_64-3.7
  creating build/lib.linux-x86_64-3.7/cffi
  copying cffi/__init__.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/cparser.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/error.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/vengine_cpy.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/commontypes.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/vengine_gen.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/pkgconfig.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/lock.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/cffi_opcode.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/model.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/recompiler.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/verifier.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/api.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/setuptools_ext.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/ffiplatform.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/backend_ctypes.py -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/_cffi_include.h -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/parse_c_type.h -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/_embedding.h -> build/lib.linux-x86_64-3.7/cffi
  copying cffi/_cffi_errors.h -> build/lib.linux-x86_64-3.7/cffi
  running build_ext
  building '_cffi_backend' extension
  creating build/temp.linux-x86_64-3.7
  creating build/temp.linux-x86_64-3.7/c
  x86_64-linux-gnu-gcc -pthread -DNDEBUG -g -fwrapv -O2 -Wall -g -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2 -fPIC -DUSE__THREAD -DHAVE_SYNC_SYNCHRONIZE -I/usr/include/ffi -I/usr/include/libffi -I/usr/include/python3.7m -I/home/starx/pythonvirtualenv/starxteam/include/python3.7m -c c/_cffi_backend.c -o build/temp.linux-x86_64-3.7/c/_cffi_backend.o
  c/_cffi_backend.c:15:10: fatal error: ffi.h: No such file or directory
   #include <ffi.h>
            ^~~~~~~
  compilation terminated.
  error: command 'x86_64-linux-gnu-gcc' failed with exit status 1
  ----------------------------------------
  ERROR: Failed building wheel for cffi
  Running setup.py clean for cffi
Failed to build cffi
复制代码

尝试安装拓展包sudo apt install build-essential libffi-dev python-dev

部署后

问题 ：部署成功 使用docker ps -a 查看容器状态均为healthy，可是直接访问ip没法查看，显示状态码503。 解决：多是由于对应端口没有开放致使的，在云服务器安全组设置中增长对应端口（80或者443）

前端

本地运行方法

1.安装node.js 这里须要注意一下，由于QDUOJ使用的版本是nodejs version 8.12.0，版本太高可能会产生一些没必要要的错误。 2.运行

npm install
# we use webpack DllReference to decrease the build time,
# this command only needs execute once unless you upgrade the package in build/webpack.dll.conf.js
NODE_ENV=development npm run build:dll

# the dev-server will set proxy table to your backend
export TARGET=http://Your-backend

# serve with hot reload at localhost:8080
npm run dev
复制代码

上面是官方文档的方法，可是推荐使用cnpm来代替npm，cnpm是国内淘宝的镜像，速度相对来讲会快一点。 这里是官方的演示视频

后端

安装所需 Python 模块

cd OnlineJudge
sudo pip install --no-cache-dir -r ./deploy/requirements.txt
复制代码

若是pip install过慢可以使用一下命令，将pip源换至阿里云

sudo pip install --no-cache-dir -r ./deploy/requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
复制代码

初始化数据库和后端

修改./init_db.sh文件的第17和18行修改成

python3.7 manage.py migrate
python3.7 manage.py inituser --username root --password rootroot --action create_super_admin
复制代码

而后执行一下命令

sudo chmod +x init_db.sh
./init_db.sh --migrate
复制代码

同样无报错便可

docker 镜像制做

使用正常方法推送到docker仓库

去阿里云那里申请一个仓库，免费的，把仓库名称写成oj-backend便可。建立成功他会给你一个页面提示你如何上传，很详细。

sudo docker login --username=你的用户名 registry.cn-beijing.aliyuncs.com
复制代码

你刚才建立的镜像ID，可使用docker images查一下，顺便能查到镜像版本号TAG

sudo docker tag [ImageId] registry.这里用阿里云给你提供的便可/oj-backend:[镜像版本号]
sudo docker push registry.这里用阿里云给你提供的便可/oj-backend:[镜像版本号]
复制代码

TAG就是上边须要写的版本号，还有IMAGE ID就是镜像ID。 而后就会开始push完毕就成功上传了。

使用Travis CI 推送到docker仓库

Travis CI 是在软件开发领域中的一个在线的，分布式的持续集成服务，用来构建及测试在GitHub托管的代码。 阮一峰的Travis CI使用教程

使用

1.使用Github帐号在Travis CI登陆 2.在more options中的setting设置本身的docker帐号与密码 而后添加两个环境变量，这个用户名和密码和你的DockerHub帐户是对应的： DOCKER_USERNAME和DOCKER_PASSWORD

接着在Travis CI的script里写入

script:
  - echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin
  - docker build -t 用户名/包名:latest .
  - docker push 用户名/包名:latest
复制代码

经过使用docker ps -a来查看已经运行的镜像状态，docker images来查看本地已经存在的镜像。

推荐阅读

使用GitHub+Travis-CI+Docker打造自动化流水线

Docker的使用--制做本身的镜像

注意事项

在使用docker制做镜像时，若是修改了数据库字段，记得运行python manage.py makemigrations和python manage.py migrate，不然在运行docker-compose up -d以后会发现容器一直自启动。