No description

Find a file

bom 87a18c4010 bump version to: 2.0.4-SNAPSHOT		2024-05-03 12:34:49 +02:00
doc	renamed repo-user and forgejo-repo	2024-03-07 12:23:13 +01:00
infrastructure/build	bump version to: 2.0.4-SNAPSHOT	2024-05-03 12:34:49 +02:00
public	Project skeleton	2022-09-08 15:04:17 +02:00
src	add review comments	2024-03-20 17:41:16 +01:00
.gitignore	[Skip-CI] Ignore eastwood file	2023-11-08 16:14:15 +01:00
.gitlab-ci.yml	build native image	2024-02-19 16:27:32 +01:00
build.py	minor fixes	2024-02-28 10:47:30 +01:00
LICENSE	Project skeleton	2022-09-08 15:04:17 +02:00
package.json	bump version to: 2.0.4-SNAPSHOT	2024-05-03 12:34:49 +02:00
project.clj	bump version to: 2.0.4-SNAPSHOT	2024-05-03 12:34:49 +02:00
README.md	update doc	2024-02-21 18:14:57 +01:00
shadow-cljs.edn	Update deps to use new inline macro	2024-03-29 10:32:04 +01:00

README.md

convention 4 kubernetes: c4k-website

DeltaChat chat over e-mail | team@social.meissa-gmbh.de | Website & Blog

Purpose

GitOps for static generated Websites.

c4k-website generates k8s-manifest for a webserver serving static html.

c4k-website is an example how to create k8s manifests for OneShotDeployments with https://repo.prod.meissa.de/meissa/c4k-common.

Features

convention 4 kubernetes: c4k-website

Serving multiple websites

You can serve many websites, each of can listen to a list of domain names. E.g.

# Config example
websites:
- unique-name: "test.io" 
  fqdns: ["test.de", "test.org", "www.test.de", "www.test.org"]
- unique-name: "example.io"
  fqdns: ["example.org", "www.example.com"]

https & Letsencrypt Certificates

The domain names listed will get their certificates from letsencrypt out of the box.

Ratelimiting

There is a Ratelimit included for each website. This makes it harder to DOS one or all websites served.

Monitoring

Monitoring on GrafanaCloud (or any other grafana) is included out of the box.

GitOps your Websites

If your repository is on a frogejo or gitea repo, we included GitOps. We ask every ten minutes the repo api for new pushed content.

If there is new content we generate the new static html & serve it.

Support Hugo and Cryogene

For static html generation we support cryogen & hugo.

Try out

Click on the image to try out in your browser:

Your input will stay in your browser. No server interaction is required.

You will also be able to try out on cli:

c4k-website src/test/resources/valid-config.yaml src/test/resources/valid-auth.yaml

Usage

Prerequisites:

DNS routes pointing to your k8s cluster.
frogejo or gitea instance for your website repo. In doubt use https://codeberg.org
A git repository with your hugo / cryogene website
- the project provides a generate.sh (maybe your generatoin needs some preprocessing)
- generate.sh deliver its static generated html to target/html

Development & mirrors

Development happens at: https://repo.prod.meissa.de/meissa/c4k-website

Mirrors are:

https://gitlab.com/domaindrivenarchitecture/c4k-website (issues and PR, CI)
https://github.com/DomainDrivenArchitecture/c4k-website

For more details about our repository model see: https://repo.prod.meissa.de/meissa/federate-your-repos