Schreibt arc42 Sektion 7 (Verteilungssicht): Technische Infrastruktur, Hardware, Deployment, Software-Hardware-Mapping, Environments. Use when: Sektion 7 schreiben, Verteilungssicht, Deployment View, Infrastruktur, Hardware, Mapping, Kubernetes, Cloud dokumentieren.
Die Verteilungssicht beschreibt:
Dies ist eine der Kernsektionen der arc42-Dokumentation.
07-Verteilungssicht/
├── 07-01-Infrastruktur.md
└── 07-02-<Umgebung>.md (optional, bei mehreren Umgebungen)
Dockerfile, docker-compose.yml, Kubernetes-Manifeste (k8s/, helm/).tf), CloudFormation, Pulumi.github/workflows/, Jenkinsfile, .gitlab-ci.yml → Deploy-Targetsapplication-prod.yml, .env.production)# Verteilungssicht
## Infrastruktur Ebene 1
### Übersichtsdiagramm
```mermaid
graph TB
subgraph Cloud [Cloud Provider]
subgraph VPC [VPC]
LB[Load Balancer]
subgraph Subnet1 [Public Subnet]
APP1[App Server 1]
APP2[App Server 2]
end
subgraph Subnet2 [Private Subnet]
DB[(Datenbank)]
CACHE[(Cache)]
end
end
end
User[Benutzer] -->|HTTPS| LB
LB --> APP1
LB --> APP2
APP1 --> DB
APP2 --> DB
APP1 --> CACHE
<Warum diese Infrastrukturstruktur? Welche Qualitätsanforderungen werden adressiert?>
| Software-Baustein | Infrastruktur-Knoten | Bemerkung |
|---|---|---|
| <Baustein A> | <App Server (Container)> | <z.B. 2 Instanzen, 2 CPU, 4GB RAM> |
| <Baustein B> | <App Server (Container)> | <Co-located mit Baustein A> |
| <Datenbank-Schema> | <RDS PostgreSQL> | <db.r5.large, Multi-AZ> |
## Best Practices (aus arc42-Tipps)
- **Infrastruktur dokumentieren**: Auch bei Cloud-Systemen die wesentliche Topologie beschreiben
- **Hardware-Entscheidungen begründen**: Warum diese Infrastruktur? Welche Alternativen gab es?
- **Alle Umgebungen dokumentieren**: Insbesondere wenn sich Prod von Dev signifikant unterscheidet
- **Hierarchisch aufbauen**: Ebene 1 zeigt den Überblick, Ebene 2 Details bei Bedarf
- **Mapping explizit machen**: Welcher Baustein läuft wo? Tabelle ist dafür ideal
- **Knoten erklären**: Jeden wichtigen Knoten kurz beschreiben (Typ, OS, Ressourcen)
- **UML-Deployment-Diagramme oder Mermaid**: Diagramme sind effektiver als nur Text
## Querverweise
- ← **Sektion 3.2** (Technischer Kontext): Technischer Kontext ist oft der Ausgangspunkt
- ← **Sektion 5** (Bausteinsicht): Bausteine werden auf Infrastruktur gemappt
- → **Sektion 8** (Konzepte): Deployment-Konzepte, CI/CD als querschnittliches Konzept