Server-Edition

Spectrum für Ihr Team bereitstellen

Die Server-Edition läuft im Container mit der PostgreSQL-Datenbank Ihres Unternehmens. Die Anleitung führt von der Imagevorbereitung bis zu erstem Import, Zugriffskonfiguration und Updates. Das Image erfüllt OpenShift-Anforderungen, einschließlich Betrieb ohne Root mit beliebiger UID in Gruppe 0.

1. Container-Image vorbereiten

Name und Registry stehen in der E-Mail mit dem Schlüssel sowie in der Datei manifest.json des Releases: <rejestr>/viewer-pro-server:<wersja>. Hat der Cluster keinen Zugriff auf die externe Registry, laden Sie das Image aus der Datei viewer-pro-server-<wersja>.tar in die interne Registry:

podman load -i viewer-pro-server-1.4.2.tar
podman tag viewer-pro-server:1.4.2 default-route-openshift-image-registry.apps.firma.local/viewer-pro/viewer-pro-server:1.4.2
podman push default-route-openshift-image-registry.apps.firma.local/viewer-pro/viewer-pro-server:1.4.2

2. PostgreSQL vorbereiten

Bereiten Sie PostgreSQL 16 mit einer Datenbank mit ICU-Gebietsschema vor: pl-PL, einer Datenbank und einer Rolle mit dem Recht, Tabellen in folgendem Schema zu erstellen: public. Prüfen Sie die Datenbankparameter in der Anleitung des gewählten Releases.

CREATE ROLE viewer_pro LOGIN PASSWORD '...';
CREATE DATABASE viewer_pro OWNER viewer_pro;

Planen Sie Speicher für Konfiguration, Historie und Sicherungen. Bestätigen Sie den Ressourcenbedarf im Pilotbetrieb. Die optionale Datei postgres.yaml dient nur Tests; Produktionsdatenbanken sind nach den Betriebsstandards Ihrer Organisation vorzubereiten.

3. Zugangsdaten und Lizenzschlüssel speichern

Erstellen Sie ein Secret mit Datenbankadresse, Verschlüsselungsschlüssel des Geheimnisspeichers und Lizenzschlüssel. Die Datei secret.example.yaml ist eine Vorlage; bewahren Sie sie nach Eintragen der Zugangsdaten außerhalb des Repositorys auf.

oc new-project viewer-pro
oc create secret generic viewer-pro \
  --from-literal=WC_PG_URL='postgres://viewer_pro:HASLO@pg.firma.local:5432/viewer_pro?sslmode=require' \
  --from-literal=WEBCON_SECRET_KEY="$(openssl rand -base64 32)" \
  --from-literal=WEBCON_LICENSE='WCR1....'

4. Bereitstellungsdateien anwenden

Das Paket viewer-pro-openshift-<wersja>.zip enthält deployment.yaml, service.yaml, route.yaml, secret.example.yaml und kustomization.yaml. Tragen Sie Imageadresse und Routenhostname ein und führen Sie aus:

cd deploy/openshift
# kustomization.yaml: images[0].newName / newTag; route.yaml: spec.host
oc apply -k .
oc rollout status deploy/viewer-pro
oc get route viewer-pro -o jsonpath='{.spec.host}{"\n"}'

Die Standardbereitstellung benötigt eine Anwendungsreplik. Erhöhen Sie die Replikazahl nur, wenn die Unterstützung für diese Konfiguration in der gewählten Edition bestätigt ist.

ElementWert
Containerport8080 (Variable PORT; OpenShift kann einen anderen zuweisen)
Readiness / LivenessGET /healthz → 200 mit Programmversion
BenutzerNicht-Root, beliebige UID in Gruppe 0 (chgrp 0, chmod g=u auf beschreibbaren Verzeichnissen)
RessourcenRequests 250m / 512Mi, Limits 1 CPU / 2Gi — Ausgangswerte; an Konfigurationsgröße und Last anpassen
RouteTLS Edge oder Reencrypt; das Programm unterstützt X-Forwarded-* und setzt Sicherheitsheader (CSP mit Nonce, HSTS)
ProtokollierungJSON-Protokolle auf stdout; Begrenzung der Anmeldeversuche (Rate Limit)

