https://github.com/fabricesemti80/home-dc-kubernetes
Central repository for my home data centre's Kubernetes operations (managed by Argo/GitOps)
https://github.com/fabricesemti80/home-dc-kubernetes
argocd gitops kubernetes terraform
Last synced: 9 days ago
JSON representation
Central repository for my home data centre's Kubernetes operations (managed by Argo/GitOps)
- Host: GitHub
- URL: https://github.com/fabricesemti80/home-dc-kubernetes
- Owner: fabricesemti80
- Created: 2026-04-14T15:29:22.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-07-11T01:56:47.000Z (14 days ago)
- Last Synced: 2026-07-11T03:17:24.667Z (14 days ago)
- Topics: argocd, gitops, kubernetes, terraform
- Language: YAML
- Homepage:
- Size: 891 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# home-dc-kubernetes
This repository is the main source of truth for the homelab. It manages:
- the imported Talos / Argo cluster workflow at the repo root
- the Kubernetes/Talos OpenTofu stacks under `infra/terraform_*`
Host-level Docker services moved to `/Users/fs/Documents/repositories/infrastructure/home-dc-docker`.
## Start Here
- Documentation hub: [docs/README.md](docs/README.md)
- Architecture plan: [docs/architecture/ARCHITECTURE_PLAN.md](docs/architecture/ARCHITECTURE_PLAN.md)
- Cluster migration notes: [docs/architecture/ARGO_CLUSTER_MIGRATION.md](docs/architecture/ARGO_CLUSTER_MIGRATION.md)
- Agent guidance: [AGENTS.md](AGENTS.md)
## Documentation Map
- OpenTofu setup: [docs/infrastructure/terraform.md](docs/infrastructure/terraform.md)
- Talos / Argo / cluster docs: [docs/cluster/README.md](docs/cluster/README.md)
- Storage docs: [docs/storage/overview.md](docs/storage/overview.md)
- Troubleshooting: [docs/operations/troubleshooting.md](docs/operations/troubleshooting.md)
## Core Tasks
Ensure `mise` is installed, then:
```bash
mise install
task deps
```
Common workflows:
```bash
# OpenTofu stacks
task tf:init
task tf:plan
# Talos / cluster bootstrap flow
task talos:genconfig
task talos:bootstrap
task apps:bootstrap
task verify:cluster
```
Task execution now lives in structured files under `.taskfiles/`. `mise.toml` remains the source of truth for tool installation and environment setup.
## Repository Notes
- `kubernetes/` and `bootstrap/` are the active GitOps source for cluster apps.
- `talos/`, `cluster.yaml`, and `nodes.yaml` are still part of the active Talos config-generation workflow.
- Host-level Docker services are intentionally managed outside this repo.
- Older placeholder folders were removed from Git where they no longer backed any active workflow.