====== S3cmd ======

----

===== О S3cmd =====

S3cmd - Это консольная утилита для работы с объектными хранилищами, совместимыми с S3 API. Инструмент позволяет загружать и скачивать файлы, создавать бакеты, просматривать содержимое и синхронизировать каталоги.

===== Установка S3cmd =====

Устанавливаем S3cmd:
<code>
sudo apt install s3cmd
</code>

===== Настройка S3cmd =====

Создаём в домашней директории конфигурационный файл .s3cfg:
<code>
nano ~/.s3cfg
</code>

<code>
[default]
access_key = <идентификатор_ключа>
secret_key = <секретный_ключ>
bucket_location = ru-1 <регион>
host_base = s3.twcstorage.ru #<адрес_сервера>
host_bucket = s3.twcstorage.ru #<адрес_сервера>
use_https = True
</code>

Сохраняем файл Ctrl+O и выходим из редактора Ctrl+X:

===== Работа с файлами =====

Просмотр списка файлов в бакете:
<code>
s3cmd ls s3://<имя бакета>
</code>

Загрузка файла в бакет:
<code>
s3cmd put test.txt s3://<имя бакета>
</code>

===== Загрузка multipart =====

Отключение опции multipart:

--disable-multipart

<code>
cmd put <имя_файла> --disable-multipart s3://<имя бакета>
</code>

Опция для изменения размера фрагментов multipart:
--multipart-chunk-size-mb=SIZE, где SIZE - размер каждого фрагмента в мегабайтах.

Размер фрагмента multipart:

  * По умолчанию 15 MB
  * Минимум 5 MB
  * Максимум 5 GB

Устанавливаем нужный размер партиции. К примеру, 20 MB:

<code>
s3cmd put <имя_файла> --multipart-chunk-size-mb=20 s3://<имя_бакета>
</code>

Скачивание файла из бакета:
<code>
s3cmd get s3://<имя бакета>/test.txt
</code>

Удаление файла в бакете:
<code>
s3cmd del s3://<имя бакета>/test.txt
</code>

===== Управление прерванными составными (multipart) загрузками =====

Список прерванных загрузок:
<code>
s3cmd multipart s3://<имя_бакета>
</code>

Удаление фрагментов неудачных загрузок:
<code>
s3cmd abortmp s3://<имя_бакета>/<имя_файла> <ID_загрузки>
</code>

Синхронизация файлов с бакетом:
<code>
s3cmd sync . s3://<имя бакета>
</code>