Official Tycho catalogue: provider-agnostic recipes for popular services (Traefik, cert-manager, Forgejo, Keycloak, Discourse, ChirpStack…)
  • TypeScript 100%
Find a file
2026-11-16 20:11:02 +00:00
.forgejo/workflows Merge branch 'develop' into chore/4-remove-ci-base-image 2026-11-14 15:38:10 +00:00
.tycho fix(modaka-studio): ship the settings the Studio needs to start (#13) 2026-11-16 21:07:59 +01:00
bin feat: platform recipes mail, keycloak, forgejo, forgejo-runner and keda 2026-11-08 23:09:18 +01:00
k8s fix(modaka-studio): ship the settings the Studio needs to start (#13) 2026-11-16 21:07:59 +01:00
.gitignore feat: foundation recipes common, traefik, cert-manager and reloader 2026-11-08 22:56:55 +01:00
.gitleaks.toml feat: foundation recipes common, traefik, cert-manager and reloader 2026-11-08 22:56:55 +01:00
AGENTS.md feat: foundation recipes common, traefik, cert-manager and reloader 2026-11-08 22:56:55 +01:00
CLAUDE.md feat: foundation recipes common, traefik, cert-manager and reloader 2026-11-08 22:56:55 +01:00
LICENSE Initial commit 2026-11-08 21:49:24 +00:00
package.json feat: foundation recipes common, traefik, cert-manager and reloader 2026-11-08 22:56:55 +01:00
README.fr.md fix(modaka-studio): ship the settings the Studio needs to start (#13) 2026-11-16 21:07:59 +01:00
README.md fix(modaka-studio): ship the settings the Studio needs to start (#13) 2026-11-16 21:07:59 +01:00

🇫🇷 Version française

Tycho Catalogue

Official catalogue of Tycho recipes: provider-agnostic Kubernetes recipes for popular services whose publishers do not ship a Tycho recipe (Traefik, cert-manager, Forgejo, Keycloak, Discourse, ChirpStack…).

CI

The catalogue holds no instance value and no secret. Every hostname, e-mail, IP or identifier of a deployment is a ${VARIABLE} placeholder declared in .tycho/repository.json; its value belongs to the operator's private target repository (<org>/<engine>-<provider>-<target>, Tycho RFC-001).

Recipes

Recipe Layer Path Components
common foundation k8s/common scaleway (SBS StorageClasses)
traefik foundation k8s/traefik/base scaleway (load balancer binding), dashboard, default-certificate
cert-manager foundation k8s/cert-manager/base —
reloader platform k8s/reloader —
mail platform k8s/stacks/mail/base —
keycloak platform k8s/stacks/keycloak/base realm-import, theme
forgejo platform k8s/stacks/forgejo/base registry-host, apex-packages; option actions-runner
forgejo-runner platform k8s/stacks/forgejo-runner/base auto-register
keda platform k8s/stacks/keda/base —
turbo-cache platform k8s/stacks/turbo-cache/base —
modaka-studio application k8s/stacks/modaka-studio/base oidc, database-network-policy

Each recipe is described by .tycho/recipes/k8s/<recipe>/package.json (variables, requirements, routes, secrets, data, components); see .tycho/README.md.

Using a recipe from a target repository

Reference a released version, never a branch:

# targets/<target>/stacks/traefik/kustomization.yml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - https://git.qtrn.io/tycho/catalog//k8s/traefik/base?ref=v1.0.0
components:
  - https://git.qtrn.io/tycho/catalog//k8s/traefik/providers/scaleway?ref=v1.0.0
patches:
  # values of the target (until `tycho render` substitutes the placeholders)
  - target: { kind: Service, name: traefik }
    patch: |-
      - { op: replace, path: /spec/loadBalancerIP, value: "203.0.113.10" }

Contributing

  • A recipe never contains a value of one deployment: use a ${VARIABLE} declared in .tycho/repository.json, and an optional component for anything a target may not want.
  • bun run validate builds every recipe alone and with each component, and rejects instance hostnames, e-mails and IPs.
  • GitFlow: branch from develop, pull request to develop; releases are pull requests develop → main, tagged vX.Y.Z.

License

AGPL-3.0-only

Forgejo option actions-runner

Enabling it installs keda and forgejo-runner with the component auto-register: a Job generates the instance runner registration token and an admin token with scope read:admin for the KEDA scaler (service account ci-autoscaler), then writes the Secret forgejo-runner-secret. Nothing to copy from the web UI; delete the Secret to rotate both tokens. Runners are ephemeral Jobs on the dedicated, scale-to-zero runner pool (node label and taint workload=ci-runner).