mirror of
http://172.20.10.11:3000/gitadmin/INSIGHT-MVP.git
synced 2026-06-25 00:16:41 +02:00
docs: update ACCESS.md with server IPs and Forgejo setup completion
- Add insight-dev-01 server IP: 172.20.10.59 - Add Git server (GAIA-GIT) details: 172.20.10.11 - Replace all IP placeholders with actual values - Update Summarize.md with Forgejo configuration status Server setup completed on git.xinion.lan: - Docker Engine 29.3 installed - Forgejo Actions + Container Registry enabled - Runner v6.3.1 registered and running - 5 repository secrets configured - Branch protection on main + develop Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
b3516c5fdd
commit
34129401a3
2 changed files with 57 additions and 37 deletions
65
Summarize.md
65
Summarize.md
|
|
@ -8,59 +8,66 @@
|
||||||
|
|
||||||
### Aenderungen in dieser Session
|
### Aenderungen in dieser Session
|
||||||
|
|
||||||
#### Projektinitialisierung & Infrastruktur-Definition
|
#### 1. Projektinitialisierung & Infrastruktur-Definition
|
||||||
|
|
||||||
**Was wurde gemacht:**
|
**Was wurde gemacht:**
|
||||||
|
|
||||||
1. **SSH Deployment Key erstellt**
|
1. **SSH Keys erstellt**
|
||||||
- Ed25519-Schluessel unter `.keys/deploy_ed25519` generiert
|
- Deploy-Key (`.keys/deploy_ed25519`) fuer Server-Zugriff
|
||||||
- Public Key muss auf dem Entwicklungsserver und in Forgejo hinterlegt werden
|
- CI/CD-Key (`.keys/cicd_ed25519`) fuer Forgejo Actions Pipeline
|
||||||
- Key-Kommentar: `insight-deploy@xinion.lan`
|
|
||||||
|
|
||||||
2. **Infrastruktur-Definition erstellt** (`docs/INFRASTRUCTURE.md`)
|
2. **Infrastruktur-Definition erstellt** (`docs/INFRASTRUCTURE.md`)
|
||||||
- ProxmoxVE VM-Spezifikation: Ubuntu 24.04 LTS, 4 vCPU, 8 GB RAM, 60 GB SSD
|
- ProxmoxVE VM-Spezifikation: Ubuntu 24.04 LTS, 4 vCPU, 8 GB RAM, 60 GB SSD
|
||||||
- Docker-Netzwerk-Architektur mit 3 isolierten Netzwerken
|
- Docker-Netzwerk-Architektur mit 3 isolierten Netzwerken
|
||||||
- Komplette Service-Landschaft definiert (Traefik, Core, Frontend, PostgreSQL, PgBouncer, Redis, step-ca)
|
- Komplette Service-Landschaft definiert
|
||||||
- Observability-Stack definiert (Prometheus, Grafana, Loki, Tempo, Promtail, cAdvisor)
|
|
||||||
- Schritt-fuer-Schritt VM-Setup Anleitung
|
- Schritt-fuer-Schritt VM-Setup Anleitung
|
||||||
|
|
||||||
3. **Zugangsdaten-Dokument erstellt** (`docs/ACCESS.md`)
|
3. **Zugangsdaten-Dokument erstellt** (`docs/ACCESS.md`)
|
||||||
- Git Repository Zugangsdaten
|
- Server-IP: 172.20.10.59 (insight-dev-01)
|
||||||
- SSH-Key Dokumentation und Verwendung
|
- Git-Server: 172.20.10.11 (GAIA-GIT)
|
||||||
- Server-Zugangsdaten (Platzhalter fuer IP)
|
- Alle SSH-Keys, Ports, Befehle dokumentiert
|
||||||
- Alle Service-Ports dokumentiert
|
|
||||||
- Deployment-Pfad dokumentiert
|
|
||||||
- Wichtige Befehle (MacBook & Server)
|
|
||||||
|
|
||||||
4. **Projektstruktur aufgesetzt**
|
4. **Projektstruktur aufgesetzt** (packages/core-service, packages/frontend, config, .forgejo)
|
||||||
- Verzeichnisstruktur gemaess Briefing angelegt
|
|
||||||
- packages/core-service/ (NestJS Backend)
|
|
||||||
- packages/frontend/ (React + Vite)
|
|
||||||
- config/ (Traefik, Prometheus, step-ca)
|
|
||||||
- .forgejo/workflows/ (CI/CD)
|
|
||||||
|
|
||||||
5. **Basis-Konfigurationsdateien erstellt**
|
5. **Basis-Konfigurationsdateien** (.gitignore, .env.example, README.md)
|
||||||
- `.gitignore` - alle relevanten Ausschluesse
|
|
||||||
- `.env.example` - alle Umgebungsvariablen dokumentiert (ohne Werte)
|
#### 2. Forgejo Git-Server Konfiguration
|
||||||
- `README.md` - vollstaendiges Onboarding-Dokument
|
|
||||||
|
**Was wurde auf dem Git-Server (172.20.10.11) gemacht:**
|
||||||
|
|
||||||
|
1. **Docker Engine 29.3 installiert** (fuer Forgejo Actions Runner)
|
||||||
|
2. **Forgejo Actions aktiviert** (`[actions] ENABLED = true` in app.ini)
|
||||||
|
3. **Container Registry aktiviert** (`[packages] ENABLED = true` in app.ini)
|
||||||
|
4. **Forgejo Runner v6.3.1 installiert und registriert**
|
||||||
|
- Runner-Name: `insight-runner`
|
||||||
|
- Labels: `ubuntu-latest` (docker://node:20)
|
||||||
|
- Laeuft als Systemd-Service (`forgejo-runner.service`)
|
||||||
|
5. **Repository Secrets angelegt:**
|
||||||
|
- `SSH_DEPLOY_KEY` - CI/CD Private Key
|
||||||
|
- `DEPLOY_HOST` - 172.20.10.59
|
||||||
|
- `DEPLOY_USER` - deploy
|
||||||
|
- `REGISTRY_USER` - gitadmin
|
||||||
|
- `REGISTRY_PASSWORD` - Forgejo Access Token
|
||||||
|
6. **Branch Protection eingerichtet:**
|
||||||
|
- `main`: Kein direkter Push, 1 Approval erforderlich
|
||||||
|
- `develop`: Kein direkter Push, 1 Approval erforderlich
|
||||||
|
7. **Forgejo Setup-Anleitung erstellt** (`docs/FORGEJO_SETUP.md`)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Naechste Schritte
|
### Naechste Schritte
|
||||||
|
|
||||||
- [ ] VM in ProxmoxVE erstellen und konfigurieren
|
- [ ] SSH Deploy Keys auf insight-dev-01 Server hinterlegen
|
||||||
- [ ] SSH Deploy Key auf Server und in Forgejo hinterlegen
|
|
||||||
- [ ] `docker-compose.yml` erstellen (alle Basis-Services)
|
- [ ] `docker-compose.yml` erstellen (alle Basis-Services)
|
||||||
- [ ] `docker-compose.observability.yml` erstellen
|
- [ ] `docker-compose.observability.yml` erstellen
|
||||||
- [ ] NestJS Core-Service implementieren (Auth, Users, Tenants)
|
- [ ] NestJS Core-Service implementieren (Auth, Users, Tenants)
|
||||||
- [ ] Prisma-Schemas erstellen (core + tenant)
|
- [ ] Prisma-Schemas erstellen (core + tenant)
|
||||||
- [ ] React Frontend-Shell implementieren
|
- [ ] React Frontend-Shell implementieren
|
||||||
- [ ] CI/CD Pipelines in Forgejo Actions definieren
|
- [ ] CI/CD Pipelines (.forgejo/workflows/) definieren
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Offene Fragen / Abhaengigkeiten
|
### Offene Fragen / Abhaengigkeiten
|
||||||
|
|
||||||
- Server-IP wird erst bei VM-Erstellung vergeben
|
- DNS-Eintrag `insight-dev.xinion.lan` muss auf 172.20.10.59 zeigen
|
||||||
- DNS-Eintraege (insight-dev.xinion.lan) muessen konfiguriert werden
|
- Deploy Keys muessen auf insight-dev-01 in authorized_keys hinterlegt werden
|
||||||
- Forgejo Deploy Key muss manuell hinterlegt werden
|
|
||||||
|
|
|
||||||
|
|
@ -63,12 +63,12 @@ ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAINlPo+AvDMTMZC0G49o+kuU98/aC85N90QU3a+FaTjoG
|
||||||
### 2.3 SSH-Verbindung zum Server
|
### 2.3 SSH-Verbindung zum Server
|
||||||
```bash
|
```bash
|
||||||
# Verbindung zum Entwicklungsserver:
|
# Verbindung zum Entwicklungsserver:
|
||||||
ssh -i .keys/deploy_ed25519 deploy@<SERVER-IP>
|
ssh -i .keys/deploy_ed25519 deploy@172.20.10.59
|
||||||
|
|
||||||
# Mit SSH-Config (empfohlen):
|
# Mit SSH-Config (empfohlen):
|
||||||
# Eintrag in ~/.ssh/config:
|
# Eintrag in ~/.ssh/config:
|
||||||
Host insight-dev
|
Host insight-dev
|
||||||
HostName <SERVER-IP>
|
HostName 172.20.10.59
|
||||||
User deploy
|
User deploy
|
||||||
IdentityFile ~/git.xinion.lan/INSIGHT-MVP/.keys/deploy_ed25519
|
IdentityFile ~/git.xinion.lan/INSIGHT-MVP/.keys/deploy_ed25519
|
||||||
StrictHostKeyChecking accept-new
|
StrictHostKeyChecking accept-new
|
||||||
|
|
@ -89,7 +89,7 @@ Host insight-dev
|
||||||
|------------------|-----------------------------------------|
|
|------------------|-----------------------------------------|
|
||||||
| **Hostname** | `insight-dev-01` |
|
| **Hostname** | `insight-dev-01` |
|
||||||
| **OS** | Ubuntu 24.04 LTS |
|
| **OS** | Ubuntu 24.04 LTS |
|
||||||
| **IP** | _wird bei VM-Erstellung vergeben_ |
|
| **IP** | `172.20.10.59` |
|
||||||
| **SSH-Port** | 22 |
|
| **SSH-Port** | 22 |
|
||||||
| **SSH-User** | `deploy` |
|
| **SSH-User** | `deploy` |
|
||||||
| **SSH-Key** | `.keys/deploy_ed25519` |
|
| **SSH-Key** | `.keys/deploy_ed25519` |
|
||||||
|
|
@ -99,7 +99,7 @@ Host insight-dev
|
||||||
### Schnellzugriff nach VM-Setup
|
### Schnellzugriff nach VM-Setup
|
||||||
```bash
|
```bash
|
||||||
# SSH auf den Server
|
# SSH auf den Server
|
||||||
ssh -i .keys/deploy_ed25519 deploy@<SERVER-IP>
|
ssh -i .keys/deploy_ed25519 deploy@172.20.10.59
|
||||||
|
|
||||||
# Status aller Container pruefen
|
# Status aller Container pruefen
|
||||||
docker compose ps
|
docker compose ps
|
||||||
|
|
@ -134,7 +134,7 @@ docker compose restart core
|
||||||
|
|
||||||
| Service | Port | Zugriff |
|
| Service | Port | Zugriff |
|
||||||
|-----------------|-------|----------------------------------|
|
|-----------------|-------|----------------------------------|
|
||||||
| Grafana | 3001 | SSH-Tunnel: `ssh -L 3001:localhost:3001 deploy@<IP>` |
|
| Grafana | 3001 | SSH-Tunnel: `ssh -L 3001:localhost:3001 deploy@172.20.10.59` |
|
||||||
| Prometheus | 9090 | Nur intern |
|
| Prometheus | 9090 | Nur intern |
|
||||||
| Loki | 3100 | Nur intern |
|
| Loki | 3100 | Nur intern |
|
||||||
| Tempo | 3200 | Nur intern |
|
| Tempo | 3200 | Nur intern |
|
||||||
|
|
@ -197,7 +197,20 @@ Laufende Anwendung
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 8. Wichtige Befehle
|
## 8. Git-Server (Forgejo)
|
||||||
|
|
||||||
|
| Parameter | Wert |
|
||||||
|
|------------------|-----------------------------------------|
|
||||||
|
| **Hostname** | `git.xinion.lan` |
|
||||||
|
| **IP** | `172.20.10.11` |
|
||||||
|
| **SSH-User** | `sysadmin` |
|
||||||
|
| **SSH-Port** | 22 |
|
||||||
|
| **Web-UI** | `https://git.xinion.lan` |
|
||||||
|
| **Forgejo-User** | `gitadmin` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Wichtige Befehle
|
||||||
|
|
||||||
### Vom MacBook aus
|
### Vom MacBook aus
|
||||||
```bash
|
```bash
|
||||||
|
|
@ -205,10 +218,10 @@ Laufende Anwendung
|
||||||
git push origin develop
|
git push origin develop
|
||||||
|
|
||||||
# SSH auf Server
|
# SSH auf Server
|
||||||
ssh -i .keys/deploy_ed25519 deploy@<SERVER-IP>
|
ssh -i .keys/deploy_ed25519 deploy@172.20.10.59
|
||||||
|
|
||||||
# Grafana oeffnen (SSH-Tunnel)
|
# Grafana oeffnen (SSH-Tunnel)
|
||||||
ssh -L 3001:localhost:3001 -i .keys/deploy_ed25519 deploy@<SERVER-IP>
|
ssh -L 3001:localhost:3001 -i .keys/deploy_ed25519 deploy@172.20.10.59
|
||||||
# Dann im Browser: http://localhost:3001
|
# Dann im Browser: http://localhost:3001
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue