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).
Установка
Заголовок раздела «Установка»# Debian/Ubuntusudo apt install awscli# macOSbrew install awscli# или официальный дистрибутив: https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.htmlНастройка профиля
Заголовок раздела «Настройка профиля»Сохраните ключи в именованном профиле, чтобы не повторять их в каждой команде:
aws configure set aws_access_key_id WSS... --profile webshieldaws configure set aws_secret_access_key <секрет> --profile webshieldaws configure set region ru-1 --profile webshieldУкажите регион своего бакета: ru-1 или eu-1.
Повседневные команды
Заголовок раздела «Повседневные команды»Передавайте --endpoint-url и профиль в каждом вызове:
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
Заголовок раздела «Низкоуровневый s3api»Команды s3api тоже работают — для операций, которых нет в s3:
ws s3api head-object --bucket company-backups --key db/dump.sql.gzws 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) отклоняется, скачивание работает. Пополните баланс, чтобы вернуть запись.