Installation on oPBWeb Handbuch

Voraussetzungen

Mon, 01 Jan 0001 00:00:00 +0000

Zielgruppe: Technische Administration

Überblick

Dieses Kapitel listet alles, was vor der Installation bereitstehen muss: ein Docker-Host, freie Ports, eine Netzwerkverbindung zum opsi-Configserver und ein technischer opsi-Benutzer. Prüfe die Punkte der Reihe nach, bevor du mit der Installation beginnst.

Host

oPBWeb läuft auf jedem Linux-Host mit Docker. Du kannst den Stack direkt auf dem opsi-Configserver betreiben oder auf einem eigenen Host, der den Configserver per HTTPS erreicht.

Betriebssystem: Linux mit aktuellem Docker Engine.
Docker Compose: das Compose-Plugin (Version 2, Aufruf docker compose). Das alte eigenständige docker-compose (Version 1) reicht nicht, weil die Compose-Datei Funktionen wie Datei-Secrets und service_completed_successfully nutzt.
Bash und OpenSSL: Die Skripte setup-opbweb.sh, start.sh, stop.sh und scripts/init-secrets.sh sind Bash-Skripte, die Secrets werden mit openssl erzeugt.
Git: zum Holen der Quellen.
Speicherplatz: Der Objektspeicher wächst mit den Paketdateien. Plane genug Platz für die Docker-Volumes ein (Datenbank, Objektspeicher). Feste Mindestwerte für CPU, Arbeitsspeicher oder Plattenplatz gibt es nicht; die Container laufen ohne Ressourcenlimits.

Ports

Nach außen öffnet der Stack nur den Frontend-Container. Alle anderen Dienste kommunizieren in internen Docker-Netzen.

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Zielgruppe: Technische Administration

Überblick

Die Installation besteht aus wenigen Schritten: Quellen holen, ./setup-opbweb.sh ausführen (es schreibt die Konfigurationsdatei .env und erzeugt die Secrets), optional ein TLS-Zertifikat ablegen und den Stack starten. Die Images baust du dabei entweder lokal mit ./start.sh --build oder ziehst sie fertig aus einer Registry. Danach prüfst du, ob alle Dienste laufen, und machst mit der Ersteinrichtung in der Oberfläche weiter.

Alle Befehle führst du im Projektverzeichnis auf dem Docker-Host aus. Prüfe vorher die Voraussetzungen .

Ersteinrichtung

Mon, 01 Jan 0001 00:00:00 +0000

Rolle: Administrator

Überblick

Nach der Installation ist oPBWeb erreichbar, kennt aber noch keinen opsi-Server und hat nur ein Konto: den ersten Administrator. In der Ersteinrichtung meldest du dich mit diesem Konto an, änderst sein Passwort, verbindest oPBWeb mit einem oder mehreren opsi-Configservern, legst die Stufen der Depots fest und richtest die ersten Benutzer ein.

Du brauchst dafür das Admin-Passwort aus secrets/admin_password.txt, die Zugangsdaten des technischen opsi-Benutzers und einen Shell-Zugang zum Configserver, um den Fingerabdruck des CA-Zertifikats zu prüfen.

Testumgebung

Mon, 01 Jan 0001 00:00:00 +0000

Zielgruppe: Technische Administration, alle, die oPBWeb ausprobieren wollen

Überblick

Die Testumgebung startet oPBWeb zusammen mit zwei nachgebauten opsi-Servern (opsiconfd-Mocks). Damit probierst du den Editor und den ganzen Ablauf aus, vom Import aus der Workbench über das Bauen bis zur Übernahme von Test nach Produktion, ohne einen echten opsi-Server.

Configserver in oPBWeb	Stufe	Depots	Mock-Container
`opsi-test`	Test	`opsi-test.mock` (Configserver), `depot-test.mock`	`opbweb-opsi-mock-test`
`opsi-prod`	Produktion	`opsi-prod.mock` (Configserver), `depot-prod.mock`	`opbweb-opsi-mock-prod`

Die Mocks laufen mit dem Backend-Image von oPBWeb, ihr Code kommt aus tools/opsi-mock/opsi_mock.py. Beides liegt im Klon des Repositorys und im Stack-ZIP . Die Kurzfassung dieser Anleitung steht als START-TEST-ENVIRONMENT_de.md daneben.