🐳 Custom Container Images

For WebEdit development as well as deployment, we maintain several container images.

Pipelines go ‘brrr’

All of the following images are automatically built as part of our CI/CD pipeline and get pushed to the GitLab container registry.

garage-for-tests

This container combines the garage server with a script to automatically set up a cluster of 1 node (the container itself). It also comes packaged with a garage.toml config file including predefined tokens. This image is for automatic tests in CI/CD jobs.

• Files related to this image: container/garage-for-tests

garage-single-node-init

Similarly to the garage-for-tests image, this one contains a script to initialize a single node garage cluster. But it is meant to initialize a volume that can then get taken over by the official garage image. It also does not include a garage.toml, so it needs to be mounted on runtime as a volume. This container is the only custom container required for the dev environment (docker compose) and therefore also available on Dockerhub.

• Files related to this image: container/garage-single-node-init

dashboard

This image contains the built JavaScript of the dashboard and is based off of NGINX. So it is just a webserver hosting the frontend.

• Files related to this image: container/dashboard

Let’s do some baking!

When building the Dashboard, the URL of the Server it tries to connect to gets baked in on build time. So the images built by us all exclusively point to our demo deployment.

server

The server image contains the Bun runtime and a minified version of our server code and hosts the server.

• Files related to this image: container/server

Straight from the source!

Both the dashboard and server images can be built with two Containerfiles! One takes care of the entire build process (Containerfile.buildFromSource) and is meant for building images locally, and the other one assumes the building has already been done (Containerfile.usePrebuiltJs) and is primarily meant to be used in CI/CD jobs where the building has been previously done.

Helpfull Links

• Garage Quickstart Guide
• Dockerfile reference
• Bun’s Guide about Containerizing an Application