# 快速配置方法

主要使用 docker 配置，按照官方步驟可以使用 docker image 或是更進階一點的使用 docker-compose

1). 安裝 docker
===
在 linux 中執行以下命令，安裝docker

apt-get install docker.io

可以使用 ```docker info``` 查看目前 docker 資訊與版本

>Note
>
>docker 通常會要求 sudo 權限
>可以透過以下方法來配置
>1. ```sudo groupadd docker```
>2. ```sudo gpasswd -a ${USER} docker``` 將當前user加入docker群組
>3. ```sudo systemctl restart docker``` 重新啟動docker(其餘系統可能會影響，須注意)
>4. ```sudo chmod a+rw /var/run/docker.sock``` 增加訪問和執行權限

2). docker-compose
===
在 linux 中執行以下指令，安裝 docker-compose
其中```1.24.1```為版本號碼

 curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

>note
>若未安裝curl套件可以利用以下方法安裝
>```
>apt-get install curl
>```

安裝完畢後需要給 docker-compose 一些權限

chmod +x /usr/local/bin/docker-compose

3.) cgroup配置
===
因為```judgehost```需要cgroup功能所以需要到host```/etc/default/grub```此檔案
將其內容做以下更改

GRUB_CMDLINE_LINUX_DEFAULT="quiet cgroup_enable=memory swapaccount=1"

4.) docker-compose快速配置方法(使用官方image)
===
在工作目錄底下，建立檔案<font color="#f00">```filename.yaml(有掛volume)```</font>
內容包含以下程式碼(以 domjudge:7.2.0 為範例)：

version: "3"
volumes:
      dj-domserver720: #mount direction或是已存在資料的volume
services:
        # 資料庫會根據配置domjudge的版本不同而有不同版本的需求，可以根據自己的配置而更改，此範例使用 mariadb:10.5.7
        dj-mariadb720:
                image: mariadb:10.5.7
                environment: # 資料庫密碼等設定
                        - MYSQL_ROOT_PASSWORD=rootpw
                        - MYSQL_DATABASE=domjudge
                        - MYSQL_USER=domjudge
                        - MYSQL_PASSWORD=djpw
                networks: #配置網路
                        - dj-db720
                ports: # 定義本機port與container間的對應關係host:container
                        - 13312:3312
                            
                command: # 完成此image設定後要執行的指令，這裡將連線數增加為1000
                        --max-connections=1000
        
        dj-domserver720: # domjudge 主要執行的地方，可以根據需求選擇不同版本的 domjudge image 檔
                image: domjudge/domserver:7.2.0
                volumes: # mount cgroup 與主要工作目錄位置
                        - /sys/fs/cgroup:/sys/fs/cgroup:ro
                        - your_work_dir/domjudge_edu/opt/domjudge:/opt/domjudge
                        
                environment: # 環境設定:時區/資料庫基本資料
                        - CONTAINER_TIMEZONE=Asia/Taipei
                        - MYSQL_ROOT_PASSWORD=rootpw
                        - MYSQL_DATABASE=domjudge
                        - MYSQL_USER=domjudge
                        - MYSQL_PASSWORD=djpw
                networks: # 所連結到的網路(database/judgehost)
                        dj-db720:
                        dj-judgedaemons720:
                depends_on: # 依賴的services，需先等依賴的目標建置好後才會建置此 image 檔
                        - phpmyadmin720
                        - dj-mariadb720
                ports: 
                        - 9292:80
                links: # 可以存取 link 到的 services
                        - dj-mariadb720:mariadb
                restart: always # 自動重啟

        dj-judgehost720: #judgehost主要執行的地方，版本需與domserver相同
                image: domjudge/judgehost:7.2.0
                privileged: true #給予root權限
                container_name: judgedaemon-720
                volumes: #將container內容mount到host工作目錄
                        - /sys/fs/cgroup:/sys/fs/cgroup:ro
                        - /your_work_dir/judgehost720:/opt/domjudge
    
                environment: # 基本參數設定
                        - CONTAINER_TIMEZONE=Asia/Taipei
                        - DAEMON_ID=0
                        - JUDGEDAEMON_PASSWORD=uWttAwgXaAhH6G7W
                networks: # 配置網路
                        - dj-judgedaemons720
                depends_on: # 依賴於domserver，domserver啟動好後才會執行judgehost的image
                        - dj-domserver720
                links: # 透過此網路連結到domserver
                        - dj-domserver720:domserver
                restart: always # 開機時重新啟動
        phpmyadmin720:
                image: phpmyadmin/phpmyadmin
                container_name: myadmin720
                ports:
                        - 9992:80
                networks: 
                        - dj-db720
                environment:
                        - PMA_ARBITRARY=1
                        - PMA_HOST=dj-mariadb720
                links:
                        - dj-mariadb720:db

networks: # 定義網路連結方式
        default:
        dj-db720: # 允許連接到同一橋接網絡的容器進行通信，並隔絕其他容器的網路連線
                driver: bridge
        dj-judgedaemons720:
                driver: bridge
        phpmyadmin720:
                driver: bridge

從 github pull 修改過的 domjudge 與 judgehost 內容到工作目錄底下
<font color="#f00">```git clone https://github.com/ivantsai62/domjudge_edu.git```</font>
<font color="#f00">```git clone https://github.com/ivantsai62/judgehost720.git```</font>

透過docker-compose一鍵建立mariaDB, domserver, judgehost, phpmyadmin
<font color="#f00">```docker-compose -f filename.yaml -p your_project_name up```</font>

架好後會有 admin 預設密碼顯示在 terminal 中，會如以下畫面:

或是到<font color="#f00">```domserver/etc/initial_admin_password.secret```</font>查看 admin 預設密碼

*即可以開始使用!*

>Note
>
>在 container 上掛 volume，好處是可以讓多個 container 對應到同一>個volume且為實體。
>即使 container 消失，volume 內的實體內容也不會直接消失不見，且可以直接修改內容，不用進到 container 內做修改。

<br>