Gabriel Adrian Samfira eec158b32c Add SPA UI for GARM

This change adds a single page application front-end to GARM. It uses
a generated REST client, built from the swagger definitions, the websocket
interface for live updates of entities and eager loading of everything
except runners, as users may have many runners and we don't want to load
hundreds of runners in memory.

Proper pagination should be implemented in the API, in future commits,
to avoid loading lots of elements for no reason.

Signed-off-by: Gabriel Adrian Samfira <gsamfira@cloudbasesolutions.com>

2025-08-16 09:09:13 +00:00

2.4 KiB

Raw Blame History

Building GARM from source

The procedure is simple. You will need to gave go installed as well as make.

First, clone the repository:

git clone https://github.com/cloudbase/garm
cd garm

Then build garm:

make build

You should now have both garm and garm-cli available in the ./bin folder.

If you have docker/podman installed, you can also build a static binary against musl:

make build-static

This command will also build for both AMD64 and ARM64. Resulting binaries will be in the ./bin folder.

Hacking

If you're hacking on GARM and want to override the default version GARM injects, you can run the following command:

VERSION=v1.0.0 make build

Important

This only works for make build. The make build-static command does not support version overrides.

The Web UI SPA

GARM now ships with a single page application. The application is written in svelte and tailwind CSS. To rebuild it or hack on it, you will need a number of dependencies installed and placed in your $PATH.

Prerequisites

Node.js 24+ and npm
Go 1.21+ (for building the GARM backend)
openapi-generator-cli in your PATH (for API client generation)

Installing openapi-generator-cli

Option 1: NPM Global Install

npm install -g @openapitools/openapi-generator-cli

Option 2: Manual Install Download from OpenAPI Generator releases and add to your PATH.

Verify Installation:

openapi-generator-cli version

Hacking on the Web UI

If you need to change something in the webapp/src folder, make sure to rebuild the webapp before rebuilding GARM:

make build-webui
make build

Important

The Web UI that GARM ships with has go generate stanzas that require @openapitools/openapi-generator-cli and tailwindcss to be installed. You will also have to make sure that if you change API models, the Web UI still works, as adding new fields or changing the json tags of old fields will change accessors in the client code.

Changing API models

If you need to change the models in the params/ package, you will also need to regenerate the client both for garm-cli and for the web application we ship with GARM. To do this, you can run:

make generate

You will also need to make sure that the web app still works.

2.4 KiB Raw Blame History