Arc42 Write S07 Deployment

Codebase-Analyse-Hinweise

• Deployment: Aus Dockerfile, docker-compose.yml, Kubernetes-Manifeste (k8s/, helm/)
• Cloud-Infrastruktur: Aus Terraform-Files (.tf), CloudFormation, Pulumi
• CI/CD: Aus .github/workflows/, Jenkinsfile, .gitlab-ci.yml → Deploy-Targets
• Environments: Aus Environment-spezifischen Configs (application-prod.yml, .env.production)
• Scaling: Aus HPA-Configs (Kubernetes), Auto-Scaling-Groups (AWS)

Templates

07-01-Infrastruktur.md

# 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

Motivation

<Warum diese Infrastrukturstruktur? Welche Qualitätsanforderungen werden adressiert?>

Qualitäts- und Performance-Merkmale

• Verfügbarkeit: <z.B. 99.9%, Multi-AZ Deployment>
• Skalierung: <z.B. Auto-Scaling 2-10 Instanzen>
• Redundanz: <z.B. Datenbank mit Read-Replicas>

Mapping Software → Infrastruktur

Knoten-Beschreibungen

<Knoten 1: Application Server>

• Typ: <z.B. Container auf Kubernetes, EC2 t3.large>
• OS: <z.B. Alpine Linux 3.18>
• Ressourcen: <CPU, RAM, Storage>
• Software: <Installierte Software/Runtime>

## 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