S3cmd

S3cmd — это интерфейс командной строки (Linux, Mac) для работы с сервисами, поддерживающими HTTP API Amazon S3.

Общий порядок вызова команд смотрите в официальной документации S3cmd.

Управление S3 bucket через S3cmd

1. Установите S3cmd

Загрузите дистрибутив S3cmd на сайте разработчика ПО и установите на свое устройство.

2. Настройте доступ S3cmd к S3 bucket

Все настройки S3cmd хранятся в файле .s3cfg в домашней директории пользователя. Для подключения вашей выделенной области хранения объектов на серверах хранения (S3 bucket) пропишите следующие настройки в этом файле.

Файл .s3cfg

[default]
    access_key = id
    secret_key = secretKey
    host_bucket = %(bucket)s.cos.ngenix.net
    signature_v2 = True

В полях access_key и secret_key укажите свои авторизационные данные для доступа. Посмотреть их вы можете на странице «Cloud Object Storage» клиентского портала NGENIX Multidesk.

3. Выполняйте команды в S3cmd для управления S3 bucket

В примерах ниже используется S3 bucket с идентификаторомs12345. Для корректного выполнения команд используйте идентификатор собственного S3 bucket.

Список типовых команд:

• Получить список всех файлов в S3 bucket

• Загрузить локальный файл в S3 bucket

• Загрузить локальный файл в S3 bucket с добавлением HTTP-заголовка

• Синхронизировать содержимое директории с S3 bucket

• Загрузить файл из S3 bucket

• Синхронизировать S3 bucket с содержимым директории

• Удалить файл из S3 bucket

[Пример] Получить список всех файлов в S3 bucket «s12345»

s3cmd ls s3://s12345/

[Пример] Загрузить локальный файл /data/www/file.dat в S3 bucket «s12345»

s3cmd put --no-mime-magic --guess-mime-type /data/www/file.dat s3://<bucket>/

[Пример] Загруить локальный файл /data/www/file.dat в S3 bucket «s12345» с добавлением HTTP-заголовка "Cache-Control: max-age=604800"

s3cmd --add-header='Cache-Control: max-age=604800' --no-mime-magic --guess-mime-type put /data/www/file.dat s3://<bucket>/

[Пример] Синхронизировать содержимое директории /data/www/ с S3 bucket «s12345»

s3cmd sync --no-mime-magic --guess-mime-type /data/www/ s3://<bucket>/

[Пример] Загрузить файл /file.dat из S3 bucket «s12345»

s3cmd get s3://<bucket>/file.dat /data/www/file.dat

[Пример] Синхронизировать S3 bucket «s12345» с содержимым директории /data/www/

s3cmd sync s3://<bucket>/ /data/www/

[Пример] Удалить файл /file.dat с S3 bucket «s12345»

s3cmd rm s3://<bucket>/file.dat