Ce guide détaille comment sauvegarder manuellement des données en ligne de commande (CLI) via le protocole S3 Compatible sur Swiss Backup la solution de sauvegarde dans un cloud suisse indépendant.

Prérequis

• Posséder un espace Swiss Backup Infomaniak avec un quota d'appareil disponible (minimum 1) pour une sauvegarde Cloud.
• Ajouter 1 appareil de type Cloud pour obtenir les paramètres S3 Compatible.
• Utiliser une application de type Terminal (interface en ligne de commande, CLI /Command Line Interface) sur votre appareil

Utiliser un emplacement S3 en CLI

Avec une application de type Terminal (interface en ligne de commande, CLI /Command Line Interface) sur votre appareil:

1. Installez s3cmd, par exemple sur Debian/Ubuntu:

   sudo apt install s3cmd

   ou sur macOS (avec Homebrew):

   brew install s3cmd

   et pour Windows il est recommandé d'utiliser S3Express un outil en ligne de commande open source (besoin d'aide ?).

2. Entrez la commande suivante pour configurer la connexion:

   s3cmd --configure

3. Renseignez les champs selon les informations propres à votre appareil (prenez connaissance de cet autre guide):
    
   • Display name= choisissez un nom pour le stockage.
   • AccessKey et SecretKey= les clés d’accès générées depuis l’e-mail reçu d’Infomaniak suite à la création de l’espace de stockage.
   • Service point= par exemple https://s3.swiss-backup02.infomaniak.com (1)
   • Bucket name = default
   • Default region
   • S3 Endpoint : utilisez l’URL fournie par Infomaniak
   • Use HTTPS : oui
   • HTTP Proxy server : laissez vide sauf configuration spécifique
   • Signature version : forcez l’utilisation de v4
   • Path style : choisissez Oui si demandé
   • Test access : vous pouvez effectuer le test pour valider la configuration

Une fois terminé, un fichier de configuration sera sauvegardé (par défaut dans ~/.s3cfg).

Démarrer une copie vers Swiss Backup

Voici quelques commandes de base pour interagir avec Swiss Backup:

• Lister les buckets: s3cmd ls
• Lister le contenu d’un bucket: s3cmd ls s3://bucket-name
• Envoyer un fichier: s3cmd put example.txt s3://bucket-name/
• Télécharger un fichier: s3cmd get s3://bucket-name/example.txt
• Synchroniser un répertoire local vers un bucket: s3cmd sync /path/local/ s3://bucket-name/

En cas d'erreur

Suite à une mise à jour de l’outil AWS CLI (Amazon Web Services Command Line Interface), vous pouvez rencontrer une erreur lors de la tentative de connexion ou de transfert de données vers un emplacement S3 de Swiss Backup:

Transferring payloads in multiple chunks using aws-chunked is not supported

Cette erreur est liée à une méthode de transfert utilisée par AWS CLI (aws-chunked), qui n’est pas compatible avec le service Swiss Backup.

Afin de continuer à utiliser efficacement Swiss Backup via la ligne de commande, Infomaniak recommande d’utiliser l’outil open-source s3cmd décrit plus haut sur ce guide, ce qui est totalement compatible avec les emplacements S3.