Erste Schritte bei der Fobi
This commit is contained in:
commit
c389c9049f
1 changed files with 98 additions and 0 deletions
98
README.md
Normal file
98
README.md
Normal file
|
|
@ -0,0 +1,98 @@
|
|||
# Docker-Fobi Begleitmaterial
|
||||
## Schulungsumgebung
|
||||
Jeder Teilnehmer hat am Schulungstag einen Cloud-Server zur Verfügung:
|
||||
- 2 Kerne
|
||||
- 4GB RAM
|
||||
- 80GB SSD
|
||||
- debian13 Grundinstallation
|
||||
|
||||
Die Server haben jeweils einen *Wildcard-DNS-Record* gesetzt, so dass sie unter beliebigen Namen in ihrem Bereich aufgerufen werden können.
|
||||
Die Basis-Adressen folgen dem Schema `fobiX.benbex.de`, wobei X die Teilnehmernummer ist:
|
||||
```
|
||||
Teilnehmer 1 -> fobi1.benbex.de
|
||||
Teilnehmer 2 -> fobi2.benbex.de
|
||||
```
|
||||
|
||||
Damit sind dann auf dem Server fobiX.benbex.de die Dienste zum Beispiel so zu unterscheiden:
|
||||
- Webserver: **webserver**.fobiX.benbex.de
|
||||
- Nextcloud: **nextcloud**.fobiX.benbex.de
|
||||
- irgendwas anderes: **wurschdsalat**.fobiX.benbex.de
|
||||
|
||||
## Vorbereitungen
|
||||
Damit ein vernünftiges Arbeiten mit dem Server möglich ist, benötigst du einen SSH-Client:
|
||||
Linux / MacOS / Windows11: integriert ins System. Öffne ein Terminal (bei Windows *cmd*) und gib ein:
|
||||
```sh
|
||||
ssh fobiX.benbex.de -l root
|
||||
```
|
||||
das `-l` steht für "Login Name" und '*root*' ist der administrative Nutzer bei Linux.
|
||||
(das *X* ersetzt du durch deine Nummer 1-6)
|
||||
|
||||
Windows10 vor Version 1809: Du benötigst ein Zusatzprogramm, z.B. [putty.exe](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)
|
||||
|
||||
|
||||
Bei der ersten Verbindung erhältst du eine Warnung:
|
||||
```
|
||||
The authenticity of host 'fobiX.benbex.de (<IP-Adresse>)' can't be established.
|
||||
ED25519 key fingerprint is SHA256:u5Fb2WImIBh5e/FoRCzgK2uxTpL06o93XiPa+AroL+4.
|
||||
This key is not known by any other names.
|
||||
Are you sure you want to continue connecting (yes/no/[fingerprint])?
|
||||
```
|
||||
Diese Warnung ist unter normalen Bedingungen wirklich ernst zu nehmen! Ein Server, den man schon kennt, darf diese Meldung NIE verursachen. Hier merkt man, wenn ein Bösewicht sich eingeklinkt hat. In unserem Fall ist die aber normal und der Aufwand, den Fingerabdruck des Servers zu verifizieren ist für den geplanten Zweck zu aufwändig, so dass wir hier in naivem Vertrauen `yes` eintippen (bzw. anklicken, falls unter Windows mit putty)
|
||||
Nachdem du dich mit dem Passwort (steht in den geteilten Notizen im BigBlueButton) authentifiziert hast, begrüßt dich nun der Server mit der "message of the day (motd)" und anschließend mit dem System-Prompt:
|
||||
```
|
||||
Linux fobiX 6.12.41+deb13-cloud-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.12.41-1 (2025-08-12) x86_64
|
||||
(...)
|
||||
root@fobiX:~#
|
||||
```
|
||||
Am *Prompt* (`root@fobiX:~# `) kannst du schon einiges sehen:
|
||||
- `root` dein aktuell aktiver Nutzername
|
||||
- `fobiX` der Hostname des Servers, an dem du angemeldet bist
|
||||
- `~` du befindest dich gerade in deinem *Homeverzeichnis*
|
||||
- `#` du besitzt root-Rechte (bei nicht privillegierten Nutzern steht da `$`)
|
||||
|
||||
## Erste Schritte
|
||||
1. Nachdem verteilt wurde, wer welchen Server bekommt, solltest du den Server auf den neuesten Update-Stand bringen, damit wir alle die selben Voraussetzungen vorfinden.
|
||||
- Paketquellen aktualisieren:
|
||||
```sh
|
||||
root@fobiX:~# apt update
|
||||
```
|
||||
- Alle Updates ohne erneute Rückfrage installieren:
|
||||
```sh
|
||||
root@fobiX:~# apt -y upgrade
|
||||
```
|
||||
Dieser Vorgang dauert je nach verfügbaren updates auch mal länger. Bei unseren frischen Server etwa 30 Sekunden.
|
||||
|
||||
2. Um dieses Git-Repo auf dem Server verwenden zu können, benötigst du das Programm-Paket `git`, welches du mit einem einfachen Befehl installieren kannst:
|
||||
```sh
|
||||
root@fobiX:~# apt -y install git
|
||||
```
|
||||
|
||||
3. Mit git bist du jetzt in der Lage, das komplette Repo auf deinen Server zu clonen. Die Adresse musst du nicht von Hand abtippen (darfst du aber), die kannst du oben im Repo mit einem Mausklick bequem in die Zwischenablage kopieren.
|
||||
|
||||
```sh
|
||||
root@fobiX:~# git clone https://git.az-it.net/az/docker-fobi.git
|
||||
```
|
||||
danach wechselst du mit `cd d<tab><enter>` in das heruntergeladene Verzeichnis. *d<tab>* bedeutet: Du tippst den Buchstaben "d" und drückst dann die <tab>-Taste. Dadurch wird der Rest des Kommandos automatisch vervollständigt, was Tippfehler verhindert und Zeit spart.
|
||||
|
||||
|
||||
Damit hast du jetzt Zugriff auf die Dateien aus dem Repo direkt auf dem Server.
|
||||
|
||||
### Bash-Skripte im Verzeichnis "scripts"
|
||||
um verschiedene Vorgänge zu beschleunigen, habe ich die Befehlsabfolgen in Bash-Skripte verpackt. Das hat den Vorteil, dass man die Befehle dann nicht mehr einzeln von Hand eingeben muss, sondern durch den simplen Aufruf des Skriptes automatisch laufen lassen kann.
|
||||
Das läuft dann immer gleich ab.
|
||||
**Beispiel 1:**
|
||||
führe das Skript `00-Beispiel1.sh` aus, indem du
|
||||
```sh
|
||||
root@fobiX:~# bash scripts/00-Beispiel1.sh
|
||||
```
|
||||
ausführst. Tippe dabei nicht unnötig viel von Hand, sondern verwende oft die **<tab>-Taste**.
|
||||
hier z.B. `bash sc<tab>00<tab>`
|
||||
|
||||
### Übersichtlicheren Systemprompt setzen
|
||||
Im Verzeichnis prompts sind verschiedene Systemprompt-Definitionen gespeichert.
|
||||
Um das Terminal etwas zu verschönern (und übersichtlicher zu machen) setze den Systemprompt durch Eingabe von
|
||||
```sh
|
||||
. prompts/mit_datum_und_returncode
|
||||
```
|
||||
(vergiss auch hier die <TAB>-Taste nicht...)
|
||||
|
||||
Loading…
Add table
Reference in a new issue