Questa guida illustra come eseguire manualmente il backup dei dati tramite la riga di comando (CLI) utilizzando il protocollo S3 Compatible su Swiss Backup, la soluzione di backup su cloud svizzero indipendente.

Utilizzare un endpoint S3 tramite CLI

Prerequisiti

• Avere uno spazio Swiss Backup Infomaniak con una quota di dispositivi disponibile (almeno 1) per un backup su cloud.
• Aggiungere 1 dispositivo di tipo Cloud per ottenere i parametri S3 Compatible.
• Utilizzare un'applicazione di tipo Terminal (interfaccia a riga di comando, CLI /Command Line Interface) sul proprio dispositivo.

Con un'applicazione di tipo Terminal (interfaccia a riga di comando, CLI /Command Line Interface) sul proprio dispositivo:

1. Installare s3cmd, ad esempio su Debian/Ubuntu:

   sudo apt install s3cmd

   o su macOS (con Homebrew):

   brew install s3cmd

   e per Windows si consiglia di utilizzare S3Express, uno strumento a riga di comando open source (hai bisogno di aiuto?).

2. Inserire il comando seguente per configurare la connessione:

   s3cmd --configure

3. Inserire i campi in base alle informazioni relative al proprio dispositivo (consultare questa guida):
    
   • Display name = scegliere un nome per lo spazio di archiviazione.
   • AccessKey e SecretKey = le chiavi di accesso generate tramite l'e-mail ricevuta da Infomaniak in seguito alla creazione dello spazio di archiviazione.
   • Service point = ad esempio https://s3.swiss-backup02.infomaniak.com (1)
   • Bucket name = default
   • Default region
   • S3 Endpoint: utilizzare l'URL fornito da Infomaniak
   • Use HTTPS: sì
   • HTTP Proxy server: lasciare vuoto, a meno che non sia necessaria una configurazione specifica
   • Signature version: forzare l'utilizzo di v4
   • Path style: scegliere Sì, se richiesto
   • Test access: è possibile eseguire il test per convalidare la configurazione

Al termine, verrà salvato un file di configurazione (per impostazione predefinita in ~/.s3cfg).

Avviare una copia su Swiss Backup

Di seguito sono riportati alcuni comandi di base per interagire con Swiss Backup:

• Elencare i bucket: s3cmd ls
• Elencare il contenuto di un bucket: s3cmd ls s3://bucket-name
• Inviare un file: s3cmd put example.txt s3://bucket-name/
• Scaricare un file: s3cmd get s3://nome-bucket/esempio.txt
• Sincronizzare una directory locale con un bucket: s3cmd sync /percorso/locale/ s3://nome-bucket/

In caso di problemi

A seguito di un aggiornamento dello strumento AWS CLI (Amazon Web Services Command Line Interface), si potrebbe riscontrare un errore durante il tentativo di connessione o di trasferimento di dati verso una posizione S3 di Swiss Backup:

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

Questo errore è legato a un metodo di trasferimento utilizzato da AWS CLI (aws-chunked), che non è compatibile con il servizio Swiss Backup.

Per continuare a utilizzare Swiss Backup in modo efficace tramite la riga di comando, Infomaniak consiglia di utilizzare lo strumento open-source s3cmd descritto in precedenza in questa guida, che è completamente compatibile con le posizioni S3.