Cyberduck
Cyberduck — это файловый менеджер, который поддерживает протоколы FTP, SFTP, OpenStack Swift и AmazonS3 и позволяет удобно работать, в том числе, с облачными хранилищами. В нашем профиле Cyberduck используется протокол OpenStack Swift.
Установка Cyberduck и подключение к S3
Windows
1. Скачайте Cyberduck с официального сайта и установите его.
2. Скачайте файл профиля Timeweb Cloud, необходимый для работы. Это также можно сделать в настройках любого бакета.
3. Разместите профиль в директории profiles (обычно располагается по пути: C:\Program Files\Cyberduck\profiles).
4. Запустите Cyberduck и кликните на «Новое подключение».
5. Выберите профиль Timeweb Cloud Storage.
6. Заполните поля:
- AccountID:AccountID — укажите логин вашего аккаунта через двоеточие, то есть в формате login:login.
- Пароль — укажите пароль администратора хранилища.
7. Нажмите "Подключить".
Как только подключение будет установлено, вы увидите список созданных бакетов.
Консольная версия
Также в Windows можно использовать консольную версию Cyberduck. Установить ее можно с помощью менеджера пакетов Chocolatey.
Выполните команду ниже и загрузите последнюю версию установщика.
choco install duckСкачайте файл профиля Timeweb Cloud и разместите его в директории: C:\Program Files\Cyberduck\profiles.
MacOS
1. Установите Cyberduck: скачайте его бесплатно с официального сайта проекта или загрузите через App Store (в этом случае утилиту потребуется купить).
2. Скачайте файл профиля Timeweb Cloud, необходимый для работы. Это также можно сделать в настройках любого бакета.
3. Добавьте его в Cyberduck (можно добавить простым перетаскиванием).
4. Заполните поля:
- AccountID:AccountID — укажите логин вашего аккаунта через двоеточие, то есть в формате login:login.
- Password — укажите пароль администратора хранилища.
5. Нажмите "Подключить".
Как только подключение будет установлено, вы увидите список созданных бакетов.
Консольная версия
Также можно использовать консольную версию Cyberduck. Установить ее можно с помощью менеджера пакетов Homebrew.
Выполните команду ниже и загрузите последнюю версию установщика.
brew install duckСкачайте файл профиля Timeweb Cloud и добавьте его в Cyberduck.
Linux
Для Linux доступна консольная версия Cyberduck.
- Добавьте репозиторий duck:
sudo echo 'deb https://s3.amazonaws.com/repo.deb.cyberduck.io nightly main' >> /etc/apt/sources.list.d/cyberduck.list
sudo echo 'deb https://s3.amazonaws.com/repo.deb.cyberduck.io stable main' >> /etc/apt/sources.list.d/cyberduck.list- Скачайте публичный GPG-ключ с keyserver.ubuntu.com:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys FE7097963FEFBE72- Обновите репозиторий:
sudo apt-get update- Установите Cyberduck CLI:
sudo apt-get install duck- Создайте директорию с профилями:
mkdir -p ~/.duck/profiles- Скачайте профиль Timeweb Cloud:
wget -O ~/.duck/profiles/timeweb-cloud.cyberduckprofile https://timeweb.cloud/s3/timeweb-cloud.cyberduckprofileОтображение скрытых файлов
По умолчанию в интерфейсе Cyberduck не отображаются скрытые файлы.
Чтобы изменить эту настройку, кликните «Вид» → «Показать скрытые файлы» или используйте сочетание клавиш Ctrl+Shift+R (Shift+Cmd+R в MacOS).
Скрытые файлы станут доступны для работы:
Консольные команды для работы с хранилищем
Команды имеют формат:
duck <опция> <аргумент> timeweb-cloud:/<имя бакета> --username <логин>:<логин> --password <пароль>Где:
- <опция> — дополнительная опция, например, --verbose или --retry.
- <аргумент> — аргумент утилиты duck. Полный список аргументов и опций можно получить, выполнив duck --help.
- <имя бакета> — имя бакета, созданного в панели управления.
- <логин> — логин вашего аккаунта.
- <пароль> — пароль администратора хранилища.
Например:
duck --list timeweb-cloud:/1d65c254-17ab-4b22-b262-1111fc006937 --username ck42638:ck42638--password s6dhm6vasfh8v35f234ffsПолучение списка файлов
Чтобы получить список файлов в бакете, используйте или аргумент --list или -l:
duck --list timeweb-cloud:/<имя бакета> --username <логин>:<логин> --password <пароль>Скачивание файлов
Чтобы скачать файл на локальное устройство, используйте аргумент -d:
duck -d timeweb-cloud:/<имя бакета> --username <логин>:<логин> --password <пароль>Редактирование файлов
С помощью аргумента --edit можно открыть файл для редактирования, внести в него изменения и сохранить, после чего в бакет будет загружена измененная версия файла.
duck --edit timeweb-cloud:/<имя бакета> --username <логин>:<логин> --password <пароль>Загрузка файла в бакет
Чтобы загрузить файл в хранилище, используйте --upload:
duck --upload timeweb-cloud:/<имя бакета> <имя локального файла> --username <логин>:<логин> --password <пароль>Копирование файлов
Чтобы скопировать файл из одного бакета в другой, используйте --copy и укажите сначала текущее расположение файла, а затем — его желаемое расположение в новом бакете:
duck --сopy timeweb-cloud:/<имя бакета>/<путь к файлу> <имя бакета>:/<имя бакета>/<путь к файлу> --username <логин>:<логин> --password <пароль>Резервное копирование файлов
Чтобы регулярно отправлять в хранилище копии файлов из определенной директории, вы можете создать задачу Cron и использовать скрипт со следующим содержимым:
#!/bin/bash
USERNAME=<логин аккаунта>
PASSWORD=<пароль администратора хранилища>
BACKUP_PATH=<имя бакета>/<путь к директории>
LOCAL_PATH=<путь к локальной директории>
duck --upload "timeweb-cloud:/${BACKUP_PATH}" "${LOCAL_PATH}" --existing rename --username "${USERNAME}:${USERNAME}" --password "${PASSWORD}" -q -yАргумент --existing указывает, что нужно делать с существующими файлами.
В примере выше используется опция rename, что позволяет переименовать уже имеющуюся копию, добавив к ней время и дату.
Доступны и другие опции: например, overwrite перезапишет имеющуюся версию файла новой; skip загрузит только новые файлы, появившиеся после последней загрузки, и пропустит повторяющиеся файлы, даже если они были изменены.
С помощью --existing compare можно выполнять дифференциальное резервное копирование. В этом случае система сравнит загружаемый файл с имеющимся, и если параметры (размер, дата изменения, контрольная сумма) отличаются, то старая версия будет заменена новой.
duck --upload timeweb-cloud:/<имя бакета>/<путь к директории> <путь к локальной директории> --existing compare --username <логин>:<логин> --password <пароль>Информацию обо всех доступных опциях можно просмотреть с помощью duck --help.
Синхронизация файлов
С помощью --synchronize вы можете синхронизировать содержимое локальной директории с директорией, размещенной в хранилище. Если файлы в локальной директории были изменены, добавлены или удалены, эти же самые файлы будут изменены, добавлены или удалены в хранилище, и наоборот. В результате синхронизации обе директории будут содержать одинаковый набор файлов в одной и той же версии.
duck --synchronize timeweb-cloud:/<имя бакета>/<путь к директории> <путь к локальной директории> --username <логин>:<логин> --password <пароль>Чтобы автоматически выполнять синхронизацию и поддерживать копии файлов в хранилище в актуальном состоянии, вы можете создать задачу Cron и использовать скрипт со следующим содержимым:
#!/bin/bash
USERNAME=<логин аккаунта>
PASSWORD=<пароль администратора хранилища>
BACKUP_PATH=<имя бакета>/<путь к директории>
LOCAL_PATH=<путь к локальной директории>
duck --synchronize "timeweb-cloud:/${BACKUP_PATH}" "${LOCAL_PATH}" --username "${USERNAME}:${USERNAME}" --password "${PASSWORD}" -q -y