Данная инструкция описывает процесс установки локального модуля системы “Честный знак” в среде Docker. Локальный модуль предназначен для работы с маркированными товарами и обеспечивает взаимодействие с национальной системой маркировки и прослеживаемости товаров в части проверок оффлайн по разрешительному режиму.
Установка производится с использованием Docker контейнеров, что обеспечивает:
Для начала работы необходимо убедиться, что на вашем компьютере установлены:
Важно: Данная инструкция предполагает, что вы уже обладаете базовыми навыками работы с Docker и умеете устанавливать программное обеспечение на вашу операционную систему.
Для установки Docker и Docker Compose рекомендуем следовать официальным инструкциям:
Установка Docker: https://docs.docker.com/engine/install/
Установка Docker Compose: https://docs.docker.com/compose/install/
Для Windows рекомендуется использовать Docker Desktop, который включает в себя:
Порядок установки Docker Desktop:
# Проверка версии Docker
docker --version
# Проверка версии Docker Compose
docker compose version
# Проверка работоспособности демона
docker info
Совет: Перед началом установки рекомендуется создать резервную копию важных данных и настроить права доступа для пользователя, от имени которого будет производиться установка.
После успешной установки Docker и Docker Compose вы готовы перейти к следующему этапу - настройке и запуску локального модуля системы “Честный знак”.
Важно: Данная инструкция предполагает, что вы уже обладаете базовыми навыками работы с Docker и умеете устанавливать программное обеспечение на вашу операционную систему.
В данном разделе будем рассматривать пример установки под управлнием операционной системы Windows 11 с установленным Docker Desktop. При необходимости данная схема аналогичным образом может быть применена и при развертывании под управлением других операционных систем (Linux и MacOS).
В примере будут развернуты два контейнера со следующими настройками:
При необходимости изменения стандартных значений на свои требуется внести изменения в конфигурационный файл ext.ini, располагающийся в папке config.
А изменение портов для связи 5996 и 5997 производится в файле docker-compose.yaml
Так же в файле docker-compose.yaml
можно указать используемый образ ЛМ ЧЗ в реквизите image. Для использования версии 1.3.0 необходимо стандартное значение заменить на
image: registry.itida.ru/regime:1.3.0-366-ubuntu22_amd64
для использования самой последней версии образа можно указать вариант latest:
image: registry.itida.ru/regime:latest
Перед запуском модулей требуется скачать архив с преднастроенными папками и файлом docker-compose для развертывания контейнеров и распаковать содержимое в каталог на жестком диске (например на диск D).
Далее открыть командную строку или powershell и перейти в каталог, в который распакованы папки с модулями regime1 и regime2 и файлом docker-compose.yaml.
cd D:\regime
Запустить команду для развертывания контейнеров docker compose up -d
и дождаться окончания процесса развертывания.
После успешного развертывания в приложении Docker Desktop отобразится информация о запущенных контейнерах.
А конфигурационные файлы примут следующий вид.
На этом процедура развертывания завершена и можно переходить к настройкам Айтида iMark для установки связи с модулями и производить инициализацию модулей: Подключение локального модуля к Айтида iMark
Для обновления ЛМ ЧЗ, развернутого в среде Docker необходимо в файле docker-compose.yaml
изменить версию используемого образа на новую. К примеру, для обновления с версии 1.2.1-340 до версии 1.3.0-366 необходимо заменить тэг в имени используемого образа со старого значения 1.2.1-340-ubuntu22_amd64
на новое значение 1.3.0-366-ubuntu22_amd64
.
Имена тэгов совпадают с именами образов:
Так же допустим вариант указания тэга latest для обновления на самую актуальную версию образа.
После изменения версии образа в файле compose необходимо в командной строке перейти в каталог, содержащий этот compose файл и выполнить следующие команды:
docker compose pull
- для скачивания указанных в файле образов контейнеров
docker compose stop
- для остановки запущенных контейнеров
docker compose ud -d
- для запуска контейнера с использованием новых образов
После запуска контейнеров необходимо произвести процедуру инициализации локальных модулей.
Если после обновления образов инициализация локальных модулей не проходит и статус модуля отображается как "Не сконфигурирован", то рекомендуется произвести чистую установку ЛМ ЧЗ в среде docker