|
|
@ -0,0 +1,82 @@ |
|
|
|
--- |
|
|
|
categories: tools |
|
|
|
title: Howto Rclone |
|
|
|
... |
|
|
|
|
|
|
|
* Site officiel / Documentation : <https://rclone.org/> |
|
|
|
|
|
|
|
Rclone est un outil en ligne de commande de synchronisation de fichiers et dossiers compatible avec de nombreuses plateformes cloud (Amazon S3, Ceph, Ownloud....) |
|
|
|
|
|
|
|
# Installation |
|
|
|
|
|
|
|
~~~ |
|
|
|
# apt install rclone |
|
|
|
|
|
|
|
$ rclone --version |
|
|
|
2018/09/21 11:51:37 Config file "/home/foo/.rclone.conf" not found - using defaults |
|
|
|
rclone v1.35-DEV |
|
|
|
~~~ |
|
|
|
|
|
|
|
# Configuration |
|
|
|
|
|
|
|
La configuration se situe dans `~/.rclone.conf` qui est un fichier au format INI. Celui-ci peut être géré via rclone directement avec `rclone config` qui est totalement interactif. |
|
|
|
|
|
|
|
~~~ |
|
|
|
$ rclone config |
|
|
|
2018/09/21 11:53:26 Config file "/home/foo/.rclone.conf" not found - using defaults |
|
|
|
No remotes found - make a new one |
|
|
|
n) New remote |
|
|
|
s) Set configuration password |
|
|
|
q) Quit config |
|
|
|
n/s/q> |
|
|
|
|
|
|
|
[....] |
|
|
|
~~~ |
|
|
|
|
|
|
|
Au final, on obtient une config toute belle : |
|
|
|
|
|
|
|
~~~ |
|
|
|
$ cat `~/.rclone.conf` |
|
|
|
|
|
|
|
[S3] |
|
|
|
type = s3 |
|
|
|
provider = AWS |
|
|
|
access_key_id = ***************** |
|
|
|
secret_access_key = ************************** |
|
|
|
region = eu-central-1 |
|
|
|
location_constraint = eu-central-1 |
|
|
|
~~~ |
|
|
|
|
|
|
|
Tous les détails pour la configuration de : |
|
|
|
|
|
|
|
* [S3](https://rclone.org/s3/) |
|
|
|
|
|
|
|
|
|
|
|
## Synchronisation |
|
|
|
|
|
|
|
Synchronisation à 1 sens (source vers destination) |
|
|
|
|
|
|
|
~~~ |
|
|
|
$ rclone sync |
|
|
|
|
|
|
|
Usage: |
|
|
|
rclone sync source:path dest:path [flags] |
|
|
|
~~~ |
|
|
|
|
|
|
|
|
|
|
|
Exemple de flags pratiques : |
|
|
|
|
|
|
|
* `-n`, `--dry-run` : Faire une synchronisation d'essai sans modifications de la destionation |
|
|
|
* `-v`, `--verbose` : Rendre rclone un peu plus bavard |
|
|
|
* `-P`, `--progress` : Affichage de l'état d'avancement de la synchronisation |
|
|
|
|
|
|
|
* `--s3-acl=STRING` : (Spécifique S3) L'ACL des éléments à copier (Cf: Les [ACL AWS S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) |
|
|
|
|
|
|
|
Ainsi, pour synchroniser un dossier vers S3 : |
|
|
|
|
|
|
|
~~~ |
|
|
|
# Synchronisation de /home/foo vers le dossier "/foo/backups" du bucket S3 "mon_bucket" |
|
|
|
$ rclone -v --s3-acl=private sync /home/foo/ S3:mon_bucket/foo/backups/ |
|
|
|
~~~ |
|
|
|
|
|
|
|
|