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 «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