Kubernetes Deployment Projects

This repository aggregates multiple Kubernetes deployment projects as git submodules. Each subdirectory represents an independent project with its own deployment configuration.

Automatic Submodule Updates

This repository uses mise to automatically keep all submodules updated to their latest main branch commits.

How It Works

1. Enter Hook: When you enter this directory, mise automatically installs a git post-commit hook
2. Post-Commit Hook: After any commit to this repository, the hook runs mise run update-submodules
3. Submodule Changes: Any existing submodule reference changes are automatically staged and committed

Setup

1. Install mise: curl https://mise.run | sh
2. Enable experimental features: mise settings experimental=true
3. Enter this directory: cd /path/to/kubernetes
4. Trust the mise configuration: mise trust

The post-commit hook will be automatically installed and submodules will stay current with every commit.

Manual Operations

• mise run update-submodules - Add any existing submodule changes to parent repo

Requirements

• mise installed with experimental features enabled
• Git submodules configured with branch = main in .gitmodules
• All submodule repositories should use main as their default branch

Project Structure

Each subdirectory represents a Kubernetes project:

• argocd/ - ArgoCD GitOps deployment
• authelia/ - Authentication and authorization gateway
• gitlab/ - GitLab instance
• nextcloud/ - Personal cloud storage
• traefik/ - Reverse proxy and ingress controller
• vaultwarden/ - Password manager
• (and many more...)

See AGENTS.md for detailed documentation about project types, patterns, and development guidelines.