s3cmd с WebShield S3
Настройка s3cmd для работы с S3-совместимым объектным хранилищем WebShield.
s3cmd — консольный клиент S3 на Python; ставится из репозитория дистрибутива, из Homebrew или через pip. Для подключения задайте endpoint и способ адресации в ~/.s3cfg. Ключи и бакеты — в разделе Объектное хранилище.
Что понадобится
Заголовок раздела «Что понадобится»- Хост endpoint:
s3.webshield.pro - Access Key ID и Secret Access Key со страницы Хранилище S3 в личном кабинете.
- Точное имя бакета из личного кабинета (например,
company-backups).
Установка
Заголовок раздела «Установка»# Debian/Ubuntusudo apt install s3cmd# macOSbrew install s3cmd# или через pip: pip install s3cmdНастройка
Заголовок раздела «Настройка»s3cmd нужно указать хост для API и шаблон адреса бакета. Пример с именем бакета в пути — создайте ~/.s3cfg:
[default]access_key = WSS...secret_key = <секрет>host_base = s3.webshield.prohost_bucket = s3.webshield.pro/%(bucket)suse_https = Truesignature_v2 = FalseСтрока host_bucket с /%(bucket)s после хоста включает адресацию через путь. Для доменной адресации замените её на host_bucket = %(bucket)s.s3.webshield.pro; host_base оставьте прежним.
Повседневные команды
Заголовок раздела «Повседневные команды»s3cmd ls # список бакетовs3cmd ls s3://company-backups/ # список объектовs3cmd put ./dump.sql.gz s3://company-backups/db/ # загрузитьs3cmd get s3://company-backups/db/dump.sql.gz . # скачатьs3cmd sync ./media/ s3://company-backups/media/ # синхронизировать каталогs3cmd del s3://company-backups/db/dump.sql.gz # удалитьКрупные файлы загружаются multipart-загрузкой автоматически.
Примечания
Заголовок раздела «Примечания»- Для создания и удаления бакетов нужен ключ с правом управления бакетами; как его выпустить.
- При отрицательном балансе хранилище переходит в режим «только чтение»: загрузка (
put/sync) отклоняется, скачивание работает. Пополните баланс, чтобы вернуть запись.