stack.basicstack.de/infrastructure/README.md

# Infrastructure

This directory contains cluster-wide infrastructure configurations that support all applications.

## Structure

### `networking/`
Network-level configurations including:
- **[Network Architecture](networking/NETWORK_ARCHITECTURE.md)** - Comprehensive network architecture documentation
- **[DNS Requirements](networking/DNS_REQUIREMENTS.md)** - DNS records and configuration guide
- Ingress controller configurations (Traefik)
- Network policies
- Load balancer configurations (k3s ServiceLB)
- Certificate management (cert-manager, TLS)
- Certificate reloading (Stakater Reloader)

### `monitoring/`
Observability infrastructure:
- Prometheus operator and configurations
- Grafana dashboards and datasources
- Logging stack (Loki, Promtail, etc.)
- Alert rules and notification channels
- Service monitors and pod monitors

## Purpose

Infrastructure configurations in this directory are shared across all applications. Changes here can affect the entire cluster, so:

1. Test thoroughly before applying
2. Document all changes
3. Consider the impact on existing deployments
4. Coordinate with other team members

## Adding Infrastructure Components

When adding new infrastructure components:

1. Create appropriate subdirectories if needed
2. Include clear documentation
3. Define dependencies and prerequisites
4. Provide rollback procedures
5. Update this README with the new component