So werden Team-Apps betrieben
Wo Team-Apps laufen, wie sie isoliert und begrenzt sind, wie ihre Basis-Images mit automatischem Zurückrollen aktuell bleiben, wie ein Scanner Funde einer App zuordnet und wie Daten, Secrets und Netzzugriff geregelt sind. Für IT- und Security-Teams.
Enterprise, für die IT
Team-Apps gehören zum Enterprise-Plan. Diese Seite ist für die IT- und Security-Teams, die die Runner betreiben und Fragen dazu beantworten.
Teams bauen mit kanman kleine Apps: Dashboards, Werkzeuge, Formulare, Berichte. Diese Seite erklärt, wo diese Apps laufen und was sie eingrenzt. Wie die Browser der Leute sie erreichen, steht unter Apps direkt erreichbar machen.
Wo Apps laufen
Team-Apps laufen nur auf den eigenen Runnern des Teams, in deinem Netz. Sie laufen nie in der kanman Cloud. Ein Team ohne Runner kann eine App bauen, sie wartet aber, bis ein Runner da ist.
Jede App hat einen Runner als Zuhause: den Runner, der ihre Daten hält. Jeder Start, jedes Backup und jede Anfrage an die App geht an diesen Runner. Bei mehr als einem Runner siehe Backups und Übergabe.
Statische Apps und Server-Apps
| Art | Was läuft |
|---|---|
| Statische App | Nur Dateien (HTML, Skripte, Styles). Das App-Gateway des Runners liefert die Dateien aus. Es läuft kein Prozess und kein Container, also gibt es kein Image zu aktualisieren. |
| Server-App | Ein Programm, das auf einem Port antwortet: Node.js, Python oder alles mit eigenem Dockerfile. Es läuft in einem Container auf dem Runner, ein Container pro App. |
Auf einem Runner ohne Docker laufen Node.js- und Python-Apps statt in einem Container in einer Sandbox mit eigenem Netz. Apps mit eigenem Dockerfile brauchen Docker.
Unterstützte Sprachen und Laufzeiten
| App | Image, auf dem sie läuft |
|---|---|
Node.js (eine package.json mit Start-Skript oder einem bekannten Web-Framework) |
node:24-bookworm |
Python (Django, Flask, FastAPI oder ein Procfile) |
python:3.12-bookworm |
Ein eigenes Dockerfile (jede Sprache; der Port kommt aus EXPOSE) |
Auf dem Runner aus dem Dockerfile gebaut |
Statische Website (eine index.html oder ein Build-Schritt, der eine erzeugt) |
Keins |
kanman erkennt die Art an den Dateien der App. Abhängigkeiten werden beim Start im eigenen Ordner der App installiert.
Isolation und Grenzen
Jede Server-App läuft in einem eigenen Container mit:
- 1 CPU und 1 GB Arbeitsspeicher und höchstens 512 Prozessen.
- Allen Linux-Capabilities entzogen und ohne Rechteausweitung (
no-new-privileges). - Node.js- und Python-Apps laufen unter dem eigenen Benutzerkonto des Runners, nicht als Root-Benutzer des Images.
- Einem eigenen internen Netz, keinem veröffentlichten Port und ohne Host-Netz.
- Neustart nach einem Absturz, bis zu dreimal.
- Installation, Build, Migrationen und Start müssen in 15 Minuten fertig sein.
Die App sieht nur ihre eigenen Dateien, ihren eigenen Datenordner und die Variablen, die kanman ihr mitgibt. Vom Runner sieht sie nichts: keine Runner-Secrets, keine Dateien anderer Apps.
Basis-Images und das tägliche Update
Jeder Container läuft auf einem Image, das auf seinem Runner pro App festgehalten ist. Eine neue Version von node:24-bookworm in der Registry ändert eine laufende App nie von selbst.
Einmal am Tag, in der ruhigsten Stunde der App (danach, wann Leute sie öffnen), aktualisiert kanman ihr Basis-Image:
- Der Runner holt das Basis-Image neu. Eine App mit eigenem Dockerfile wird mit
--pullneu gebaut. - Hat sich das Image nicht geändert, passiert nichts.
- Hat es sich geändert, prüft kanman die App auf dem Image, auf dem sie gerade läuft, startet sie auf dem neuen Image neu und prüft sie noch einmal, mit derselben Prüfung wie nach jedem Start.
- Kommt die App nicht hoch oder schlägt eine Prüfung fehl, die vorher bestanden war, setzt der Runner die App zurück auf das Image von vorher. Er hält dieses Image lokal getaggt, also klappt das Zurückrollen auch ohne Registry. Die Person, der die App gehört, erfährt es einmal, und dieses Update wird nicht noch einmal versucht; das nächste Update des Basis-Images schon.
Updates laufen auf jedem Runner eine App nach der anderen. Ohne Nutzungsdaten laufen sie um 03:00 Uhr in der Zeitzone des Teams, oder um 03:00 UTC, wenn das Team keine hat. Statische Apps haben kein Image und sind nicht betroffen.
Scannen
Lass deinen eigenen Scanner (zum Beispiel Trivy oder Grype) auf dem Runner-Host laufen. kanman versieht jeden Container, den es startet, mit Labels, damit Funde einer App zugeordnet werden können:
| Label | Wert |
|---|---|
kanman.runtime |
instance an jedem Container, den kanman startet |
kanman.app.id |
Die ID der App auf dem Runner |
kanman.app.version |
Die Version der App, die läuft |
kanman.app.base |
Das Basis-Image, zum Beispiel node:24-bookworm |
kanman.app.base-digest |
Der Registry-Digest des Basis-Images (sha256:...) |
kanman.app.image |
Bei einer App mit eigenem Dockerfile: die ID des gebauten Images |
Zum Beispiel listet docker ps --filter label=kanman.runtime=instance --format '{{.Names}} {{.Image}} {{.Label "kanman.app.base-digest"}}' die App-Container mit ihren Basis-Digests. Das Image einer Node.js- oder Python-App ist als kanman-base-<App-ID>:live getaggt, das einer App mit eigenem Dockerfile als kanman-app-<App-ID>; scanne diese Tags.
Die Seite der App zeigt dasselbe unter kanmans Prüfung > Image: das Basis-Image, seinen vollständigen Digest und bei einer Dockerfile-App die ID des gebauten Images, wann zuletzt nach Updates geschaut wurde und ein Update, das zurückgerollt wurde. Leute im Team, dem die App gehört, können den Digest dort kopieren, um einen Fund zuzuordnen.
Daten
Eine Server-App hält ihre Daten in ihrem eigenen SQLite-Speicher auf ihrem Zuhause-Runner, im Container unter /data eingehängt (die Variable KANMAN_STORE nennt die Datei). Eine App, die ihre eigene SQLite-Datei mitbringt, behält sie als ihren Speicher. Die Daten überstehen Neustarts, neue Versionen und Updates des Basis-Images.
- Backups: stündlich und vor jeder Änderung an der Struktur des Speichers (einer Migration).
- Fehlgeschlagene Migration: Das Backup von direkt davor wird zurückgespielt, und die Version davor bleibt live.
- Zurückrollen: Wenn du eine App zurückrollst, kommen Code und Daten zusammen zurück; die Daten von diesem Moment werden vorher gesichert, also geht nichts verloren.
Backups und Übergabe
Setze KANMAN_APP_BACKUP_ROOT auf jedem Runner auf einen Ordner, den alle Runner erreichen, zum Beispiel eine Netzwerkfreigabe. Die Backups landen dann dort. Wird der Zuhause-Runner einer App entfernt oder bleibt er 15 Minuten offline, übernimmt ein anderer Runner die App und spielt das neueste Backup zurück. Ohne gemeinsamen Ordner wartet die App auf ihren Zuhause-Runner; kanman startet sie nie anderswo mit anderen Daten.
Eine Datenbank, die deine IT betreibt
Eine App kann statt ihres eigenen Speichers eine Datenbank nutzen, die ihr betreibt. Ihr Host muss für die App freigegeben sein (siehe Netz), und ihre Verbindungsdaten erreichen die App als Variablen: Setze sie unter Einstellungen > Umgebung und Secrets, das Passwort als Secret (siehe Secrets).
Secrets
- Eine App bekommt ihre Einstellungen, Schlüssel und Tokens beim Start als Umgebungsvariablen. Sie landen nie in einem Image oder in den Dateien der App.
- Wo du sie setzt: Öffne die App, dann Einstellungen > Umgebung und Secrets. Die Person, der die App gehört, und die Leads des Teams können dort Variablen hinzufügen, ändern und entfernen; alle anderen im Team sehen nur die Namen. Namen bestehen aus Großbuchstaben, Ziffern und Unterstrichen. Namen, die der Runner selbst setzt (etwa
PORT, Proxy-Einstellungen oderKANMAN_...), lehnt kanman ab. - Werte von Secrets kann man nur schreiben. Eine Variable mit Secret erscheint nach dem Speichern maskiert und geht nie zurück an einen Browser. Du kannst sie ersetzen, aber nicht lesen. Eine normale Variable zeigt ihren Wert den Personen, die die App ändern dürfen. Jeder Wert wird verschlüsselt gespeichert.
- Jede Änderung startet die Live-App neu mit den neuen Werten, mit derselben Prüfung wie nach jedem Start. Startet die App damit nicht, setzt kanman die Werte wie vorher zurück, startet sie erneut und sagt der Person Bescheid, der die App gehört.
- Zugänge, die die Person setzt, der die App gehört, sind erlaubt. Eine Live-App braucht meist echte Zugänge. Deshalb kommt ein Wert durch, den sie oder ein Lead gesetzt (oder behalten) hat, auch wenn er wie ein Schlüssel, ein Token oder eine Verbindungs-URL mit Passwort aussieht.
- Die eigenen Secrets des Runners gibt kanman nie weiter. Ein Wert, der eines der eigenen Secrets des Runners enthält, fällt weg, ebenso ein Name, den der Runner selbst setzt. Die Einstellungen zeigen, welche Variable der letzte Start weggelassen hat und warum, nur mit ihrem Namen.
- Lädt jemand eine App mit einem Schlüssel oder Token im Code hoch, legt kanman ihn beiseite, verschlüsselt, und fragt die Person, der die App gehört. Mit einem Ja wandert er in die Umgebung der App; sonst wird er gelöscht.
- Wer welche Variable wann hinzugefügt, geändert oder entfernt hat, steht im Audit-Log des Teams, nur mit dem Namen, nie mit dem Wert.
- Vorschauen von Merge Requests bleiben strenger: kanman lehnt Variablen ab, deren Name nach Produktion klingt (
PROD_*,*_PRODUCTION,LIVE_*), Namen, die das Team als Produktion führt, Werte, die eines der eigenen Secrets des Runners sind, und Werte, die wie ein echter Zugang aussehen (Cloud-Schlüssel, Live-Zahlungsschlüssel, private Schlüssel, Tokens von Code-Hosts). Abgelehnte Variablen fallen weg; die Vorschau startet ohne sie. - Einstellungsdateien anderer Umgebungen (
.env.production,.env.local) werden entfernt, bevor irgendetwas läuft.
Netz
- Ausgehend: standardmäßig gesperrt. Der Container jeder App hängt in einem eigenen Netz, dessen einziger Weg nach draußen kanmans Egress-Proxy auf dem Runner ist. Während der Installation sind nur die Paket-Registries erreichbar (npm, PyPI); danach nur die Hosts, die für diese App freigegeben sind. Hosts, die das Team als Produktion führt, sind nie erreichbar. Das setzt das Netz auf dem Runner durch, nicht die App.
- Hosts, die eine App zu erreichen versucht hat und die keine Regel erlaubt, werden blockiert und zu Fragen an die Person, der die App gehört. Je nach Regeln des Teams braucht eine Freigabe einen Lead.
- Eingehend: nur über kanman. Kein Container veröffentlicht einen Port. Das App-Gateway des Runners ist der einzige Weg hinein, und es lässt nur Leute herein, die kanman hereinlässt, jede Person mit ihren eigenen Rechten. Die einzige Ausnahme sind Routen, die die Person, der die App gehört, für Aufrufe von außen freigegeben hat (zum Beispiel ein Webhook).
- Wie Browser das Gateway erreichen, wird pro Workspace eingestellt: über kanman (Standard) oder direkt unter deiner eigenen HTTPS-Adresse. Siehe Apps direkt erreichbar machen.
Siehe auch: Hosting und Datenresidenz, Sandbox und Secrets, Self-hosted Runner.
Zuletzt aktualisiert: January 1, 0001
kanman öffnen