Container-Registry
grommunio veröffentlicht seine Container-Images und das Helm-Chart unter
https://container.grommunio.com. Die Images werden von der
Docker-Compose-Bereitstellung und vom
Helm-Chart für Kubernetes verwendet; die Build-Dateien liegen im
Repository gromox-container.
Projekte und Editionen
Abschnitt betitelt „Projekte und Editionen“Die Registry enthält ein Projekt pro Edition:
| Pfad | Zugriff | Inhalt |
|---|---|---|
community/gromox-core, community/gromox-archive, community/gromox-office | öffentlich, anonymer Pull | aus den grommunio-Community-Paketen erstellt |
supported/gromox-core, supported/gromox-archive, supported/gromox-office | Kunden mit grommunio-Subskription | aus den grommunio-Supported-Paketen erstellt |
community/mariadb | öffentlich, anonymer Pull | Spiegel von docker.io/library/mariadb:11.8, wird vom Helm-Chart verwendet |
community/charts/grommunio | öffentlich, anonymer Pull | Helm-Chart (OCI-Artefakt) |
Die drei Images sind:
| Image | Inhalt |
|---|---|
gromox-core | Groupware-Kern: Gromox, Postfix, nginx, Admin API, Antispam, Chat |
gromox-archive | grommunio Archive (optional) |
gromox-office | Dokumentbearbeitung und grommunio Files (optional) |
Beide Editionen verwenden dasselbe Datenformat. Eine Installation lässt sich
zwischen ihnen wechseln, indem Sie den Image-Pfad ändern, zum Beispiel mit einem
helm upgrade, das global.edition setzt.
Tags und Aufbewahrung
Abschnitt betitelt „Tags und Aufbewahrung“Jedes Image trägt drei Arten von Tags:
| Tag | Beispiel | Bedeutung |
|---|---|---|
<version> | 2026.11 | neuester Build dieses Releases; wandert mit jedem neuen Build mit |
<version>-<YYYYMMDDhhmm> | 2026.11-202611170300 | ein bestimmter Build; ändert sich nie |
latest | latest | neuester Build des neuesten Releases |
Die Community-Images werden täglich aus den aktuellen Paketen neu erstellt. Der
Tag <version> erhält dadurch Paketkorrekturen und Updates des Basisbetriebssystems,
ohne dass ein neues grommunio-Release nötig ist. Die Registry bewahrt die letzten
14 Builds jedes Images auf; ältere Build-Tags werden entfernt.
Für reproduzierbare Bereitstellungen fixieren Sie einen Build-Tag oder den Digest.
Die verfügbaren Tags listen Sie mit skopeo auf, ebenso lesen Sie damit den Digest
eines Tags aus:
skopeo list-tags docker://container.grommunio.com/community/gromox-coreskopeo inspect --format '{{.Digest}}' \ docker://container.grommunio.com/community/gromox-core:2026.11Die Tag-Liste enthält auch die Signatur-Tags (sha256-<digest>.sig).
Im Helm-Chart setzen Sie den Digest je Komponente in image.<component>.digest
(core, archive, office, mariadb).
Images beziehen
Abschnitt betitelt „Images beziehen“Community-Edition
Abschnitt betitelt „Community-Edition“Für das Community-Projekt ist keine Anmeldung nötig:
docker pull container.grommunio.com/community/gromox-core:2026.11podman pull container.grommunio.com/community/gromox-core:2026.11Das Helm-Chart wird direkt aus der Registry installiert:
helm install grommunio oci://container.grommunio.com/community/charts/grommunio \ --version 0.2.0 -n grommunio --create-namespace -f values.yamlStandardmäßig bezieht das Chart die Community-Images (global.edition: community).
Die docker-compose.yml des Repositorys gromox-container erstellt die Images
lokal. Um stattdessen die veröffentlichten Images mit Docker Compose zu betreiben,
ersetzen Sie den Abschnitt build: von gromox-core, gromox-archive und
gromox-office jeweils durch eine image:-Zeile, zum Beispiel
image: container.grommunio.com/community/gromox-core:2026.11. Die Schritte sind
unter Container-Installation beschrieben.
Supported-Edition
Abschnitt betitelt „Supported-Edition“Die Zugangsdaten für das Projekt supported/ sind ein Robot-Konto, das Sie mit
Ihrer grommunio-Subskription erhalten. Der Benutzername hat die Form
robot$supported+<customer>. Das Konto darf nur Images beziehen (Pull) und hat
ein Ablaufdatum.
Melden Sie sich einmal pro Host an und beziehen Sie dann die Images:
docker login container.grommunio.com -u 'robot$supported+<customer>'docker pull container.grommunio.com/supported/gromox-core:2026.11Mit Podman verwenden Sie podman login auf dieselbe Weise. Setzen Sie den
Benutzernamen in einfache Anführungszeichen, da die Shell sonst $supported
expandiert.
Pull-Secret für Kubernetes
Abschnitt betitelt „Pull-Secret für Kubernetes“Für die Supported-Edition legen Sie im Namespace des Releases ein Pull-Secret an und referenzieren es in den Chart-Values:
kubectl -n grommunio create secret docker-registry grommunio-registry \ --docker-server=container.grommunio.com \ --docker-username='robot$supported+<customer>' \ --docker-password='<password>'global: edition: supported imagePullSecrets: [grommunio-registry]Alternativ übergeben Sie die Zugangsdaten in den Values; das Chart legt dann
selbst ein Pull-Secret an (grommunio-registry für ein Release namens
grommunio) und verwendet es in jedem Pod:
global: edition: supported imageCredentials: username: robot$supported+<customer> password: "<password>"Das Chart selbst und der MariaDB-Spiegel bleiben für beide Editionen im
öffentlichen Projekt community/.
Signaturprüfung
Abschnitt betitelt „Signaturprüfung“Alle Images, der MariaDB-Spiegel und das Helm-Chart sind mit cosign signiert. Die Registry liefert keine unsignierten Images aus. Die Signaturen werden zusätzlich im öffentlichen Sigstore-Transparenzprotokoll (Rekor) erfasst.
Der öffentliche Schlüssel ist die Datei cosign.pub im Wurzelverzeichnis des
Repositorys gromox-container:
-----BEGIN PUBLIC KEY-----MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEgVmJ7UPppHd0JpNzhWZk8Y2yeagjdJIyBt0y5fsgPlwa/cigyGO4F3OZYIP9hhXBMtfPPGstrtyMlJmzoP7HmA==-----END PUBLIC KEY-----| Eigenschaft | Wert |
|---|---|
| Algorithmus | ECDSA P-256 |
| SHA-256-Fingerabdruck (DER) | fbc44512234982ede455c69a7386db363bde9c73975016bbbc0794a3515c590f |
Vergleichen Sie den Fingerabdruck Ihrer Kopie des Schlüssels, bevor Sie sich darauf verlassen:
openssl pkey -pubin -in cosign.pub -outform DER | sha256sumEin Image oder das Chart prüfen Sie so (cosign 2.x oder 3.x):
cosign verify --key cosign.pub container.grommunio.com/community/gromox-core:2026.11cosign verify --key cosign.pub container.grommunio.com/community/mariadb:11.8cosign verify --key cosign.pub container.grommunio.com/community/charts/grommunio:0.2.0Für die Supported-Edition melden Sie sich zuerst mit docker login an; cosign
verwendet dieselben Zugangsdaten.
Signaturen in Kubernetes erzwingen
Abschnitt betitelt „Signaturen in Kubernetes erzwingen“Admission-Controller wie Kyverno (ImageValidatingPolicy)
oder der Sigstore policy-controller
können Pods ablehnen, deren Images nicht mit dem grommunio-Schlüssel signiert sind.
Eine minimale Kyverno-Policy (Kyverno 1.17 oder neuer):
apiVersion: policies.kyverno.io/v1kind: ImageValidatingPolicymetadata: name: verify-grommunio-imagesspec: validationActions: [Deny] failurePolicy: Fail webhookConfiguration: timeoutSeconds: 30 matchConstraints: resourceRules: - apiGroups: [""] apiVersions: [v1] operations: [CREATE, UPDATE] resources: [pods] matchImageReferences: - glob: "container.grommunio.com/*" attestors: - name: grommunio cosign: key: data: | -----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEgVmJ7UPppHd0JpNzhWZk8Y2yeagj dJIyBt0y5fsgPlwa/cigyGO4F3OZYIP9hhXBMtfPPGstrtyMlJmzoP7HmA== -----END PUBLIC KEY----- validations: - expression: >- images.containers.map(image, verifyImageSignatures(image, [attestors.grommunio])).all(e, e > 0) message: image is not signed with the grommunio keyDie Policy prüft nur Images, die zu matchImageReferences passen; Images aus
anderen Registrys werden ungeprüft zugelassen. Kyverno wendet die Policy auch auf
Pod-Controller wie Deployments, StatefulSets, Jobs und CronJobs an und ergänzt
jede zugelassene Image-Referenz um den geprüften Digest
(container.grommunio.com/community/gromox-core:2026.11@sha256:...).
Kyverno-Versionen vor 1.17 verwenden stattdessen das Format ClusterPolicy mit
verifyImages, das Kyverno 1.20 nicht mehr akzeptiert.
Hinweise für bestimmte Umgebungen:
- Supported-Edition: Kyverno benötigt Zugangsdaten, um die Signaturen zu
lesen. Legen Sie das Pull-Secret zusätzlich im Kyverno-Namespace an und tragen
Sie es in der Policy unter
spec.credentials.secretsein. - Eigene Registry: Stammen die Images aus einem Spiegel,
ändern Sie
matchImageReferencesauf den Pfad des Spiegels, zum Beispielregistry.example.com/*.
Schwachstellenscan
Abschnitt betitelt „Schwachstellenscan“Jedes Image wird nach dem Hochladen in die Registry auf bekannte Schwachstellen
geprüft. Korrekturen im Basisbetriebssystem und in den grommunio-Paketen gelangen
über den täglichen Neubau in die Community-Images. Folgen Sie dem Tag <version>
oder aktualisieren Sie Ihre Digest-Fixierung regelmäßig, um sie zu erhalten.
Spiegeln in eine eigene Registry
Abschnitt betitelt „Spiegeln in eine eigene Registry“Umgebungen ohne Internetzugang (Air-Gap) und Installationen, die Builds länger als
die Aufbewahrungsfrist benötigen, kopieren die Images in ihre eigene Registry.
Behalten Sie den Pfad unterhalb des Registry-Hosts bei (community/... oder
supported/...), damit das Helm-Chart die Images findet, wenn nur
global.imageRegistry geändert wird.
Kopieren Sie die Images mit skopeo (--all kopiert die vollständige
Manifest-Liste) und anschließend ihre Signaturen mit cosign:
SRC=container.grommunio.comDST=registry.example.comfor img in community/gromox-core community/gromox-archive community/gromox-office; do skopeo copy --all docker://$SRC/$img:2026.11 docker://$DST/$img:2026.11 cosign copy --only=sig $SRC/$img:2026.11 $DST/$img:2026.11doneskopeo copy --all docker://$SRC/community/mariadb:11.8 docker://$DST/community/mariadb:11.8cosign copy --only=sig $SRC/community/mariadb:11.8 $DST/community/mariadb:11.8Für die Supported-Edition verwenden Sie die Pfade unter supported/ und melden
sich zuvor an beiden Registrys an (skopeo login, docker login).
cosign copy ohne --only kopiert ein Artefakt zusammen mit seiner Signatur in
einem Schritt; verwenden Sie es für das Helm-Chart:
cosign copy $SRC/community/charts/grommunio:0.2.0 $DST/community/charts/grommunio:0.2.0Richten Sie das Chart anschließend auf den Spiegel aus und prüfen Sie ein kopiertes Image gegen den grommunio-Schlüssel:
global: imageRegistry: registry.example.comcosign verify --key cosign.pub registry.example.com/community/gromox-core:2026.11helm install grommunio oci://registry.example.com/community/charts/grommunio \ --version 0.2.0 -n grommunio --create-namespace -f values.yamlEigene Images erstellen
Abschnitt betitelt „Eigene Images erstellen“Das Skript tools/publish-images.sh im Repository gromox-container erstellt die
drei Images für eine Edition und überträgt sie in eine Registry Ihrer Wahl. Jedes
Image wird unter seinem Build-Tag hochgeladen, per Digest signiert und erst danach
mit <version> getaggt (mit --latest zusätzlich mit latest). So zeigen die
beweglichen Tags nie auf ein unsigniertes Image.
| Option | Wirkung | Standard |
|---|---|---|
-c community|supported | Edition (Paketkanal) | community |
-r REGISTRY | Ziel-Registry | container.grommunio.com |
-t TAG | Versions-Tag | appVersion des Helm-Charts |
-b BUILD_ID | Suffix des Build-Tags | UTC-Datum und -Uhrzeit (YYYYMMDDhhmm) |
--latest | zusätzlich latest taggen | aus |
-n | nur erstellen, nicht hochladen | aus |
--no-sign | ohne Signatur hochladen | aus |
--no-cache | jede Schicht neu erstellen, sodass aktualisierte Pakete auch dann installiert werden, wenn sich die Dockerfiles nicht geändert haben | aus |
core archive office | zu erstellende Komponenten | alle drei |
Die Images heißen <REGISTRY>/<edition>/gromox-<component>. Melden Sie sich an
der Ziel-Registry mit einem Konto an, das Images hochladen darf, und erstellen,
signieren und übertragen Sie die Images dann mit Ihrem eigenen cosign-Schlüssel;
der grommunio-Signaturschlüssel ist nicht Teil des Repositorys. Führen Sie die
Befehle im Wurzelverzeichnis des Repositorys gromox-container aus:
cosign generate-key-pairCOSIGN_KEY=cosign.key COSIGN_PASSWORD='<key password>' \ tools/publish-images.sh -r registry.example.com -c community core archive officeOhne COSIGN_KEY wird das Hochladen verweigert, sofern nicht --no-sign
angegeben ist. COSIGN_KEY akzeptiert auch eine KMS-URI. Einen Build ohne
Hochladen testen Sie so:
tools/publish-images.sh -n -c communityFür Supported-Builds benötigen Sie Ihre grommunio-Subskriptionszugangsdaten im Credentials-Format von zypper. Die Datei wird dem Build als BuildKit-Secret übergeben und in keiner Image-Schicht gespeichert:
printf 'username=%s\npassword=%s\n' '<subscription user>' '<subscription password>' \ > supported.credentialsSUPPORTED_CREDENTIALS=$PWD/supported.credentials COSIGN_KEY=cosign.key \ COSIGN_PASSWORD='<key password>' \ tools/publish-images.sh -r registry.example.com -c supportedAuf diese Weise erstellte Images sind mit Ihrem Schlüssel signiert: Prüfen und
erzwingen Sie sie mit Ihrer cosign.pub, nicht mit dem grommunio-Schlüssel.