Infrastructure Knowledge¶

This section contains infrastructure-related knowledge and troubleshooting guides.

Topics¶

GE Infrastructure¶

Integrity Monitoring - Agent integrity and prevention system
Docker Compose Architecture - Multi-container agent orchestration
Agent Registry - Centralized agent metadata and validation

Cloud Providers¶

UpCloud - VPS hosting (primary)
Bunny.net - CDN
TransIP - DNS

Container Orchestration¶

Kubernetes - K8s setup and management
K8s Troubleshooting - Critical startup and network issues
Docker - Container best practices

Data Stores¶

Redis - Message broker and cache (agent trigger delivery)
PostgreSQL - Primary database
Vault - Secrets management (API keys, passwords)

Monitoring¶

Prometheus - Metrics
Grafana - Dashboards
Alerting - Alert configuration
Ron Guardian - Agent integrity monitoring

Troubleshooting¶

Common Issues - Frequent problems and solutions
Runbooks - Step-by-step guides for incidents

Data Residency¶

All GE infrastructure must comply with EU data residency requirements:

Primary Region: eu-fra-1 (Frankfurt, Germany)
DR Region: eu-ams-1 (Amsterdam, Netherlands)
Prohibited: Any US-based services or data centers

Access¶

Infrastructure is managed by: - Arjan - Primary infrastructure provisioner - Tijmen - Kubernetes specialist - Peter - Monitoring specialist

All infrastructure changes must be: 1. Documented in this wiki 2. Code-reviewed via GitHub 3. Tested in dev before production 4. Approved by Arjan or Dirk-Jan