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:
- als Docker-Image für die Installation mit Docker Compose (empfohlen) und
- als Quellcode für die manuelle Installation.
Beide enthalten dieselbe Anwendung, Version und dasselbe Veröffentlichungsdatum.
Docker-Image und Compose-Dateien
- Image:
vaultigen/vaultigenauf Docker Hub, ein Tag pro Version (zum Beispielvaultigen/vaultigen:1.0.0), für Linux AMD64. - Konfiguration:
compose.yaml,env.exampleund die optionalecompose.proxy.yamlaus dem Ordnerscripts/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:
- Releases: github.com/vaultigen/vaultigen/releases
- Repository: github.com/vaultigen/vaultigen
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].