https://github.com/madic-creates/k3s-git-ops

Private Kubernetes homelab environment - Operated through Kustomize & ArgoCD
https://github.com/madic-creates/k3s-git-ops

ansible argocd devops k3s k8s k8s-at-home kubernetes kustomize

Last synced: about 2 months ago
JSON representation

Private Kubernetes homelab environment - Operated through Kustomize & ArgoCD

• Host: GitHub
• URL: https://github.com/madic-creates/k3s-git-ops
• Owner: madic-creates
• Created: 2024-10-25T14:06:38.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-29T04:25:19.000Z (about 1 year ago)
• Last Synced: 2025-03-29T05:22:29.857Z (about 1 year ago)
• Topics: ansible, argocd, devops, k3s, k8s, k8s-at-home, kubernetes, kustomize
• Language: Shell
• Homepage: https://madic-creates.github.io/k3s-git-ops/
• Size: 3.62 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 10
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# GitOps managed Kubernetes Home Cluster

*Faciliating ArgoCD and supported via RenovateBot* :robot:



[![k3s](https://img.shields.io/badge/k3s-v1.31.4-blue?style=for-the-badge&logo=kubernetes&logoColor=white)](https://k3s.io/)

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled?logo=pre-commit&logoColor=white&style=for-the-badge&color=brightgreen)](https://github.com/pre-commit/pre-commit)

[![renovate](https://img.shields.io/badge/renovate-enabled?style=for-the-badge&logo=renovatebot&logoColor=white&color=brightgreen)](https://github.com/renovatebot/renovate)

[![documentation](https://img.shields.io/badge/Docs-grey?style=for-the-badge&logo=materialformkdocs)](https://madic-creates.github.io/k3s-git-ops/)



## 🌎 Overview

This repository is a playground for my Kubernetes Home Cluster.

It uses [ArgoCD](https://github.com/argoproj/argo-cd) as a GitOPs platform to automate the deployment and keep the cluster in a consistent state.

For more information take a lookt at my [docs](https://madic-creates.github.io/k3s-git-ops/).

If you're getting a certificate error when opening the docs (happens in Firefox), thats because of the hyphen in my username. Hyphens aren't allowed at the end of DNS names. As a workaround you can use a chromium based browser.

See also the following GitHub discussion: [Hyphen at the end of usernames](https://github.com/orgs/community/discussions/143105)

## Features

Excerpt of features this cluster provides:

- Provision nodes, including k3s, via ansible

- GitOps based cluster management with ArgoCD

- Encrypted secrets with [sops](https://github.com/mozilla/sops)

- Every exposed service uses SSO with [Authelia](https://www.authelia.com/)

- File backups from persistant volumes

  - Backup any folder to a restic supported storage backend

  - Delete old backups (Daily, Weekly, Monthly, Always Keep Last)

  - ntfy.sh notification on failure

  - prometheus pushgateway metrics

- KubeDoom: Killing whoami containers with a shotgun

- High Avaliability ControlPlane and LoadBalancer via KubeVIP

- Monitoring via kube-prometheus-stack

- Logging via loki

- Alerting via alertmanager to a selfhosted ntfy

- Storage managed via longhorn

- Vagrant based virtual test environment