k8s cluster documentation and supporting files
  • Shell 80.3%
  • JavaScript 8.8%
  • Smarty 6.6%
  • PHP 4.3%
Find a file
Renovate Bot b7bcac2476
Some checks failed
build / lint (push) Has been cancelled
Lock file maintenance (#962)
Co-authored-by: Renovate Bot <bot@kriese.eu>
Co-committed-by: Renovate Bot <bot@kriese.eu>
2025-12-08 02:02:10 +00:00
.forgejo/workflows Update data.forgejo.org/renovate/renovate Docker tag to v42.39.2 (#957) 2025-12-08 00:02:45 +00:00
.husky chore: add more linting 2024-11-11 15:16:19 +01:00
bin test: allow updating snapshots 2025-09-17 14:01:05 +02:00
docs feat(next-instances): autogenerate password 2025-11-11 11:55:54 +01:00
flux digest update 2025-12-08 01:16:33 +00:00
k3s-host fix: docs related to installing a new k8s node (#795) 2025-09-29 12:03:58 +00:00
.editorconfig chore: add more linting 2024-11-11 15:16:19 +01:00
.gitignore chore: add more linting 2024-11-11 15:16:19 +01:00
.lintstagedrc.json chore: add more linting 2024-11-11 15:16:19 +01:00
.markdownlint-cli2.cjs chore: add more linting 2024-11-11 15:16:19 +01:00
.node-version Update nodejs to v24 (major) (#915) 2025-11-21 13:34:10 +00:00
.npmrc chore: add more linting 2024-11-11 15:16:19 +01:00
.prettierignore feat(static-site): support nginx config 2025-11-19 09:11:24 +01:00
.prettierrc.json chore: more linting 2024-11-11 15:16:19 +01:00
.sops.yaml feat(flux): enable sops age (#877) 2025-11-07 13:42:07 +00:00
.sourceignore ci: add chart test (#741) 2025-09-04 09:01:36 +00:00
LICENSE Initial commit 2024-10-23 05:37:31 +00:00
package.json Update dependency prettier to v3.7.4 (#956) 2025-12-07 00:01:47 +00:00
pnpm-lock.yaml Lock file maintenance (#962) 2025-12-08 02:02:10 +00:00
README.md chore: document how to deploy a new static web site (#811) 2025-10-09 09:15:20 +00:00
renovate.json chore(renovate): update team reviewer (#934) 2025-11-26 08:22:05 +00:00

There is a dedicated chatroom. A mirror of this repository is available at https://codeberg.org/forgejo/k8s-cluster, pushed on every commit using a token from forgejo-k8s-cluster-mirror which is a service account listed as a collaborator.

Table of content

Monitoring

Cluster monitoring will send warnings to a private Matrix chatroom dedicated to this purpose. The error messages may contain sensitive information. They should not but they are error messages after all and that possibility cannot be dismissed.

The forgejo-matrix-devops account on matrix.org is associated with the matrix-devops at forgejo.org email which is an alias to contact. The password, session keys etc. are not stored anywhere. If there ever is a need for manual interaction with this account, the password will have to be reset.

The monitors related to a deployment (v*.next for instance) should be removed before removing the instance to avoid false negative.

hetzner{05,06}

https://hetzner05.forgejo.org & https://hetzner06.forgejo.org run on EX44 Hetzner hardware.

Nodes of a k8s cluster.

Development

Install following tools locally:

  • node
  • pnpm or enable corepack
  • helm
  • flux
  • yq

Run pnpm install after code checkout to prepare development. This installs git hooks to fix simple lint issues.

You can run pnpm lint to run all lint checks.

Hacking

Evaluate a Forgejo helm release to verify the output is as expected before submitting a pull request, for instance after changing flux/apps/forgejo-code/forgejo-code.yaml.

  • helm template -f <(yq .spec.values forgejo-code.yaml) oci://code.forgejo.org/forgejo-helm/forgejo

Note that although flux build kustomization forgejo-code --path ./flux/clusters --kustomization-file ./flux/clusters/forgejo-code.yaml --dry-run will work, it will not call helm template and is not useful in that context.