Update AGENTS.md with eendoeserver and package-repo instructions

This commit is contained in:
bart
2026-10-20 21:25:22 +02:00
parent 68116d1493
commit 63e8a68489
+29 -1
View File
@@ -14,6 +14,8 @@ Het platform omvat:
* **HERMS Brouwplatform**: Geautomatiseerd Heat Exchange Recirculating Mash System (Rust microservices, Next.js frontend, ESP32 firmware, KiCad hardware). * **HERMS Brouwplatform**: Geautomatiseerd Heat Exchange Recirculating Mash System (Rust microservices, Next.js frontend, ESP32 firmware, KiCad hardware).
* **Smart Home**: Home Assistant en IoT-koppelingen binnen Kubernetes. * **Smart Home**: Home Assistant en IoT-koppelingen binnen Kubernetes.
* **HTPC & Media**: Jellyfin, `*Arr`-stack en downloadvoorzieningen. * **HTPC & Media**: Jellyfin, `*Arr`-stack en downloadvoorzieningen.
* **Web & Reverse Proxy (`eendoeserver`)**: Apache VirtualHosts, reverse proxy configuraties en de website van `eendoe.nl` op `web03`.
* **Software Distributie (`package-repo`)**: Debian / APT package repository bronnen, build-scripts en CI/CD packaging pipelines.
--- ---
@@ -134,6 +136,23 @@ flowchart TD
* Bevat ArgoCD ApplicationSets en Kustomize base/overlay structuren voor het cluster. * Bevat ArgoCD ApplicationSets en Kustomize base/overlay structuren voor het cluster.
* Map `workloads/` bevat gesynchroniseerde manifests voor `cluster-infra`, `herms`, `demo` en `htpc`. * Map `workloads/` bevat gesynchroniseerde manifests voor `cluster-infra`, `herms`, `demo` en `htpc`.
### 🏢 eendoeserver (`eendoeserver/`)
* Bevat de configuratie en bestanden voor de standalone server `web03` (`eendoe.nl`):
* **`eendoe/`**: Document root voor de website `eendoe.nl` en `bm4.nl` (HTML, SASS, CSS, JS, afbeeldingen).
* **`vhosts/`**: Apache 2.4 VirtualHost configuraties (geïncludeerd via `Include /sites/vhosts/*.conf`).
* **Regels**:
* Grote binaire installers (zoals `.AppImage` of losse `.deb` installatiebestanden) horen **niet** thuis in git, maar worden beheerd via `package-repo` of downloads.
### 📦 package-repo (`package-repo/`)
* Bevat de bronbestanden en distributiestructuur voor de Debian/APT package repository van Eendoe:
* **`sources/`**: Bevat bronbestanden per package (bijv. `eendoe_repository`, `eendoe_hyperdeck`, `eendoe_srs`) met hun control templates en `bin/build.sh`.
* **`staging/`**: Bestemming voor nieuw gebouwde en bestaande `.deb` pakketten.
* **`binaries/`**: Publiek geserveerde repository bestanden (`pool/`, `dists/`).
* **`buildpackages.sh`**: Universeel build-script om packages direct te genereren.
* **`.gitea/workflows/build-and-publish.yaml`**: CI/CD pipeline voor automatische package-builds en SSH/rsync deployments.
* **Belangrijke regel**:
* **Nooit** grote externe database installatiebestanden (zoals Oracle Database XE deb packages van >2 GB) toevoegen aan deze repository.
--- ---
## 🛠️ 6. Handige Commando's voor Agents ## 🛠️ 6. Handige Commando's voor Agents
@@ -141,7 +160,7 @@ flowchart TD
### Submodule & Git Beheer ### Submodule & Git Beheer
```bash ```bash
# Submodule status en eventuele uncommitted changes inspecteren # Submodule status en eventuele uncommitted changes inspecteren
for d in cluster-infra HERMS k8s-infra-vmserver smart-home htpc; do for d in cluster-infra HERMS k8s-infra-vmserver smart-home htpc eendoeserver package-repo; do
echo "=== $d ===" echo "=== $d ==="
git -C "$d" status -s git -C "$d" status -s
done done
@@ -153,6 +172,15 @@ git submodule update --remote --merge
git submodule update --init --recursive git submodule update --init --recursive
``` ```
### Debian Packages Bouwen (`package-repo`)
```bash
# Alle debian packages in sources/ compileren
./package-repo/buildpackages.sh all
# Een specifiek package compileren
./package-repo/buildpackages.sh eendoe_hyperdeck
```
### Kubernetes & Kustomize Inspectie ### Kubernetes & Kustomize Inspectie
```bash ```bash
# Pods bekijken over alle relevante namespaces # Pods bekijken over alle relevante namespaces