Readme: Document SQL Proxy usage

This commit is contained in:
Kevin Baensch 2022-11-17 15:33:17 +01:00
parent 81c588b5e4
commit 0cb7e70a68
2 changed files with 22 additions and 0 deletions

1
.gitignore vendored
View file

@ -1 +1,2 @@
/etc/ssh/*key* /etc/ssh/*key*
/etc/ssh/.ssh

View file

@ -57,3 +57,24 @@ networks:
name: proxy name: proxy
external: true external: true
``` ```
## SQL Proxy
### Initiales Setup
Öffne ein Terminal und führe die `sqlproxy_setup.sh` Datei aus.
Das Script:
1. Installiert den `myssh` befehl nach `$HOME/bin` und fügt diesen ggf zur PATH variable hinzu
2. Erstellt SSH Keys für den SSH Docker Container (wenn diese nicht bereits existieren)
3. Erstellt und Konfiguriert einen Client SSH Key, dessen public Key wird dem SSH Docker Container hinzugefügt
### Hinzufügen von DB Docker Containern
Container werden automatisch vom reverse proxy/host manager aufgegriffen wenn sie:
1. Die Umgebungsvariable `DB_VHOST` gesetzt haben.
2. Im gleichen Docker-Netzwek (Default: `proxy`) sind.
### myssh cli
Der SQL Proxy Client hat folgende Optionen:
```bash
ls: Gibt eine Liste an verfügbaren DB Hosts zurück
connect $DB_HOST [-u $USERNAME ] [-p $PASSWORD]: Erstellt einen Tunnel zum DB Host, wenn Nutzername und Passwort angegeben werden wird eine DB Anwendung geöffnet
disconnect: schließt die SSH Multiplex Session und damit auch alle aktuellen Verbindungen
```