Zum Inhalt springen
vaultigen

Erste Schritte

Download

Wo Sie das Vaultigen-Image, die Compose-Dateien und den Quellcode erhalten, wie Versionen nummeriert sind und warum Veröffentlichungsdaten wichtig sind.

Jede Vaultigen-Version ist öffentlich. Es gibt kein Download-Portal hinter einem Login. Jede Version erscheint auf zwei Wegen:

Beide enthalten dieselbe Anwendung, Version und dasselbe Veröffentlichungsdatum.

Docker-Image und Compose-Dateien

  • Image: vaultigen/vaultigen auf Docker Hub, ein Tag pro Version (zum Beispiel vaultigen/vaultigen:1.0.0), für Linux AMD64.
  • Konfiguration: compose.yaml, env.example und die optionale compose.proxy.yaml aus dem Ordner scripts/docker/ des Versions-Tags im Repository:
VERSION=1.0.0   # die gewünschte Version
curl -fLO https://raw.githubusercontent.com/vaultigen/vaultigen/v$VERSION/scripts/docker/compose.yaml
curl -fL https://raw.githubusercontent.com/vaultigen/vaultigen/v$VERSION/scripts/docker/env.example -o .env

Die Dateien jeder Version bleiben unter ihrem Tag verfügbar, Sie können also jederzeit die Konfiguration einer älteren Version abrufen. Die Vorlage wählt in VAULTIGEN_IMAGE_TAG das Image derselben Version vor. compose.yaml bleibt über Versionen hinweg normalerweise gleich; laden Sie nur dann eine neue, wenn die Versionshinweise es verlangen.

Legen Sie genaue Versionen fest. Die Konfiguration kennt kein latest, und ein Update geschieht nur, wenn Sie VAULTIGEN_IMAGE_TAG selbst ändern. Wer das Image bezieht, braucht weder PHP noch Composer noch Node.js.

Quellcode

Versionen werden auf GitHub als Tags veröffentlicht:

Laden Sie das Quellarchiv einer Version herunter, oder klonen Sie das Repository und wechseln Sie auf den Tag:

git clone https://github.com/vaultigen/vaultigen.git
cd vaultigen
git checkout v1.0.0   # durch die gewünschte Version ersetzen

Installieren Sie im Produktivbetrieb immer eine getaggte Version, nie den Hauptzweig. Entwicklungsstände haben kein Veröffentlichungsdatum und sind nicht für echte Daten gedacht.

Versionen und Veröffentlichungsdaten

Jede Version hat eine Versionsnummer und ein Veröffentlichungsdatum. Das Datum ist in den Code eingebaut und im Changelog angegeben.

Für lizenzierte Installationen ist das Veröffentlichungsdatum wichtig: Eine Lizenz gilt für jede Version, die bis einschließlich zum letzten Tag ihres Update-Zeitraums erschienen ist. Vergleichen Sie vor einem Update das Veröffentlichungsdatum der neuen Version mit dem Datum „Updates bis“ Ihrer Lizenz unter System → Lizenz. Siehe Updates und Verlängerungen.

Prüfen, was Sie herunterladen

  • Laden Sie nur aus dem offiziellen GitHub-Repository und dem Docker-Hub-Repository vaultigen/vaultigen.
  • Vergleichen Sie den Tag mit der Version im Changelog.
  • Die Versionshinweise auf GitHub nennen den Image-Digest jeder Version. Vergleichen Sie ihn nach dem Herunterladen mit docker image inspect vaultigen/vaultigen:1.0.0 --format '{{index .RepoDigests 0}}'.
  • Das Image trägt Version, Quell-Revision und Lizenz als Standard-OCI-Labels: docker image inspect vaultigen/vaultigen:1.0.0 --format '{{json .Config.Labels}}'.
  • Die Lockfiles (composer.lock, package-lock.json) sind eingecheckt und geprüft; installieren Sie mit ihnen, nicht an ihnen vorbei.

Lizenz des Quellcodes

Der Quellcode steht unter der Elastic License 2.0. Sie dürfen ihn mit bis zu 10 Benutzern kostenlos produktiv nutzen, mit allen Funktionen und ohne Zeitlimit. So können Sie Vaultigen vor dem Kauf einer kommerziellen Lizenz auf Ihrer eigenen Infrastruktur testen. Die Lizenz erlaubt nicht, Vaultigen als gehosteten Dienst anzubieten oder die Lizenzprüfung zu umgehen.

Weiter: Installation mit Docker Compose oder manuelle Installation.

Einen Fehler gefunden? Schreiben Sie uns an [email protected].