The following instructions allow you to build/run Awestruct-based websites such as hibernate.org or in.relation.to within a docker container while still being able to edit your sources locally.
This is not a Docker introduction. At least you will need a running Docker daemon. If you want an intro to Docker, start here
First, go to your local clone of the website:
cd <your locally cloned website>
Then run the container:
docker run --pull always --rm -t -i -u $UID:$GID -p 4242:4242 -v $(pwd):/home/dev/website:rw,Z quay.io/hibernate/awestruct-build-env:latest
Note that, on Linux, you might need to use sudo to execute docker commands. If you want to avoid that have a look here.
Alternatively, with Podman:
podman run --pull always --rm -t -i --userns=keep-id -u $UID:$GID -p 4242:4242 -v $(pwd):/home/dev/website:rw,Z quay.io/hibernate/awestruct-build-env:latest
This will launch a shell from which you can build/run the website.
For example, to serve the website locally:
rake setup
rake clean preview
The website should be accessible at http://localhost:4242.
You can also use this one-liner to run arbitrary commands non-interactively:
docker run --rm=true -t -i -p 4242:4242 --security-opt label:disable -v $(pwd):/home/dev/website quay.io/hibernate/awestruct-build-env:latest "rake setup && rake clean gen[staging]"
See CONTRIBUTING.md