Update AGENTS.md with eendoeserver and package-repo instructions
This commit is contained in:
@@ -14,6 +14,8 @@ Het platform omvat:
|
||||
* **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.
|
||||
* **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.
|
||||
* 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
|
||||
@@ -141,7 +160,7 @@ flowchart TD
|
||||
### Submodule & Git Beheer
|
||||
```bash
|
||||
# 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 ==="
|
||||
git -C "$d" status -s
|
||||
done
|
||||
@@ -153,6 +172,15 @@ git submodule update --remote --merge
|
||||
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
|
||||
```bash
|
||||
# Pods bekijken over alle relevante namespaces
|
||||
|
||||
Reference in New Issue
Block a user