5. Docker / Podman ohne Orchestrator

docker run -d --name viewer-pro \
  -p 8080:8080 \
  -e WC_PG_URL='postgres://viewer_pro:HASLO@pg.firma.local:5432/viewer_pro' \
  -e WEBCON_SECRET_KEY="$(openssl rand -base64 32)" \
  -e WEBCON_LICENSE='WCR1....' \
  --restart unless-stopped \
  <rejestr>/viewer-pro-server:1.4.2

curl -s http://localhost:8080/healthz

Schalten Sie einen Reverse Proxy mit TLS vor den Container, etwa nginx, Traefik oder Caddy. Dieser übernimmt die verschlüsselte HTTPS-Verbindung.

6. Teamzugang einrichten

  1. Öffnen Sie bei leerer Datenbank die Anwendung und erstellen Sie das erste Administratorkonto mit eigenem Login und starkem Passwort. Führen Sie dies vor Freigabe der Adresse an weitere Benutzer aus. Konto und Passwort werden nicht automatisch im Protokoll erstellt.
  2. Rollen und Zugriffsrechte: Erstellen Sie Rollen (z. B. „Analysten“, „Bereitstellungsteam“), vergeben Sie Lesebereiche (alle Umgebungen / Arbeitsbereich / Umgebung / Anwendung) und ordnen Sie Konten zu. Ein Konto ohne Rolle sieht nach Anmeldung eine leere Liste; „Effektiver Zugriff“ zeigt die Sicht jeder Person.
  3. Anmeldung. Die hier beschriebene Edition unterstützt lokale Konten und Rollen. Für Organisationen mit Microsoft Entra ID ist auch eine SSO-Edition verfügbar. Bestätigen Sie Imagewahl und Anmeldekonfiguration vor der Bereitstellung; ein vorgeschaltetes Gateway ersetzt nicht die Berechtigungskontrolle der Anwendung.

7. Konfiguration laden und Zeitplan festlegen

Pakete .bpe können hochgeladen werden im Reiter Import. Alternativ kopieren Sie Dateien in den Container und starten den Import über oc exec:

oc cp ./eksport/DEV viewer-pro-xxxx:/tmp/dev
oc exec deploy/viewer-pro -- viewer-pro ingest import "/tmp/dev/*.bpe" --workspace "Klient A" --env DEV

MS-SQL-Quellen konfigurieren Sie im Reiter SQL-Quellenund den Zeitplan unter Arbeitsbereich. Wählen Sie Abrufintervall oder Uhrzeit und prüfen Sie die Ausführung im Abrufprotokoll. Unveränderte Konfiguration benötigt keinen neuen Snapshot.

Zugriffslimits. Der Firmentarif bestimmt die Anzahl aktiver Benutzer, der Partnertarif die Kundenarbeitsbereiche. Am Limit verhindert das Programm weitere Konten oder Arbeitsbereiche und zeigt einen Hinweis. Vorhandene Daten bleiben zugänglich. Definitionen aktiver Benutzer und Kundenarbeitsbereiche stehen in der Tariftabelle, die Regeln für Tarifwechsel in der Lizenzanleitung.

8. Anwendung aktualisieren

pg_dump -Fc viewer_pro > viewer_pro-przed-1.5.0.dump
oc set image deploy/viewer-pro viewer-pro=<rejestr>/viewer-pro-server:1.5.0
oc rollout status deploy/viewer-pro

Sichern Sie vor dem Imagewechsel die Datenbank und folgen Sie der Release-Anleitung. Gespeicherte Snapshots bleiben verfügbar. Ein älteres Image erfordert die Wiederherstellung einer Sicherung vor dem Update. Prüfen Sie auch das Jahresabonnement. Ohne Verlängerungszahlung wird der Zugang nach der vereinbarten Nachfrist gesperrt, auch bei Rückkehr zu einer älteren Version.

9. Erforderliche Verbindungen prüfen

Vollständige Liste der Daten, die das Netzwerk verlassen: Sicherheit.