PC-Storage – объектное S3-хранилище, предназначенно для хранения данных в виде объектов и предоставляет S3-совместимый программный интерфейс (API) от разработчика PlatformCraft. С ним можно работать через веб-интерфейс или подключать приложения и S3-клиенты по адресу точки подключения (endpoint). Для работы используются бакеты, объекты и пара ключей S3 Access Key / S3 Secret Key.
В этом руководстве собрана основная информация по работе с хранилищем PC- Storage от первого входа и получения ключей доступа до управления бакетами и объектами, настройки прав, загрузки больших файлов и защиты данных от удаления.
Полный перечень поддерживаемых операций и технические параметры отдельных методов вынесены в справочник S3 API PlatformCraft. Здесь приведены те действия и команды, которые нужны для повседневной работы с хранилищем.
Как устроено S3-хранилище
Для начала работы в хранилище надо:
- Войти в PlatformCraft и получить S3 Access Key и S3 Secret Key.
- Создать или открыть бакет и загрузить первый объект.
- При необходимости настроить пользователей и права доступа через IAM и Bucket Policy.
После этого можно переходить к дополнительным возможностям и настройкам. Если вы впервые работаете с PC-Storage: пройдите разделы 1-6 по порядку. Для тонкой настройки прав, Versioning, Object Lock, Multipart Upload и других функций используйте отдельные страницы базы знаний.
1. Вход в личный кабинет
Откройте личный кабинет PlatformCraft: https://dashboard.platformcraft.ru/login
Введите логин и пароль и нажмите «Войти». После авторизации на главной странице доступны подключенные сервисы, включая S3-хранилище и настройки учетной записи.
Если пароль утерян
На странице входа нажмите «Я забыл», укажите логин и отправьте запрос на сброс. На адрес электронной почты, указанный в профиле, придет письмо со ссылкой и кодом активации. Перейдите по ссылке, задайте новый пароль и введите код из письма.
Важно: самостоятельный сброс работает, если для учетной записи указан доступный адрес электронной почты.
2. Получение S3 Access Key и S3 Secret Key
Для работы с S3 используются отдельные ключи доступа. В личном кабинете откройте «Настройки», далее «Доступы S3» и нажмите «Сгенерировать». После генерации сохраните endpoint, S3 Access Key и S3 Secret Key в безопасном месте.
Если ключи потеряны: создайте новую пару. После повторной генерации предыдущие ключи становятся недействительными, поэтому их необходимо заменить во всех приложениях и клиентах, которые подключаются к PC-Storage.
3. Вход в S3-хранилище
Вернитесь на главную страницу личного кабинета PlatformCraft и выберите S3-хранилище. В форме входа укажите S3 Access Key и S3 Secret Key. Если это личное доверенное устройство, можно использовать опцию «Оставаться в системе».
После успешной авторизации откроется список доступных бакетов. Веб-интерфейс показывает привычную структуру папок, но в действительности ее нет (подробнее об этом в пункте 5. Работа с бакетами).
4. Интерфейс PC-Storage
Основная рабочая область меняется в зависимости от того, где вы находитесь: на уровне хранилища отображаются бакеты, внутри бакета – объекты. Панель «Возможные действия» содержит операции, доступные для выбранного элемента, а правая контекстная панель показывает свойства и настройки бакета или объекта.
В элементах доступно:
- Навигация – переход между разделами, поиск по бакету, смена языка и темы, переключение списка/сетки.
- Возможные действия – создание элементов и операции над выбранным бакетом или объектом.
- Статистика – используемый и максимальный объем хранилища, выделенный для учетной записи.
- Правая панель – свойства выбранного бакета или объекта и доступные дополнительные настройки.
5. Работа с бакетами
В объектном хранилище данные размещаются не в классической файловой системе, а в бакетах. Каждый сохраненный файл становится объектом, а его имя и путь представляются ключом объекта. На уровне S3 структура бакета плоская и то, что выглядит как папки в веб-интерфейсе формируется из префиксов в ключах.
Бакет – контейнер верхнего уровня для объектов. На странице со списком бакетов можно создать новый бакет через панель «Возможные действия». Имя должно быть уникальным в системе; актуальные правила именования и ошибки создания вынесены в отдельную страницу «Бакеты S3: управление доступом и работа с бакетами».
После выбора бакета правая панель показывает его endpoint и дополнительные настройки. В ней доступны CORS, Versioning, Bucket Policies и Presigned upload URL. Подробное описание этих функций находится в соответствующих разделах базы знаний.
6. Загрузка, скачивание и управление объектами
Чтобы загрузить файл, откройте нужный бакет и нажмите «Загрузить». Файл можно выбрать на локальном устройстве или перетащить в окно загрузки. После завершения он появится в списке объектов.
Выберите объект в списке, чтобы выполнить доступные операции. Через панель действий объект можно скачать, переименовать, скопировать или удалить; часть операций доступна сразу для нескольких выбранных объектов; для крупных объектов веб-интерфейс использует multipart-загрузку.
7. Подключение через AWS CLI
PC-Storage можно использовать через AWS CLI (интерфейс командной строки AWS), указывая S3-ключи и endpoint PlatformCraft. После установки AWS CLI выполните aws configure и задайте параметры подключения.
| Параметр | Значение |
|---|---|
| AWS Access Key ID | S3 Access Key, созданный в личном кабинете. |
| AWS Secret Access Key | S3 Secret Key, созданный в личном кабинете. |
| Default region name | eu-central-2 |
| Endpoint | https://eu-s3.platformcraft.com |
Проверить подключение можно получением списка бакетов:
aws s3api list-buckets --endpoint-url=https://eu-s3.platformcraft.com
Например, загрузка файла выполняется стандартной S3-командой с указанием endpoint:
aws s3 cp ./example.pdf s3://example-bucket/example.pdf --endpoint-url=https://eu-s3.platformcraft.com
Для работы через графический S3-клиент Cyberduck создайте новое подключение типа Amazon S3 и укажите параметры PC-Storage. Важно, что Cyberduck отображает префиксы ключей как папки, поэтому объект может выглядеть как prefix/subprefix/picture.jpg.
| Поле Cyberduck | Значение |
|---|---|
| Server | eu-s3.platformcraft.com |
| Port | 443 |
| Access Key ID | ваш S3 Access Key |
| Secret Access Key | ваш S3 Secret Key |