HDD-Housing e.U.

VersityGW installieren: S3-kompatibler Speicher auf ZFS

Hinweis: Ersetze poolname in allen Befehlen durch deine Kunden-ID.

VersityGW ist ein Open-Source-S3-Gateway. Mit dem POSIX-Backend speichert es jedes Objekt als normale Datei auf deinem ZFS-Pool. Damit ist es ein ideales S3-Backend für Backups – und eine schlanke Alternative zu MinIO.

Aktuelle Version installieren

v=$(curl -s https://api.github.com/repos/versity/versitygw/releases/latest | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')
wget "https://github.com/versity/versitygw/releases/download/${v}/versitygw_${v:1}_linux_amd64.deb"
wget "https://github.com/versity/versitygw/releases/download/${v}/checksums.txt"
sha256sum -c checksums.txt --ignore-missing && dpkg -i ./versitygw_${v:1}_linux_amd64.deb

Benutzer und Verzeichnisse anlegen

groupadd -g 1100 versitygw
useradd -m -s /bin/bash -d /poolname/versitygw/home -u 1100 -g 1100 versitygw
echo "versitygw:$(openssl rand -base64 100 | tr -d '=+/\n\r' | cut -c 1-70)" | chpasswd
mkdir -p /poolname/versitygw/buckets /poolname/versitygw/accounts
chown -R versitygw:versitygw /poolname/versitygw

Konfiguration

nano /etc/versitygw.d/versitygw.conf

Folgenden Inhalt einfügen:

VGW_BACKEND=posix

# Oberstes Verzeichnis des Gateways. Jedes Unterverzeichnis ist ein Bucket,
# alles unterhalb eines Bucket-Verzeichnisses ein Objekt.
# Beispiel: Bucket "mybucket", Objekt "a/b/c/myobject"
# -> /poolname/versitygw/buckets/mybucket/a/b/c/myobject
VGW_BACKEND_ARG=/poolname/versitygw/buckets

ROOT_ACCESS_KEY_ID=
ROOT_SECRET_ACCESS_KEY=

VGW_PORT=:7070

VGW_ADMIN_PORT=:17070

VGW_IAM_DIR=/poolname/versitygw/accounts

Für ROOT_ACCESS_KEY_ID und ROOT_SECRET_ACCESS_KEY eigene Admin-Zugangsdaten setzen, z. B. erzeugt mit openssl rand -hex 20.

Dienst starten

systemctl enable --now versitygw@versitygw
systemctl status versitygw@versitygw

Der Instanzname nach @ entspricht der Konfigurationsdatei /etc/versitygw.d/versitygw.conf.

Benutzer und Buckets verwalten

access=admin_access_key_id
secret=admin_secret_access_key
port=17070

# Benutzer anlegen
versitygw admin -a $access -s $secret -er http://127.0.0.1:$port create-user -a user_access_key_id -s user_secret_access_key -r user_role -ui user_userID -gi user_groupID
# user_role: 'user', 'admin' oder 'userplus' (userplus darf Buckets anlegen, user nicht)
# -ui und -gi sind optional

# Benutzer löschen
versitygw admin -a $access -s $secret -er http://127.0.0.1:$port delete-user -a user_access_key_id

# Benutzer auflisten
versitygw admin -a $access -s $secret -er http://127.0.0.1:$port list-users

# Bucket-Besitzer ändern
versitygw admin -a $access -s $secret -er http://127.0.0.1:$port change-bucket-owner -b bucket_name -o new_owner_access_key_id

# Buckets und Besitzer auflisten
versitygw admin -a $access -s $secret -er http://127.0.0.1:$port list-buckets

Update-Skript

Dieses Skript installiert nach Prüfung der Prüfsumme die neueste Version:

#!/bin/bash
v=$(curl -s https://api.github.com/repos/versity/versitygw/releases/latest | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')
wget "https://github.com/versity/versitygw/releases/download/${v}/versitygw_${v:1}_linux_amd64.deb"
wget "https://github.com/versity/versitygw/releases/download/${v}/checksums.txt"

sha256sum -c checksums.txt --ignore-missing
if [ $? == 0 ]
then
        rm checksums.txt
        read -p "Do you want to install $v? (y/N) " confirm
        [[ "$confirm" != "y" ]] && exit 0
        dpkg -i ./versitygw_${v:1}_linux_amd64.deb
        systemctl daemon-reload
        systemctl restart versitygw@*
        sleep 3
        systemctl status versitygw@*
fi