README.md

This explains how to install a cardano runner for the Hydra project.

This runner is used by our smoke-tests and allows us to keep on disk an, as up to date as possible, cardano-node database.

prepare pre-requisites

Install the following pre-requisites:

• git

For instance on Debian:

sudo apt install git

Prepare the common directory for cardano database:

sudo mkdir -p /srv/var/cardano
sudo chown /srv/var/cardano "$(whoami)"

Add the server as a github runner

In the project settings, go to Actions/Runners and click on New self-hostd runner and follow the procedure.

⚠️ When asked, add the following label to this runner: cardano

Customize github runner for nix

So that the jobs can find nix later, you should customize the runner settings by adding some variables to the .env file:

cat <<EOF >>$HOME/actions-runner/.env
PATH=$HOME/.nix-profile/bin:/nix/var/nix/profiles/default/bin:/usr/local/bin:/usr/bin:/bin
NIX_PROFILES="/nix/var/nix/profiles/default $HOME/.nix-profile"
NIX_SSL_CERT_FILE="/etc/ssl/certs/ca-certificates.crt"
EOF

Install github runner as a systemd unit

So that github runner runs as a daemon on the machine, install it:

sudo ./svc.sh install

You can now start the service:

actions.runner.input-output-hk-hydra.to-remove.service