Тестирование можно проводить на WSL2

Конфигурация web-сервера apache2, для размещения сервисов 1С:Предприятие

Общая схема конфигурации

Доступ в хранилище конфигураций 1С по HTTP

Данная конфигурация реализует возможность подключения к crs по http. Файлы настроек подключений хранятся в каталоге crs-files.

Конфигурационный файл Web-сервиса для работы с удаленным хранилищем может иметь произвольное имя (*.1ccr), формат XML и содержит единственный узел с произвольным именем и атрибутом connectString ‑ в этом атрибуте указывается адрес сервера хранилища в схеме TCP.

Например, такой конфигурационный файл может иметь имя repository.1ccr и следующее содержание:

<?xml version="1.0" encoding="UTF-8"?>
<repository connectString="tcp://192.168.0.1"/>

Один web-сервер может одновременно обслуживать несколько клиентов (конфигураторов) и работать с несколькими хранилищами конфигураций:

Начальная настройка

После клонирования репозиторя нужно прописать местные пути в конфиги:

./mods-available/wsap24.conf
./mods-available/wsap24.load

Публикация web-сервисов 1С

Для публикации используются файлы формата VRD. Данные файлы служат для настройки веб-клиента, использования интернет-сервисов и находятся в каталоге виртуального приложения.

Описание формата VRD

Корневым элементом конфигурационного файла является <point>, который определяет настройки виртуального ресурса. Он может содержать по одному элементу <zones>, <ws>, <pool>, <debug>, <openid>, <openidconnect>, <exitURL>, <standardOData>, <analytics>, <progressiveWebApplication>, <httpServices>. При этом в элементе <ws> допустимо несколько вложенных элементов <point>, для элемента <zones> допустимо несколько вложенных элементов <zone>, <httpServices> может быть один или ни одного и может содержать произвольное количество элементов :

<point...>
    <ws...>
        <point>...</point>
            <zones>
                <zone>...</zone>
                <zone>...</zone>
            </zones>
        <point>...</point>
    </ws>
    <httpServices>
        <service>...<service/>
    </httpServices>
    <pool.../>
    <debug.../>
    <openid>
        <rely... />
        <provider>
            <lifetime>...</lifetime>
        </provider>
    </openid>
    <openidconnect.../>
    <exitURL>
        ...
    </exitURL>
    <standardOData.../>
    <analytics.../>
    <progressiveWebApplication.../>
</point>

Процесс обновления платформы 1С

Для размещения нового дистрибутива платформы нужно создать каталог новой версии дистрибутива в каталоге дистрибутивов конфигурации web-сервера:

В каталоге версии дистрибутива необходимо разместить deb-пакеты:

1c-enterprise83-common_version_amd64.deb
1c-enterprise83-server_version_amd64.deb
1c-enterprise83-ws_version_amd64.deb

Далее нужно распаковать данные deb-пакеты в каталог версии дистрибутива. Находясь в каталоге версии дистрибутива нужно выполнить комманды:

dpkg-deb --extract 1c-enterprise83-common_`version`_amd64.deb .
dpkg-deb --extract 1c-enterprise83-server_`version`_amd64.deb .
dpkg-deb --extract 1c-enterprise83-ws_`version`_amd64.deb .

Должна получиться следующая структура подкаталогов:

Далее необходимо обновить ссылку на текущую конфигурацию платформы 1с, используемую web-сервером при загрузке модуля wsap24.so. Для этого, находясь в корневом каталоге конфигурации веб сервиса,

нужно выполнить команду создания ссылки на дистрибутив платформы 1С.

unlink ./platform
ln -s -b ./distrib/`version`/opt/1C/v8.3/x86_64 ./platform

Проверим набор модулей Apache2:

ls -lha --color /etc/apache2/mods-enabled/
    alias.conf -> ../mods-available/alias.conf
    alias.load -> ../mods-available/alias.load
    authz_core.load -> ../mods-available/authz_core.load
    dir.conf -> ../mods-available/dir.conf
    dir.load -> ../mods-available/dir.load
    mpm_event.conf -> ../mods-available/mpm_event.conf
    mpm_event.load -> ../mods-available/mpm_event.load
    rewrite.load -> ../mods-available/rewrite.load
    wsap24.conf -> ../mods-available/wsap24.conf
    wsap24.load -> ../mods-available/wsap24.load

лишние отключаем:

a2dismod [module_name]

После чего можно перезагружать либо службу sudo systemctl restart apache2.service либо ОС целиком sudo reboot.

Если apache2 не стартует можно проверить ошибки командой journalctl -xe

Обновление данного репозитория

После изменения настроек и если все работает и проверено необходимо обновлять данный репозиторий для обеспечения сохранности конфигурации. Для этого используем git. Выполняем в корне репозитория:

git add .
git commit -a -m "Коментарий измменений"

git status не должен показывать незафиксированных изменений. Если все хорошо, заливаем в репозиторий git push

santens-devs/1cApacheWebService