Полное описание эксплуатации, обновления Cabinet API и Runtime приведено в основной статье
1. Установка Docker и Git
Обновить список пакетов и установить Git:
sudo apt update sudo apt install -y git
Установить Docker Engine с Docker Compose Plugin:
curl -fsSL https://get.docker.com | sudo sh
Добавить текущего пользователя в группу docker:
sudo usermod -aG docker $USER
Выйти из системы и войти снова (или перезагрузить сервер), чтобы изменения вступили в силу.
2. Клонирование репозитория
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
Если необходимо измените в .env значение HTTP_PORT
3. Создание каталогов
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
4. Создание stat.xml
Создать файл:
/var/mikbill/prod/config/stat.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>
Заполнить параметры подключения к базе данных.
5. Установка Cabinet API
Установить официальный updater:
cd /opt/mikbill/mbcabapi_docker sudo ./scripts/install_official_update_script.sh
Free версия:
cd /var/mikbill/updates/cabinetapi sudo ./cabinetapi_update.sh
Pay версия:
Поместить лицензии:
/var/mikbill/license/client.key /var/mikbill/license/serv.crt
После этого выполнить:
sudo ./cabinetapi_update.sh -f
6. Запуск Runtime
cd /opt/mikbill/mbcabapi_docker docker compose pull docker compose up -d
7. Проверка
docker compose ps docker compose logs --tail=100
API должно быть доступно по адресу:
http://IP_СЕРВЕРА/
Полное описание эксплуатации, обновления Cabinet API и Runtime приведено в основной статье