Gegenstand
Läuft bei Ihnen. Auch ohne Internet.
Doconform kommt als Container für Kubernetes, OpenShift oder Docker Compose. Für abgeschottete Netze gibt es ein signiertes Offline-Bundle. Die Lizenz wird offline geprüft.
Installation
Drei Wege ins Rechenzentrum.
| Weg | Wann |
|---|---|
| Helm-Chart | Kubernetes oder OpenShift, mehrere Instanzen, Rolling Updates |
| Docker Compose | ein Host |
| Offline-Bundle | Netze ohne Zugang zu unserer Registry; enthält Images, Chart, Compose, SBOMs und eine signierte Prüfsummenliste |
Die Images liegen in einer zugangsgeschützten Registry mit eigenem Zugang je Kunde. Doconform läuft auf Linux (amd64). Windows-Server und Microsoft Office braucht Doconform nicht.
Schnellstart ansehenRessourcen
Was Doconform braucht.
Docker Compose auf einem Host: mindestens 4 CPU und 12 GB RAM, mit Virenscan 16 GB. Eine Datenbank ist nicht nötig. Mit einer H2-Datei oder PostgreSQL bleiben Verlauf und Zählung über Neustarts erhalten, und Profile lassen sich in der Konsole bearbeiten.
Alle Zahlen stehen mit ihren Messbedingungen unter Testkorpus und Berichte.
Durchsatz und Skalierung
Mehr Volumen, mehr Instanzen.
Eine Instanz mit 4 CPU wandelte in der Messung 6.510 Dokumente je Stunde. Für mehr Volumen starten Sie weitere Instanzen. Schritte mit viel Last, etwa Office-Dateien oder große PDFs, legen Sie auf eigene Instanzen.
| Messung | Ergebnis | Bedingungen |
|---|---|---|
| Durchsatz einer Instanz | 6.510 / h, kein Fehler | Release 1.5.0, 4 CPU und 8 GiB, Parallelität 6, 30 min gemischter Plan |
| Zwei Instanzen statt einer | 1,77-fach | Version 0.9, je 3,5 CPU, beide auf einem voll belegten Rechner mit 8 CPU; mit 1.5.0 nicht wiederholt |
| Fehler in 8,5 h Dauerlast | 0 von 395.407 | Vorabstand von Release 1.0.0, 4 parallel, 13 kleine Testdateien im Wechsel |
| Update unter Last | 8.690 Anfragen, alle beantwortet | Abnahmetest mit dem Stand von Release 1.5.0, Test-Cluster, 4 parallele Bildkonvertierungen während des Rolling Updates |
Bei Überlast:
- Jeder Verarbeitungsschritt hat eine feste Zahl gleichzeitiger Plätze. Ist ein Schritt voll, wartet die Anfrage bis zu 30 Sekunden auf einen Platz.
- Danach antwortet Doconform mit 503
OVERLOADEDundRetry-After: 30. Ihr System wiederholt die Anfrage nach der Wartezeit, laufende Anfragen arbeiten weiter. - PDFs liest Doconform in eigenen Teilprozessen mit festem Speicherbudget. Sprengt eine Datei das Budget, scheitert nur diese Datei mit
PDF_TOO_COMPLEX. Der Dienst läuft weiter.
Skalieren
Mehr Instanzen kosten nichts extra.
Lizenziert ist das Monatsvolumen. Instanzen und Pods skalieren Sie frei, auch für Ausfallsicherheit. Die Lizenzdatei ist signiert und wird offline geprüft. Überschreitung oder Ablauf meldet Doconform in Konsole, Log und Metrik. Gewandelt wird weiter.
Beobachten
Was der Betrieb sieht.
- JSON-Logs (ECS) auf stdout, Prometheus-Metriken, OTLP-Tracing, Health-Endpunkte
- Vorgangsprotokoll ohne Inhalte und standardmäßig ohne Dateinamen; Einzelvorgänge 90 Tage (einstellbar), danach nur Summen
- Suche nach einem Vorgang per Korrelations-ID
Sicherheit im Betrieb
Eng gefasst.
- Container ohne Root, mit schreibgeschütztem Dateisystem, ohne Linux-Capabilities und ohne Rechteausweitung
- Das Rendern hat keinen ausgehenden Netzzugang, HTML wird ohne JavaScript dargestellt, externe Inhalte werden nicht geladen
- Die Schnittstelle nimmt Anfragen nur mit API-Key oder OIDC an; Keys speichert Doconform nur als Hash
- PDFs werden in einem eigenen, begrenzten Teilprozess gelesen; ein präpariertes PDF trifft nur diesen Prozess
- Images, Chart und Offline-Bundle sind signiert, zu jedem Image gibt es eine Komponentenliste (SBOM)
Updates
Quartalsweise, Sicherheitsfixes sofort.
Neue Versionen erscheinen quartalsweise, Sicherheitsfixes sofort als Patch. Jede Version pflegen wir mindestens zwölf Monate. Prüfen Sie vor jedem Update die Signatur, die Anleitung liegt bei.
Rückfragen
Kurz beantwortet.
- Braucht Doconform Internetzugang?
- Nein. Betrieb, Lizenzprüfung und Updates über das Offline-Bundle gehen ohne Internet.
- Wie viele Instanzen darf ich betreiben?
- So viele Sie brauchen. Die Lizenz begrenzt das Monatsvolumen, nicht die Zahl der Instanzen.
- Was passiert, wenn die Lizenz abläuft oder das Volumen überschritten ist?
- Doconform wandelt weiter und meldet den Zustand in Konsole, Log und Metrik.
- Läuft Doconform unter Windows?
- Nein. Doconform läuft in Linux-Containern (amd64). Windows-Server und Microsoft Office sind nicht nötig.
- Wie viele Dokumente schafft Doconform?
- Eine Instanz mit 4 CPU wandelte in der Messung mit Release 1.5.0 6.510 Dokumente je Stunde, bei gemischten Formaten. Für mehr Volumen betreiben Sie weitere Instanzen. Ihr eigener Mix kann abweichen, deshalb messen wir im Pilot mit Ihren Dateien.
- Was passiert bei Überlast?
- Doconform nimmt je Schritt nur so viele Anfragen an, wie Plätze frei sind. Ist ein Schritt voll, antwortet es mit 503 und
Retry-After: 30, und Ihr System wiederholt die Anfrage.
Mit Brief und Siegel.