Skip to content

Latest commit

 

History

History
111 lines (90 loc) · 4.89 KB

README.md

File metadata and controls

111 lines (90 loc) · 4.89 KB
Raw

CHipCie Startup scripts

This repository contains docker compose files, shell scripts, and example environments to start systems used during the programming contests.

domserver

  • Rename the env file to remove the .example extension:
cp domserver.env.example domserver.env
  • Open domserver.env and update the MYSQL_PASSWORD to a strong password.
  • Optionally, Add a printer:
    • Get a printer URL via linuxprint.tudelft.nl
      • Login using the CH account, Go to Driver Print > Linux.
      • Select Advanced, click Continue and select Follow Me Employee > Follow Me.
      • Scroll down to the url that looks similar to ipps://linuxprint.tudelft.nl:443/ipp/r/abc/def.
    • Copy this and update PRINTER_URL
  • Start domserver
docker compose up -d

DOMjudge is now running on port 8080. The default password for the admin user is in the logs. These can be accessed using:

docker compose logs

Add the -f flag to follow the logs live.

The database can also be accessed through phpMyAdmin on port 8081.

judgehost

To run a Judgehost, use the start-judgehost.sh script.

  • Run the script with a number as the argument. The container will be limited to that cpu core, starting from 0. Example:
./start-judgehost.sh 0
  • See the help: 
    Start a judgehost container on a certain core
Usage: ./start-judgehost.sh [-h|--help] [-u|--domserver-baseurl <arg>] [-p|--password <arg>] [-c|--container <arg>] [-v|--version <arg>] <cpu-core>
	<cpu-core>: Which cpu core to run the judgehost container on
	-h, --help: Prints help
	-u, --domserver-baseurl: Baseurl of the DOMserver (default: 'https://dj.chipcie.ch.tudelft.nl/')
	-p, --password: Password of the judgehosts in the domserver (leave empty for prompt) (no default)
	-c, --container: Docker container to use as judgehost (default: 'ghcr.io/wisvch/domjudge-packaging/judgehost')
	-v, --version: Version of the container (default: '8.2.0')

You can run multiple judgehosts on one machine if desired. Make sure to leave enough resources for the machine itself.

judgehost on ubuntu

Use start-judgehosts-gui.sh to start multiple judgehosts on ubuntu. It will ask for the necessary information in a GUI and lock each judgehost to a different core.

judgehost in the google cloud

To run the judgehosts in the cloud, start them using the following command:

gcloud compute instances create judgehost-1 --project=chipcie --zone=europe-west4-a --machine-type=e2-medium --metadata=judgehost_password=CHANGEME,startup-script=wget\ https://raw.github.com/WISVCH/chipcie-startup-scripts/main/start-judgehost-gcp.sh\ -v\ -O\ start-judgehost-gcp.sh\ \&\&\ chmod\ \+x\ start-judgehost-gcp.sh\ \&\&\ ./start-judgehost-gcp.sh\;\ rm\ -rf\ start-judgehost-gcp.sh --create-disk=auto-delete=yes,boot=yes,image=projects/ubuntu-os-cloud/global/images/ubuntu-minimal-2204-jammy-v20220712,size=10

You should change the CHANGEME to the judgehost password. This will use the start-judgehost-gcp.sh script to start a judgehost on a VM. It will install all the dependencies, and then reboot and start the judgehost. This takes a few minutes.

Start multiple at the same time using:

gcloud compute instances create judgehost-1 judgehost-2 judgehost-3 judgehost-4 --project=chipcie --zone=europe-west4-a --machine-type=e2-medium --metadata=judgehost_password=CHANGEME,startup-script=wget\ https://raw.github.com/WISVCH/chipcie-startup-scripts/main/start-judgehost-gcp.sh\ -v\ -O\ start-judgehost-gcp.sh\ \&\&\ chmod\ \+x\ start-judgehost-gcp.sh\ \&\&\ ./start-judgehost-gcp.sh\;\ rm\ -rf\ start-judgehost-gcp.sh --create-disk=auto-delete=yes,boot=yes,image=projects/ubuntu-os-cloud/global/images/ubuntu-minimal-2204-jammy-v20220712,size=10

ICPC tools CDS

  • Rename the cds directory to remove the .example extension:
cp -r cds.example cds
  • Create a user in DOMjudge with the role API reader and Source code reader.
  • Update these credentials in cds/config/cdsConfig.xml
  • Optionally, add another contest in this file for the test session.
  • Update the credentials in cds/config/accounts.yaml
  • Start the CDS using:
docker compose up -d
  • Photos or promo material can be added in the cds/config/present/photos and cds/config/present/promo directories.
  • Affiliantion logos can be put in the cds/contest*/organizations directories, which you can automatically do with the download_affiliations_with_background.sh script in cds.
  • A logo and a banner can be put in cds/contest*/contest/logo.png and cds/contest*/contest/banner.png.

Port bindings

The folowing ports are used by the containers:

Service Port
domserver 8080
mariadb 13306
phpmyadmin 8081
domserver spectator 8082
mariadb spectator 13307
phpmyadmin spectator 8083
csd http 8084
csd https 8443
icinga http 8085