Erste Schritte

Release-Paket von Hand

Alternative zu Schritt 1 der Installation. Läuft direkt auf dem Server; nichts muss über den eigenen Rechner laufen.

VERSION=v3.3.1   # aktuelle Fassung: siehe Release-Seite
BASE=https://gitlab.com/api/v4/projects/mankeldor%2Ffileshare/packages/generic/fileshare/$VERSION

curl -fL -o "fileshare-$VERSION.tar.gz"        "$BASE/fileshare-$VERSION.tar.gz"
curl -fL -o "fileshare-$VERSION.tar.gz.sha256" "$BASE/fileshare-$VERSION.tar.gz.sha256"

sha256sum -c "fileshare-$VERSION.tar.gz.sha256"
tar -xzf "fileshare-$VERSION.tar.gz" && cd "fileshare-$VERSION"

composer install --no-dev --optimize-autoloader

Sagt sha256sum -c nicht OK, brich ab und lade neu. Ein abgebrochener Download ergibt ein Archiv, das sich entpacken lässt und dem Dateien fehlen — das fällt sonst erst im Betrieb auf. Auf macOS heißt der Befehl shasum -a 256 -c.

Weiter bei Schritt 2.

Nicht öffentliches Projekt

Bei einem nicht öffentlichen Projekt antwortet curl mit 404 statt mit dem Archiv — die API verrät nicht, dass es das Projekt gibt. Dann braucht der Aufruf ein Token:

curl -fL --header "DEPLOY-TOKEN: $(cat /pfad/token)" \
     -o "fileshare-$VERSION.tar.gz" "$BASE/fileshare-$VERSION.tar.gz"

Nimm ein Deploy-Token mit dem Recht read_package_registry (Settings → Repository → Deploy tokens): Es gilt nur für dieses Projekt, nur zum Lesen, und hängt nicht an einem Konto, das jemand irgendwann wechselt.

Token-Art Header
Deploy-Token DEPLOY-TOKEN
Persönliches oder Projekt-Token PRIVATE-TOKEN
Im CI-Job JOB-TOKEN

Leg das Token in eine Datei mit chmod 600 und lies es wie oben per $(cat …). Im Befehl selbst stünde es in der Prozessliste und in der Shell-Historie.

Quelle dieser Seite: docs/installation/paket.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.