diff --git a/README.md b/README.md new file mode 100644 index 0000000..883131f --- /dev/null +++ b/README.md @@ -0,0 +1,32 @@ +# Code Forge + +Forgejo instance serving https://forge.karnov.club. + +## Usage + +### Starting / restarting + +```bash +FORGEJO_ROOT=.. FORGEJO_RUNNER_ROOT=... ./start.sh +``` + +`FORGEJO_ROOT` should be a directory with read+write access by the container user, this is where application data will +get stored. + +`FORGEJO_RUNNER_ROOT` should also be read+write accessible and will be where the runner stores data. + +Calling the `start.sh` script will replace the containers if they already exists. + +Note that the runner(s) must be registered and started manually. + +### Stopping + +```bash +./stop.sh +``` + +## Networking + +| Port | Notes | +|---|---| +|`3000`|Web listening port| diff --git a/build.sh b/build.sh new file mode 100644 index 0000000..76a28e6 --- /dev/null +++ b/build.sh @@ -0,0 +1,3 @@ +#!/bin/bash + +echo "Nothing to build!" diff --git a/config.yml b/config.yml new file mode 100644 index 0000000..16d3ae6 --- /dev/null +++ b/config.yml @@ -0,0 +1,84 @@ +log: + level: info + +runner: + file: .runner + # Execute how many tasks concurrently at the same time. + capacity: 1 + # Extra environment variables to run jobs. + envs: + CI: 1 + # Extra environment variables to run jobs from a file. + # It will be ignored if it's empty or the file doesn't exist. + env_file: .env + # The timeout for a job to be finished. + # Please note that the Forgejo instance also has a timeout (3h by default) for the job. + # So the job could be stopped by the Forgejo instance if it's timeout is shorter than this. + timeout: 10m + # Whether skip verifying the TLS certificate of the Forgejo instance. + insecure: false + # The timeout for fetching the job from the Forgejo instance. + fetch_timeout: 5s + # The interval for fetching the job from the Forgejo instance. + fetch_interval: 2s + # The labels of a runner are used to determine which jobs the runner can run, and how to run them. + # Like: ["macos-arm64:host", "ubuntu-latest:docker://node:16-bullseye", "ubuntu-22.04:docker://node:16-bullseye"] + # If it's empty when registering, it will ask for inputting labels. + # If it's empty when execute `deamon`, will use labels in `.runner` file. + labels: [] + +cache: + # Enable cache server to use actions/cache. + enabled: true + # The directory to store the cache data. + # If it's empty, the cache data will be stored in $HOME/.cache/actcache. + dir: "" + # The host of the cache server. + # It's not for the address to listen, but the address to connect from job containers. + # So 0.0.0.0 is a bad choice, leave it empty to detect automatically. + host: "" + # The port of the cache server. + # 0 means to use a random available port. + port: 0 + # The external cache server URL. Valid only when enable is true. + # If it's specified, act_runner will use this URL as the ACTIONS_CACHE_URL rather than start a server by itself. + # The URL should generally end with "/". + external_server: "" + +container: + # Specifies the network to which the container will connect. + # Could be host, bridge or the name of a custom network. + # If it's empty, create a network automatically. + network: "" + # Whether to create networks with IPv6 enabled. Requires the Docker daemon to be set up accordingly. + # Only takes effect if "network" is set to "". + enable_ipv6: false + # Whether to use privileged mode or not when launching task containers (privileged mode is required for Docker-in-Docker). + privileged: false + # And other options to be used when the container is started (eg, --add-host=my.forgejo.url:host-gateway). + options: + # The parent directory of a job's working directory. + # If it's empty, /workspace will be used. + workdir_parent: + # Volumes (including bind mounts) can be mounted to containers. Glob syntax is supported, see https://github.com/gobwas/glob + # You can specify multiple volumes. If the sequence is empty, no volumes can be mounted. + # For example, if you only allow containers to mount the `data` volume and all the json files in `/src`, you should change the config to: + # valid_volumes: + # - data + # - /src/*.json + # If you want to allow any volume, please use the following configuration: + # valid_volumes: + # - '**' + valid_volumes: [] + # overrides the docker client host with the specified one. + # If it's empty, act_runner will find an available docker host automatically. + # If it's "-", act_runner will find an available docker host automatically, but the docker host won't be mounted to the job containers and service containers. + # If it's not empty or "-", the specified docker host will be used. An error will be returned if it doesn't work. + docker_host: "" + # Pull docker image(s) even if already present + force_pull: false + +host: + # The parent directory of a job's working directory. + # If it's empty, $HOME/.cache/act/ will be used. + workdir_parent: diff --git a/start.sh b/start.sh new file mode 100755 index 0000000..882b32a --- /dev/null +++ b/start.sh @@ -0,0 +1,70 @@ +#!/usr/bin/bash + +if [[ -z "$FORGEJO_ROOT" ]]; then + echo "Error: FORGEJO_ROOT must be defined in the environment." + exit 1 +fi + +if [[ -z "$FORGEJO_RUNNER_ROOT" ]]; then + echo "Error: FORGEJO_RUNNER_ROOT must be defined in the environment." + exit 1 +fi + +if [[ -z "$FORGEJO_RUNNER_CONFIG" ]]; then + echo "Using the default runner configuration." +fi + +podman pod create \ + -p 3000:3000 \ + -p 2052:2222 \ + --replace \ + "code-forge" + +# Start app database. + +podman run \ + -td \ + --pod "code-forge" \ + --name "code-forge_db" \ + -v code-forge_db:/var/lib/postgresql/data:Z \ + --replace \ + postgres:16.2 + +# Start webapp. + +podman run \ + -td \ + --name "code-forge_app" \ + --pod "code-forge" \ + -v "$FORGEJO_ROOT"/data:/var/lib/gitea \ + -v "$FORGEJO_ROOT"/config:/etc/gitea \ + -v /etc/timezone:/etc/timezone:ro \ + -v /etc/localtime:/etc/localtime:ro \ + --replace \ + codeberg.org/forgejo/forgejo:1.21.8-0-rootless + +# The runners require the app to be healthy before startup. +response="" +until [[ $response = *"200 OK"* ]]; do + response="$(curl localhost:3000 -s -i | head -1)" + echo "Waiting for app to respond..." +done + +wget -O "$FORGEJO_RUNNER_ROOT"/forgejo-runner https://code.forgejo.org/forgejo/runner/releases/download/v3.3.0/forgejo-runner-3.3.0-linux-amd64 +chmod +x "$FORGEJO_RUNNER_ROOT"/forgejo-runner +wget -O forgejo-runner.asc https://code.forgejo.org/forgejo/runner/releases/download/v3.3.0/forgejo-runner-3.3.0-linux-amd64.asc +gpg --keyserver keys.openpgp.org --recv EB114F5E6C0DC2BCDD183550A4B61A2DC5923710 +gpg --verify forgejo-runner.asc "$FORGEJO_RUNNER_ROOT"/forgejo-runner +rm forgejo-runner.asc + + +if [ -f "$FORGEJO_RUNNER_ROOT/.runner" ]; then + echo "Found runner state." + ( + cd "$FORGEJO_RUNNER_ROOT" || exit + "$FORGEJO_RUNNER_ROOT"/forgejo-runner --config "${FORGEJO_RUNNER_CONFIG:=./config.yml}" daemon & + ) +else + echo "Use $FORGEJO_RUNNER_ROOT/forgejo-runner register ... to register the runner" + echo "Once registered, use $FORGEJO_RUNNER_ROOT/forgejo-runner --config daemon & to start" +fi diff --git a/stop.sh b/stop.sh new file mode 100755 index 0000000..02a7ec6 --- /dev/null +++ b/stop.sh @@ -0,0 +1,5 @@ +#!/usr/bin/bash + +podman pod stop "code-forge" + +echo "WARN: The runner process must be stopped manually since it's not a container."