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

.. _content_new_config:

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

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

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

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

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

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

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

 .. image:: _static/content_3.png
       :width: 600
       :align: center

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

 .. image:: _static/content_4.png
       :width: 300
       :align: center

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

 .. image:: _static/content_5.png
       :width: 500
       :align: center

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

 .. image:: _static/content_6.png
       :width: 600
       :align: center

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

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

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

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

    .. code-block:: yaml

        ---
        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* - Конфигурация хранилища данных. У каждого типа свой набор атрибутов, ознакомиться с ним подробнее можно ниже - :ref:`Параметры конфигурации отдельный хранилищ контента<content_configuration>`.

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

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

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

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

 .. image:: _static/content_7.png
       :width: 400
       :align: center

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

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

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

- Создать приложение с имеющегося стенда (архив с артефактом создастся автоматически) или, если вы создавали собственный yml файл, создать zip архив самостоятельно. За основу можете взять данный файл `test-app.zip <https://github.com/Citeck/ecos-docs/blob/main/docs/general/Content_microservice/_static/test-app.zip>`_ и сгенерировать, как в нем.

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

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


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

.. _content_configuration:

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

Хранилище S3
--------------

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

.. code-block:: yaml

    ---
    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* - имя корзины, в которой будут сохраняться все файлы системы. (Корзина представляет собой аналог БД в опредененной СУБД. У одного хранилища может быть создано несколько корзин, притом каждая из них может иметь свои параметры, такие как обеспечения доступов и т.п.)