nik/homelab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README with deployment progress and service details

Browse Source
This commit is contained in:
Nik Afiq 2026-03-05 20:46:59 +09:00
parent 5c1cf1d980
commit 7fc5960342
1 changed files with 39 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
README.md
View File

@ -9,34 +9,43 @@ Infrastructure-as-Code for a 3-machine homelab running K3s.
| 0 | Backup configs, init repo | ✅ Done | | 0 | Backup configs, init repo | ✅ Done |
| 1 | Bootstrap Minisforum — K3s server + Traefik | ✅ Done | | 1 | Bootstrap Minisforum — K3s server + Traefik | ✅ Done |
| 2 | Join Debian as K3s agent, SMB setup | ⏳ Next | | 2 | Join Debian as K3s agent, SMB setup | ⏳ Next |
| 3 | Deploy core infra — Gitea, Pi-hole, DDNS | 🔜 Planned | | 3 | Deploy core infra — Gitea, Pi-hole, DDNS | 🔧 In progress |
| 4 | Deploy app services — Jellyfin, qBittorrent, etc. | 🔜 Planned | | 4 | Deploy app services — Jellyfin, qBittorrent, JDownloader, Dashy, Glances | 🔜 Planned |
| 5 | Networking cutover | 🔜 Planned | | 5 | Networking cutover — router, Traefik ingress, DNS | 🔜 Planned |
| 6 | Cleanup legacy Debian services | 🔜 Planned | | 6 | Cleanup legacy Debian services | 🔜 Planned |
## Architecture ## Architecture
| Machine | IP | SSH Port | Role | Status | | Machine | IP | SSH Port | Role | Status |
|---|---|---|---|---| |---|---|---|---|---|
| Minisforum UM780 XTX | 192.168.7.77 | 430 | K3s server | ✅ Running — K3s + Traefik | | Minisforum UM780 XTX | 192.168.7.77 | 430 | K3s server, main gateway | ✅ Running — K3s + Traefik |
| Debian Server (HP ProDesk) | TBD | — | K3s agent | ⏳ Phase 2 | | Debian Server (HP ProDesk) | TBD | — | K3s agent, SMB storage | ⏳ Phase 2 |
| Mac Mini M2 | TBD | — | Standalone | ⏳ Phase 3+ | | Mac Mini M2 | TBD | — | Standalone (outside cluster) | ⏳ Phase 3+ |
## Internal Services (Minisforum)
| Service | URL | Notes |
|---|---|---|
| Traefik | — | Ingress controller, Let's Encrypt |
| Gitea | `https://gitea.home.arpa` | Git + Docker registry, SSH on port 2222 |
| Pi-hole | `https://pihole.home.arpa/admin` | Primary DNS, resolves `*.home.arpa` → 192.168.7.77 |
## Repo Structure ## Repo Structure
``` ```
ansible/ ansible/
inventory.yml # host definitions inventory.yml # host definitions
playbooks/ # top-level playbooks playbooks/
bootstrap-minisforum.yml # OS hardening, packages, UFW, /data dirs
setup-k3s.yml # K3s server install, Helm, kubeconfig
roles/ roles/
common/ # base OS setup (users, SSH, UFW, packages) common/ # user, SSH hardening, UFW, base packages
k3s-server/ # K3s server install + Helm k3s-server/ # K3s server install + Helm
k3s-agent/ # K3s agent join (Phase 2) values/
smb/ # Samba on Debian (Phase 2) traefik.yml ✅ deployed
helm/ # custom Helm charts (if needed; most use upstream charts) gitea.yml 🔧 in progress
values/ # Helm values files per service pihole.yml 🔧 in progress
scripts/ # deploy-all.sh, porkbun-ddns.sh old.debian-data/ # gitignored — backup of pre-migration configs
old.debian-data/ # gitignored — backup of pre-migration configs
``` ```
## Prerequisites ## Prerequisites
@ -66,10 +75,23 @@ ansible-playbook -i ansible/inventory.yml ansible/playbooks/bootstrap-minisforum
# Re-run K3s setup (idempotent) # Re-run K3s setup (idempotent)
ansible-playbook -i ansible/inventory.yml ansible/playbooks/setup-k3s.yml ansible-playbook -i ansible/inventory.yml ansible/playbooks/setup-k3s.yml
# Upgrade Traefik # Traefik
helm repo add traefik https://helm.traefik.io/traefik && helm repo update
helm upgrade --install traefik traefik/traefik \ helm upgrade --install traefik traefik/traefik \
--namespace traefik --create-namespace \ --namespace traefik --create-namespace \
-f values/traefik.yml -f values/traefik.yml
# Gitea
helm repo add gitea-charts https://dl.gitea.com/charts/ && helm repo update
helm upgrade --install gitea gitea-charts/gitea \
--namespace gitea --create-namespace \
-f values/gitea.yml
# Pi-hole
helm repo add mojo2600 https://mojo2600.github.io/pihole-kubernetes/ && helm repo update
helm upgrade --install pihole mojo2600/pihole \
--namespace pihole --create-namespace \
-f values/pihole.yml
``` ```
## See Also ## See Also