Создание новой конфигурации файлового хранилища

Создать конфигурацию хранилища контента в системе можено несколькими способами:

  1. Создание непосредственно в системе через журнал «Хранилища контента»

  2. Создание через yml файл в проекте.

  3. Загрузить через Приложения ECOS.

Создание через журнал «Хранилища контента»

Для создания конфигурацию необходимо:

  • Перейти в журнал: Инструменты → Хранилища контента:

../../_images/content_3.png

  • Создать запись с указанием типа хранилища контента, для которого вы делаете конфигурацию (каждый тип имеет свой набор атрибутов конфигурации, необходимый ему для обеспечения работы):

../../_images/content_4.png

  • Заполнить основные поля конфигураци: ID, Имя, Тип (будет выбран автоматически). Напишите максимально понятный ID, поскольку именно он будет отображаться в большинстве логов системы.

../../_images/content_5.png

  • Заполнить дополнительные параметры конфигурации, относящиеся непосредственно к выбранному типу хранилища.

../../_images/content_6.png

  • Сохранить конфигурацию и убедиться, что она создалась в журнале.

Создание через yml файл в проекте

Для создания конфигурации необходимо:

  • Создать yml файл с конфигурацией:

    ---
id: content-storage-s3
name:
en: S3 content storage
ru: Хранилище контента для S3
type: S3
config:
endpoint: emodel/endpoint@content-storage-s3-endpoint
bucketName: "ecos-content"

    Где:

    • id - ID конфигурации. Напишите максимально понятный ID, поскольку именно он будет отображаться в большинстве логов системы.

    • name - Имя конфигурации.

    • type - Тип хранилища контента. Возможные варианты: S3

    • config - Конфигурация хранилища данных. У каждого типа свой набор атрибутов, ознакомиться с ним подробнее можно ниже - Параметры конфигурации отдельный хранилищ контента.

  • Расположить созданный вами файл по пути:

    • В МКР: ${home_dir}/src/main/resources/eapps/artifacts/content/storage/

    • В проектах: ${module_name}/src/main/resources/alfresco/module/${module_name}/content/storage/

В данных директориях вы можете создавать внутреннюю структуру папок. Поиск артифактов шаблонов происходит рекурсивно по папкам, но начинается именно с этих директорий.

../../_images/content_7.png

  • Убедиться, что она создалась в журнале.

Загрузить через Приложения ECOS

Для загрузки конфигурации через Приложения ECOS необходимо:

  • Создать приложение с имеющегося стенда (архив с артефактом создастся автоматически) или, если вы создавали собственный yml файл, создать zip архив самостоятельно. За основу можете взять данный файл test-app.zip и сгенерировать, как в нем.

  • Загрузить приложение через журнал «Приложения ECOS».

  • Убедиться, что в журнале «Хранилища контента» создались ваши конфигурации.

Параметры конфигурации отдельных хранилищ контента

У каждого хранилища контента есть собственные атрибуты конфигурации, необходимые системе для подклечения и организации работы.

Хранилище S3

Общий файл конфигурации для хранилища S3 выглядит следующим образом:

---
id: content-storage-s3
name:
en: S3 content storage
ru: Хранилище контента для S3
type: S3
config:
endpoint: "emodel/endpoint@content-storage-s3-endpoint"
bucketName: "ecos-content"

Где:

  • endpoint - ассоциация на «конечную точку», в которой указывается адрес для подключения к серверу и креды.

  • bucketName - имя корзины, в которой будут сохраняться все файлы системы. (Корзина представляет собой аналог БД в опредененной СУБД. У одного хранилища может быть создано несколько корзин, притом каждая из них может иметь свои параметры, такие как обеспечения доступов и т.п.)