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).
|
* **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
|
||||||
|
|||||||
Reference in New Issue
Block a user