Перейти к содержимому
WebShield Docs

AWS CLI с WebShield S3

Настройка AWS CLI для работы с S3-совместимым объектным хранилищем WebShield.

Официальный AWS CLI работает с нашим хранилищем без плагинов и обёрток: достаточно передать --endpoint-url или прописать его в профиле, а дальше пользоваться привычными командами s3 и s3api. Ключи и бакеты — в разделе Объектное хранилище.

  • Endpoint: https://s3.webshield.pro
  • Access Key ID и Secret Access Key со страницы Хранилище S3 в личном кабинете.
  • Точное имя бакета из личного кабинета (например, company-backups).
Terminal window
# Debian/Ubuntu
sudo apt install awscli
# macOS
brew install awscli
# или официальный дистрибутив: https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html

Сохраните ключи в именованном профиле, чтобы не повторять их в каждой команде:

Terminal window
aws configure set aws_access_key_id WSS... --profile webshield
aws configure set aws_secret_access_key <секрет> --profile webshield
aws configure set region ru-1 --profile webshield

Укажите регион своего бакета: ru-1 или eu-1.

Передавайте --endpoint-url и профиль в каждом вызове:

Terminal window
alias ws='aws --profile webshield --endpoint-url https://s3.webshield.pro'
ws s3 ls # список бакетов
ws s3 ls s3://company-backups/ # объекты в бакете
ws s3 cp ./dump.sql.gz s3://company-backups/db/ # загрузить файл
ws s3 cp s3://company-backups/db/dump.sql.gz . # скачать файл
ws s3 sync ./media s3://company-backups/media # синхронизировать каталог
ws s3 rm s3://company-backups/db/dump.sql.gz # удалить объект

Multipart-загрузку крупных файлов aws s3 cp/sync выполняют автоматически.

Команды s3api тоже работают — для операций, которых нет в s3:

Terminal window
ws s3api head-object --bucket company-backups --key db/dump.sql.gz
ws s3api list-objects-v2 --bucket company-backups --prefix db/
  • Поддерживаются имя бакета в пути и доменная адресация (https://<bucket>.s3.webshield.pro/<key>). Для второго варианта выполните aws configure set s3.addressing_style virtual --profile webshield; endpoint остаётся прежним.
  • Для создания и удаления бакетов нужен ключ с правом управления бакетами; как его выпустить.
  • При отрицательном балансе хранилище переходит в режим «только чтение»: загрузка (cp/sync) отклоняется, скачивание работает. Пополните баланс, чтобы вернуть запись.