Rclone — утилита командной строки для синхронизации файлов и каталогов между локальной машиной и облачным хранилищем.
Установка rclone
Дистрибутивы программы для разных архитектур и ОС можно скачать с сайта разработчика. Инструкции по установке также есть на официальном сайте.
Для Windows достаточно скачать и запустить rclone.exe через командную строку.
Настройка rclone
Для настройки rclone для работы с нашим объектным хранилищем S3 необходимо создать в каталоге .config/rclone в корне домашней директории файл rclone.conf со следующим содержимым:
Значения S3 Access Key и S3 Secret Access Key можно найти во вкладке «Дашборд» в панели управления бакетом.
Либо можно воспользоваться мастером настройки, который сформирует аналогичный файл.
Для запуска мастера настройки в Linux и macOS выполните команду:
Для запуска в Windows используйте:
Пример выполнения настройки через мастер:
Нажмите n для создания новой конфигурации. Укажите имя конфигурации, по которому в дальнейшем будет выполняться обращение к кластеру:
Укажите номер, соответствующий значению «Amazon S3 Compliant Storage Provider». В данном случае — 4:
Выберите номер, соответствующий «Any other S3 compatible provider». В данном случае — 13:
Укажите значение false для ручной настройки данных подключения:
Вместо <S3 Access Key> укажите значение S3 Access Key из панели управления:
Вместо <S3 Secret Access Key> укажите значение S3 Secret Access Key из панели управления:
Укажите ru-1:
В качестве эндпойнта укажите https://s3.twcstorage.ru:
Нажмите «Enter»:
Нажмите «Enter»:
Укажите n, чтобы не редактировать конфигурацию:
Проверьте конфигурацию и подтвердите, что все хорошо, нажав y:
Нажмите q для выхода из мастера настройки:
Если при настройке через мастер возникнет ошибка, попробуйте выполнить настройку заново, но без указания региона (ru-1).
Команды для работы с хранилищем
Полный список поддерживаемых команд смотрите в документации rclone.
В качестве хоста указывается имя хранилища, заданное в конфигурационном файле rclone.conf. Так, в нашем примере в начале статьи было настроено хранилище с именем timeweb-cloud.
Просмотр списка бакетов
Например:
Получение списка файлов в бакете
Например:
Загрузка файла в бакет
Например:
Удаление файла в бакете
Например:
Копирование файлов из бакета в бакет
Синхронизация файлов между бакетом и локальной директорией
Для синхронизации в обратном направлении поменяйте аргументы местами.