127 lines
4.4 KiB
Markdown
127 lines
4.4 KiB
Markdown
# KMU Server Infrastructure
|
|
|
|
Dieses Repository verwaltet die komplette Infrastruktur-Konfiguration und -Dokumentation für die KMU-Organisation.
|
|
|
|
## 📋 Übersicht
|
|
|
|
Das `server-infra` Repository dient als zentrale Verwaltungseinheit für:
|
|
- Server-Konfigurationsdateien
|
|
- Automatisierungs- und Deployment-Skripte
|
|
- Infrastruktur-Dokumentation
|
|
- Service-Konfigurationen
|
|
- Systemd-Units und Service-Definitionen
|
|
|
|
## 🏗️ Repository-Struktur
|
|
|
|
```
|
|
server-infra/
|
|
├── README.md # Diese Datei
|
|
├── docs/ # Dokumentation
|
|
│ ├── architecture.md # System-Architektur
|
|
│ ├── network-layout.md # Netzwerk-Konfiguration
|
|
│ ├── installation.md # Installationsanleitungen
|
|
│ └── maintenance.md # Wartungshandbuch
|
|
├── scripts/ # Automatisierungs-Skripte
|
|
│ ├── backup/ # Backup-Skripte
|
|
│ ├── deployment/ # Deployment-Automatisierung
|
|
│ ├── monitoring/ # Überwachungs-Skripte
|
|
│ └── maintenance/ # Wartungs-Skripte
|
|
├── configs/ # Service-Konfigurationen
|
|
│ ├── gitea/ # Gitea-Konfiguration
|
|
│ ├── nginx/ # Nginx-Konfiguration
|
|
│ ├── postgresql/ # PostgreSQL-Konfiguration
|
|
│ └── ssl/ # SSL/TLS-Zertifikate (ohne Private Keys)
|
|
├── systemd/ # Systemd-Service-Units
|
|
│ └── services/ # Custom Service-Definitionen
|
|
├── ansible/ # Ansible-Playbooks (optional)
|
|
│ ├── playbooks/ # Ansible-Playbooks
|
|
│ ├── roles/ # Ansible-Rollen
|
|
│ └── inventory/ # Inventory-Dateien
|
|
└── .gitignore # Git-Ignore-Regeln
|
|
```
|
|
|
|
## 🚀 Erste Schritte
|
|
|
|
### 1. Repository klonen
|
|
```bash
|
|
git clone https://git.gitcover.de/KMU/server-infra.git
|
|
cd server-infra
|
|
```
|
|
|
|
### 2. Dokumentation lesen
|
|
Beginnen Sie mit der Dokumentation im `docs/` Verzeichnis:
|
|
- **architecture.md**: System-Übersicht und Komponenten
|
|
- **installation.md**: Schritt-für-Schritt Installationsanleitung
|
|
- **maintenance.md**: Wartungs- und Update-Prozeduren
|
|
|
|
### 3. Skripte verwenden
|
|
Alle Automatisierungs-Skripte befinden sich im `scripts/` Verzeichnis und sind nach Kategorien organisiert.
|
|
|
|
## 🔧 Server-Spezifikationen
|
|
|
|
- **Betriebssystem**: Ubuntu Server LTS (neueste Version)
|
|
- **Git-Server**: Gitea
|
|
- **Webserver**: Nginx
|
|
- **Datenbank**: PostgreSQL
|
|
- **Backup-Strategie**: Automatisierte tägliche Backups
|
|
|
|
## ⚠️ Sicherheitshinweise
|
|
|
|
**WICHTIG**: Dieses Repository enthält KEINE sensiblen Daten wie:
|
|
- Private SSH-Schlüssel
|
|
- Passwörter oder API-Keys
|
|
- Private SSL-Zertifikate
|
|
- Datenbank-Credentials
|
|
|
|
Sensible Daten werden über Umgebungsvariablen oder externe Secret-Management-Systeme verwaltet.
|
|
|
|
## 📚 Dokumentations-Index
|
|
|
|
| Dokument | Beschreibung |
|
|
|----------|-------------|
|
|
| [Architecture](docs/architecture.md) | System-Architektur und Komponenten-Übersicht |
|
|
| [Network Layout](docs/network-layout.md) | Netzwerk-Konfiguration und Firewall-Regeln |
|
|
| [Installation Guide](docs/installation.md) | Komplette Installationsanleitung |
|
|
| [Maintenance Manual](docs/maintenance.md) | Wartung, Updates und Troubleshooting |
|
|
|
|
## 🔄 Workflow und Versionierung
|
|
|
|
### Branch-Strategie
|
|
- **main**: Produktive Konfiguration (nur getestete Änderungen)
|
|
- **development**: Entwicklungs- und Test-Konfigurationen
|
|
- **feature/[name]**: Feature-Branches für größere Änderungen
|
|
|
|
### Commit-Konventionen
|
|
```
|
|
[Typ]: Kurze Beschreibung
|
|
|
|
Typen:
|
|
- feat: Neue Funktionalität oder Konfiguration
|
|
- fix: Fehlerbehebung
|
|
- docs: Dokumentations-Änderungen
|
|
- config: Konfigurationsanpassungen
|
|
- script: Skript-Änderungen oder -Ergänzungen
|
|
```
|
|
|
|
## 🤝 Beitragen
|
|
|
|
1. **Branch erstellen**: `git checkout -b feature/neue-funktion`
|
|
2. **Änderungen committen**: `git commit -m "feat: Neue Konfiguration hinzugefügt"`
|
|
3. **Push**: `git push origin feature/neue-funktion`
|
|
4. **Pull Request erstellen** über die Gitea-Weboberfläche
|
|
|
|
## 📞 Kontakt und Support
|
|
|
|
- **Repository**: https://git.gitcover.de/KMU/server-infra
|
|
- **Organisation**: KMU
|
|
- **Maintainer**: [Ihr Name]
|
|
|
|
## 📄 Lizenz
|
|
|
|
Dieses Repository enthält interne Infrastruktur-Konfigurationen der KMU-Organisation.
|
|
Nicht für externe Verwendung bestimmt.
|
|
|
|
---
|
|
|
|
**Letzte Aktualisierung**: $(date +"%Y-%m-%d")
|
|
**Version**: 1.0.0 |