MikBill Cabinet API Docker Quick Start [MikBiLL]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
<note> Полное описание эксплуатации, обновления Cabinet API и Runtime приведено в [[docker:mbcabinetapi|основной статье]] </note>
<note tip> Данная инструкция адаптирована для Debian-like дистрибутивов. Рекомендуемая ОС Debian 13 </note>
====== MikBill Cabinet API Docker Quick Start ======

===== 1. Установка Docker и Git =====

Обновить список пакетов и установить Git:

<code bash>
sudo apt update
sudo apt install -y git
</code>

Установить Docker Engine с Docker Compose Plugin:

<code bash>
curl -fsSL https://get.docker.com | sudo sh
</code>

Добавить текущего пользователя в группу docker:

<code bash>
sudo usermod -aG docker $USER
</code>

Выйти из системы и войти снова (или перезагрузить сервер), чтобы изменения вступили в силу.

----

===== 2. Клонирование репозитория =====

<code bash>
sudo mkdir -p /opt/mikbill
sudo chown "$USER":"$USER" /opt/mikbill
cd /opt/mikbill
git clone https://github.com/mikbill/mbcabapi_docker.git
cd mbcabapi_docker
cp .env.example .env
</code>

Если необходимо, измените в .env значение HTTP_PORT

----

===== 3. Создание каталогов =====

<code bash>
sudo mkdir -p /var/www/cabinetapi
sudo mkdir -p /var/mikbill/prod/config
sudo mkdir -p /var/mikbill/license
sudo mkdir -p /var/mikbill/updates/cabinetapi
sudo mkdir -p /var/mikbill/www_backups
sudo mkdir -p /var/log/mikbill/cabinetapi
</code>

----

===== 4. Создание stat.xml =====

Создать файл:

<code>
/var/mikbill/prod/config/stat.xml
</code>

Пример содержимого:

<code xml>
<config>
    <parameters>
        <mysql>
            <host>MySQL_IP_ADDRESS</host>
            <username>MySQL_USER</username>
            <password>MySQL_PASSWORD</password>
            <dbname>mikbill</dbname>
        </mysql>
        <mbdebug>false</mbdebug>
        <timezone>Europe/Kiev</timezone>
        <partialUTF8>false</partialUTF8>
        <error_log>/var/log/mikbill/cabinetapi/error.log</error_log>
        <debug_log>/var/log/mikbill/cabinetapi/debug.log</debug_log>
    </parameters>
</config>
</code>

Заполнить параметры подключения к базе данных.

----

===== 5. Установка Cabinet API =====

Установить официальный updater:

<code bash>
cd /opt/mikbill/mbcabapi_docker
sudo ./scripts/install_official_update_script.sh
</code>

**Free версия:**

<code bash>
cd /var/mikbill/updates/cabinetapi
sudo ./cabinetapi_update.sh
</code>

**Pay версия:**

Поместить лицензии:

<code>
/var/mikbill/license/client.key
/var/mikbill/license/serv.crt
</code>

После этого выполнить:

<code bash>
cd /var/mikbill/updates/cabinetapi
sudo ./cabinetapi_update.sh -f
</code>

----

===== 6. Запуск Runtime =====

<code bash>
cd /opt/mikbill/mbcabapi_docker
docker compose pull
docker compose up -d
</code>

----

===== 7. Проверка =====

<code bash>
docker compose ps
docker compose logs --tail=100
</code>

API должно быть доступно по адресу:

<code>
http://IP_СЕРВЕРА/
</code>

Полное описание эксплуатации, обновления Cabinet API и Runtime приведено в [[docker:mbcabinetapi|основной статье]]