VersityGW installieren: S3-kompatibler Speicher auf ZFS
Hinweis: Ersetze
poolnamein 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