README.md

Allgemeine Doku zur internen Infrastruktur

Betrifft die beiden Ubuntu Maschinen gitlab.mdctec.com und dev.mdctec.local

• Allgemeine Doku zur internen Infrastruktur
  • Typischer Workflow zur Wartung eines Servers
  • "Infrastruktur as Code"
  • Setup der Infrastruktur

Typischer Workflow zur Wartung des Servers

1. Verbindung herstellen

   ssh <USER>@dev.mdctec.local

   ℹ️ <USER> besteht aus "<1. Buchstabe Vorname><5 Buchstaben Nachname>"
   also z.B.: sguert, qbuech, marndt, jgerst

   ℹ️ Jeder Benutzer hat initial dieses Standart Passwort welches beim ersten Login geändert werden muss.

2. Zu den Konfigurationsdateien wechseln.

   cd /etc/mtec/dev-infrastructure

   ℹ️ Der Ordnername - hier dev-infrastructure - heißt auf jeder Maschine anders, entsprechend dem Hostnamen. Andere Beispiele: gitlab-infrastructure

   Hier sollten jetzt alle Konfigurationsdateien liegen, die die aktuelle Maschine betreffen.

   root@dev:/etc/mtec/dev-infrastructure# ll
   total 24
   drwxrwsr-x 4 root mtec 4096 Apr  5 15:37 ./
   drwxrwsr-x 3 root mtec 4096 Apr  5 13:29 ../
   -rw-rwxr-- 1 root mtec 1935 Apr  5 15:37 README.md*
   -rw-rwxr-- 1 root mtec  734 Apr  5 13:29 docker-compose.yml*
   drwxrwsr-x 2 root mtec 4096 Apr  5 13:44 gitlab-runner/
   drwxrwsr-x 2 root mtec 4096 Apr  5 13:29 registry/

   ℹ️ Anpassungen sind lokal auf dem Server möglich und können mit Git verwaltet und auch gepusht werden

Infrastruktur as Code

Wir versuchen das Konzept "Infrastruktur as Code" ansatzweise umzusetzen. (Bitte! 😉)

📜 Regeln

• Alles, was auf einer Servermaschine manuell installiert/konfiguriert soll in das Mdctec Infrastructure Repository aufgenommen werden

💡 Konzept

Dazu sind die Server dev.mdctec.local und gitlab.mdctec.com folgendermaßen strukturiert:

• Das MDCTec Infrastructure Gitlab Repository liegt geklont unter /etc/mtec/infrastructure
  Für den DEV Server (dev.mdctec.local) sieht das z.B. so aus:

  root@dev:~# ls -la /etc/mtec/infrastructure
  total 20
  drwxr-xr-x 5 root root 4096 Apr  1 07:21 .
  drwxr-xr-x 3 root root 4096 Apr  1 07:00 ..
  drwxr-xr-x 8 root root 4096 Apr  1 09:00 .git
  drwxr-xr-x 3 root root 4096 Apr  1 06:58 machines
  drwxr-xr-x 4 root root 4096 Apr  1 07:24 scripts

  Achtung: Es wird das sparse-checkout feature von Git verwendet!

  root@dev:/etc/mtec/infrastructure# cat .git/info/sparse-checkout
  /machines/dev.mdctec.local
  /scripts/

• Es gibt einen Link /etc/mtec/dev-infrastructure bzw /etc/mtec/gitlab-infrastructure auf das entsprechende Unterverzeichnis in machines/*

  root@dev:/etc/mtec# ls -l dev-infrastructure
  lrwxrwxrwx 1 root mtec 58 Apr  1 07:09 dev-infrastructure -> ./infrastructure/machines/dev.mdctec.local/

Setup der Infrastruktur

Details wie ein Server neu installiert werden kann