.. _Install_Docker_Integration_InstallingPortal:

Установка веб-портала
#####################

.. note::

    Можно пропустить этот раздел, если на машину не планируется устанавливать :ref:`веб-портал <web-portal>`.

Для установки веб-портала в Docker нужно:

* задать параметры контейнера;
* выполнить скрипт, который создаст контейнер на основе образа;
* запустить контейнер;
* настроить доступ к веб-порталу через Nginx.

Задание параметров контейнера
*****************************

Для того чтобы задать параметры контейнера, нужно открыть конфигурационный файл ``ContainerConfiguration.json`` в текстовом редакторе:

.. code-block:: console

    nano ~/Загрузки/TerraLink.xDEPro/Integration.Portal/ContainerConfiguration.json

Параметры контейнера приведены ниже:

.. code-block:: JSON

    {
        "Appsettings": {        // содержимое файла конфигурации appsettings.json
            // ...
        }
    }

Для работы веб-портала понадобится подключение к Integration API.
В поле ``ApiConnectAddress`` требуется указать строку подключения к Integration API, который был развернут ранее:

.. code-block:: JSON

    {
        // ...
        "RestApiConnectionSettings": {
            "ApiConnectAddress": "http://192.168.11.128:6101"
        },
        // ...
    }

Затем нужно сохранить файл (``Ctrl+O``) и выйти из редактора (``Ctrl+X``).

| См. также:
| :ref:`Конфигурационный файл веб-портала <Install_ConfigFiles_Integration_ConfiguringPortal>`

Создание и запуск контейнера
****************************

Для создания контейнера нужно перейти в папку с образом:

.. code-block:: console

    cd ~/Загрузки/TerraLink.xDEPro/Integration.Portal

и с помощью Powershell Core выполнить скрипт ``CreateDockerContainer.ps1``:

.. code-block:: console

    rootlessenv pwsh ./CreateDockerContainer.ps1

В результате будет создан контейнер с именем ``xde-integration-portal-container``.

.. include:: ../_Include/StartingContainer.rst

Лог-файлы
*********

| Вместе с контейнером в Docker создается том для хранения лог-файлов.
| Имя тома: ``xde-integration-portal-logs``.

Для получения пути к тому в файловой системе Docker-хоста нужно выполнить команду:

.. code-block:: console

    rootlessenv docker volume inspect xde-integration-portal-logs

Поле ``Mountpoint`` будет указывать на путь к папке с лог-файлами в файловой системе Docker-хоста.

.. note::
    
    Содержимое тома доступно только с правами суперпользователя.

.. include:: ../../_Include/Integration/Portal/SettingUpNginxAccess.rst

.. include:: ../../_Include/Integration/Portal/TestingPortalAccess.rst