LLI Wiki — My Digital Knowledge Base

Storj uplink CLI : installation et commandes de base

Installer l'outil uplink de Storj sous Linux, lister, copier, partager et supprimer des objets, et monter un bucket avec s3fs.

Storj fournit du stockage objet avec une passerelle compatible S3. L'outil en ligne de commande uplink gère les accès, les buckets et les objets. Les exemples utilisent des noms fictifs (bucket-name, folder, example-bucket).

Installation sous Linux

curl -L https://github.com/storj/storj/releases/latest/download/uplink_linux_amd64.zip -o uplink_linux_amd64.zip
unzip -o uplink_linux_amd64.zip
chmod 755 uplink
sudo mv uplink /usr/local/bin/uplink

Documentation : Configurer l'uplink CLI et bibliothèques clientes Storj.

Access grant

uplink import access-grant.key
uplink access list
uplink setup

La première commande importe un access grant enregistré dans un fichier. uplink setup lance la configuration initiale.

Opérations de base

uplink ls sj://bucket-name/folder/
uplink cp local-file.jpg sj://bucket-name/folder/local-file.jpg
uplink rm sj://bucket-name/folder/local-file.jpg
uplink share --url sj://bucket-name/folder/archive.zip
uplink rb sj://bucket-name --force

uplink rb --force supprime un bucket avec tout son contenu.

Compter les objets et la taille

uplink ls sj://bucket-name/folder | sort -k 2 -k 3 -r | head -n 5
uplink ls sj://bucket-name/folder | awk '{sum += $4} END {print sum}'
bc -l <<< "$(uplink ls sj://bucket-name/folder | awk '{sum += $4} END {print sum}')/1024/1024/1024"

La dernière commande convertit la taille totale d'octets en Gio. Les numéros de colonnes utilisés par awk dépendent de la présentation de uplink ls dans votre version.

Supprimer en parallèle tous les objets d'un préfixe

Cette commande est destructive. Pour prévisualiser les opérations, remplacez d'abord rm par echo.

uplink ls --recursive sj://bucket-name/ | tr -s ' ' | cut -f5- -d' ' | sed 's/ /\ /g' | xargs -n1 -P32 -d'\n' -iNAME uplink --client.dial-timeout 10s --client.request-timeout 10s rm sj://bucket-name/NAME

-P32 lance 32 suppressions en parallèle.

Monter un bucket avec s3fs

La passerelle Storj est compatible S3, s3fs peut donc monter un bucket. Enregistrez les identifiants dans un fichier de mot de passe :

echo ACCESS_KEY_ID:SECRET_ACCESS_KEY > /etc/passwd-s3fs
chmod 600 /etc/passwd-s3fs

Montage manuel :

s3fs example-bucket /mnt/storj -o url=https://gateway.storjshare.io

Montage au démarrage avec /etc/fstab :

s3fs#example-bucket  /mnt/storj  fuse  _netdev,allow_other,url=https://gateway.storjshare.io,umask=000,uid=33,gid=33,use_cache=/root/cache  0  0

Remarques

Mastodon LLIMastodon SocialFosstodon