QingdaoU/OnlineJudgeDeploy
1
0
Fork 0
mirror of https://github.com/QingdaoU/OnlineJudgeDeploy.git synced 2024-11-01 04:07:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

update README

Browse Source
This commit is contained in:
zema1 2017-11-29 09:59:42 +08:00
parent 91ab378377
commit 5a988284bf
2 changed files with 13 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
README.md
View File

@ -2,9 +2,9 @@
以下命令都需要 root 用户身份运行，请自行添加 `sudo` 以下命令都需要 root 用户身份运行，请自行添加 `sudo`
- 必要的工具 `apt-get update && apt-get install -y vim python-pip curl git` - 必要的工具 `apt-get update && apt-get install -y vim python-pip curl git`
- 安装 docker `curl -sSL https://get.daocloud.io/docker | sh` - 安装 docker `curl -sSL https://get.daocloud.io/docker | sh`
- 安装 docker-compose `pip install docker-compose` - 安装 docker-compose `pip install docker-compose`
## Windows 系统安装基础环境 ## Windows 系统安装基础环境
@ -17,21 +17,18 @@ Windows 下面安装会有很多坑，经过测试时，Win10 x64下的 `PowerSh
- 启动 `PowerShell`，输入`$env:PWD='{your path}'，{you path}`代表你想安装的目录。注意！目录必须在你共享的盘符中（例如设置`D:\qduoj`）。由于你创建的是临时环境变量，`PowerShell`关闭则临时变量作废，因此每次启动前必须重新设置过。当然你也可以选择在Win的环境变量中永久添加名为`PWD`的环境变量（与JDK设置方法相同） - 启动 `PowerShell`，输入`$env:PWD='{your path}'，{you path}`代表你想安装的目录。注意！目录必须在你共享的盘符中（例如设置`D:\qduoj`）。由于你创建的是临时环境变量，`PowerShell`关闭则临时变量作废，因此每次启动前必须重新设置过。当然你也可以选择在Win的环境变量中永久添加名为`PWD`的环境变量（与JDK设置方法相同）
### 注意 ### 注意
- 因为 Docker 使用了很多 Linux 的特性，所以 Windows上面运行 Docker 实际上通过 `Hyper-V` 新建了一个 Linux 虚拟机，然后在虚拟机里面运行Docker。因此目录的挂载需要进行文件共享设置。`docker-compose.yml` 里面 `volumes` 挂载目录写的是 `$PWD`，这个在 Linux 里面代表当前目录，而 Windows 中默认不存在。
- 因为 Docker 使用了很多 Linux 的特性，所以 Windows上面运行 Docker 实际上通过 `Hyper-V` 新建了一个 Linux 虚拟机，然后在虚拟机里面运行Docker。因此目录的挂载需要进行文件共享设置。`docker-compose.yml` 里面 `volumes` 挂载目录写的是 `$PWD`，这个在 Linux 里面代表当前目录，而 Windows 中默认不存在。
## 准备安装文件 ## 准备安装文件
请选择磁盘空间富余的位置，依次运行下面的命令 请选择磁盘空间富余的位置，依次运行下面的命令
```sh ```sh
git clone -b 2.0 https://github.com/QingdaoU/OnlineJudgeDeploy.git git clone -b 2.0 https://github.com/QingdaoU/OnlineJudgeDeploy.git && cd OnlineJudgeDeploy
cd OnlineJudgeDeploy
git clone https://github.com/QingdaoU/JudgeServer.git
git clone https://github.com/QingdaoU/OnlineJudgeFE.git
git clone -b 2.0 https://github.com/QingdaoU/OnlineJudge.git
``` ```
然后编辑 `docker-compose.yml` 将41行的`JUDGE_SERVER_TOKEN`和第68行的`TOKEN`修改为自定义的值， 两处值必须相同且`=`前后不能有空格 然后编辑 `docker-compose.yml` 将43行的`TOKEN`和第58行的`JUDGE_SERVER_TOKEN`修改为自定义的值， 两处值必须相同且 `=` 前后不能有空格
## 启动服务 ## 启动服务
@ -39,21 +36,14 @@ git clone -b 2.0 https://github.com/QingdaoU/OnlineJudge.git
> 对于非root用户，请用 `sudo -E docker-compose up -d`，否则不会传递当前的 `$PWD` 环境变量。 > 对于非root用户，请用 `sudo -E docker-compose up -d`，否则不会传递当前的 `$PWD` 环境变量。
若想获悉安装进度，运行`docker-compose logs`查看安装日志，当显示结果中出现以下文字时表示安装已成功结束。
```
Congratulations, All have done without errors.
```
## 尽情享用吧 ## 尽情享用吧
通过浏览器访问服务器的80端口，就可以开始使用了。 通过浏览器访问服务器的80端口，就可以开始使用了。后台管理路径为`/admin`, 安装过程中自动添加的超级管理员用户名为`root`，密码为`rootroot`， 请务必及时修改密码。
后台管理默认路径为`/admin`, 安装过程中自动添加的超级管理员用户名为`root`，密码为`rootroot`， 请务必及时修改。
值得一提的是 值得一提的是当前目录中的`data`目录为OJ的数据存储目录，包括数据库、测试用例、头像上传目录等，您可以定期对其做数据备份,其中`./data/log`目录存储了所有模块的日志文件，当有错误发生时您可以查看日志或许详细信息
+ 当前目录中的`data`目录为OJ的数据存储目录，包括数据库、测试用例、头像上传目录等，您可以定期对其做数据备份。
+ 当前目录中的`log`目录为OJ的日志存储目录，您可以在发现问题时查看日志获取详情。
## 定制 ## 定制
2.0版将一些常用设置放到了后台管理中，您可以直接登录管理后台对系统进行基本配置，而无需进行代码改动。
2.0版将一些常用设置放到了后台管理中，您可以直接登录管理后台对系统进行配置，而无需进行代码改动。
若需要对系统进行修改或二次开发，请参照各模块的**README**，修改完成后需自行构建docker镜像并修改`docker-compose.yml`

1
docker-compose.yml
View File

@ -37,7 +37,6 @@ services:
volumes: volumes:
- $PWD/data/backend/test_case:/test_case:ro - $PWD/data/backend/test_case:/test_case:ro
- $PWD/data/judge_server:/log - $PWD/data/judge_server:/log
- $PWD/JudgeServer/server:/code:ro
environment: environment:
- service_url=http://judge-server:8080 - service_url=http://judge-server:8080
- service_discovery_url=http://oj-backend:8000/api/judge_server_heartbeat/ - service_discovery_url=http://oj-backend:8000/api/judge_server_heartbeat/