The project Justfile provides recipes for common development, build, and
deployment tasks. Run just --list to see all available recipes or
just <recipe> --help for usage details.
Recipes for managing the SOCKS5 proxy used to reach on-premise clusters from off-site.
| Recipe | Description |
|---|---|
just proxy-up |
Start the SOCKS5 proxy via SSH tunnel to the on-premise jump host |
just proxy-down |
Stop the SOCKS5 proxy tunnel |
just proxy-status |
Check whether the proxy tunnel is running |
just bk <args> |
Run kubectl through the SOCKS proxy (shorthand for proxied kubectl) |
just bcurl <args> |
Run curl through the SOCKS proxy |
General development workflow recipes.
| Recipe | Description |
|---|---|
just dev |
Start all development servers (app + docs) |
just check |
Run quick checks (lint, format, type check) |
just check-full |
Run full validation suite (lint, format, type check, tests, tofu validate) |
just info |
Print project info (versions, paths, git status) |
Recipes for Nix-based builds and maintenance.
| Recipe | Description |
|---|---|
just nix-build |
Build the project with Nix |
just nix-build-container |
Build the OCI container image via nix2container |
just nix-check |
Run nix flake check |
just nix-update |
Update flake inputs |
Infrastructure-as-code recipes for planning and applying changes. Each recipe
takes a stack name argument (e.g., attic, gitlab-runners, runner-dashboard).
| Recipe | Description |
|---|---|
just tofu-init <stack> |
Initialize tofu for a stack |
just tofu-plan <stack> |
Run tofu plan for a stack (looks for {ENV}.tfvars in the stack dir) |
just tofu-apply <stack> |
Apply a saved plan for a stack |
just tofu-deploy <stack> |
Full deploy cycle: init, plan, apply |
just tofu-validate-all |
Validate all initialized stacks and check module formatting |
Note: tofu-plan expects a {ENV}.tfvars file (default dev.tfvars) in
the stack directory. For overlay deployments, create your tfvars there or use
the per-stack Justfiles directly. Set ENV=prod to target production.
Build system recipes for the Bzlmod-based build.
| Recipe | Description |
|---|---|
just bazel-build |
Build all targets (bazel build //...) |
just bazel-test |
Run all tests (bazel test //...) |
just bazel-clean |
Clean Bazel build outputs |
Cluster inspection and debugging recipes. All commands route through the proxy
when HTTPS_PROXY is set.
| Recipe | Description |
|---|---|
just k8s-pods |
List pods in the target namespace |
just k8s-logs |
Tail logs from a pod |
just k8s-describe |
Describe a Kubernetes resource |
just k8s-events |
Show recent events in the namespace |
just k8s-forward |
Port-forward to a pod or service |
Recipes for the SvelteKit runner-dashboard application.
| Recipe | Description |
|---|---|
just app-install |
Install app dependencies with pnpm |
just app-dev |
Start the SvelteKit dev server |
just app-build |
Production build via adapter-node |
just app-test |
Run the test suite (Vitest) |
just app-check |
Run svelte-check (type checking) |
Shortcut recipes for the GitLab Runner infrastructure stack (gitlab-runners).
| Recipe | Description |
|---|---|
just runners-init |
Initialize tofu for the runners stack |
just runners-plan |
Plan changes to the runners stack |
just runners-apply |
Apply changes to the runners stack |
just runners-status [namespace] |
Show pods, HPA, and Helm releases (default: gitlab-runners) |
just runners-logs <runner> [namespace] |
Tail logs from a runner release |
Shortcut recipes for the cache platform stack (tofu/stacks/attic/). This
stack deploys the complete Nix binary cache platform: CNPG Operator, PostgreSQL
cluster, MinIO Operator, MinIO tenant, Attic API server, GC worker, DNS
records, cache init job, warming CronJob, and optional Bazel remote cache.
The stack directory is named attic for state backend compatibility, so
just tofu-deploy attic also works.
| Recipe | Description |
|---|---|
just cache-init |
Initialize tofu for the cache platform stack |
just cache-plan |
Plan changes to the cache platform stack |
just cache-apply |
Apply changes to the cache platform stack |
just cache-deploy |
Full deploy cycle (init + plan + apply) |
just cache-status |
Show cache platform status (pods, operators, storage) |
just cache-health |
Run health check against the Attic API endpoint |
Recipes for the documentation site.
| Recipe | Description |
|---|---|
just docs-dev |
Start the documentation site dev server |
just docs-build |
Build the documentation site for deployment |
Recipes for building the research document.
| Recipe | Description |
|---|---|
just tex |
Compile the TeX research document to PDF |
just tex-clean |
Remove TeX build artifacts |
just tex-watch |
Watch for changes and recompile automatically |