- Создатель Отдел Документации, отредактировано дек 16, 2022
Предварительная установка дополнительного ПО на сервере
Для запуска EDM Issue на сервере требуется произвести установку дополнительного ПО:
- Установить последнюю стабильную версию Docker (ссылка на инструкцию на официальном сайте).
- Установить последнюю стабильную версию Docker Compose (ссылка на инструкцию на официальном сайте).
Дальнейшие инструкции предполагают, что пользователь обладает правами взаимодействия с Docker и запуска Docker Compose без повышения привилегий командой sudo. Для формирования таких прав у текущего пользователя рекомендуется изучить следующий раздел официальной документации Docker.
Получение файлов, необходимых для запуска EDM Issue
Набор файлов, необходимых для запуска EDM Issue, находится в архиве: edm-issue.zip.
. ├── .env ├── data │ ├── edmi-db │ │ ├── init-db │ │ │ └── init-db.sql │ │ └── postgresql.conf │ └── edmi-web-ui │ └── ssl │ ├── autocreated-cert.crt │ └── autocreated-cert.key ├── docker-compose-cli.yml ├── docker-compose.yml └── monitoring ├── .env ├── docker-compose.yml ├── grafana │ └── provisioning │ ├── dashboards │ │ ├── dashboard.yml │ │ ├── edm_alert_metrics.json │ │ └── edm_monitor.json │ ├── datasources │ │ └── datasource.yml │ └── notifiers │ ├── email.yml │ └── telegram.yml ├── influxdb │ └── influx_init.iql ├── prometheus │ └── prometheus.yml └── telegraf └── telegraf.conf
Архив должен быть загружен на целевой сервер и распакован в любой удобной для дальнейшей эксплуатации директории.
У администраторов EDM Issue для запуска, остановки и редактирования конфигурации EDM Issue должны быть права на чтение и запись распакованных файлов.
Запуск EDM Issue
Для запуска EDM Issue требуется произвести следующие шаги:
- Перейти в директорию с содержимым распакованного архива.
Убедиться, что в файле .env прописан "EDM_TAG" версии 1.2.
Заполнение файла .env# EDM version EDM_TAG=1.2
Прочие переменные окружения, которые можно описать в .env файле, описаны в разделе Управление настройками EDM Issue.
Запустить EDM Issue командой:
Команда запуска EDM Issuedocker compose up -d
Пример вывода команды при первом запуске EDM Issue на хосте Развернуть исходный кодedm@edm:~/issue$ docker compose up -d [+] Running 48/48 ⠿ edmi-server Pulled 22.1s ⠿ fb7197b7a03c Pull complete 19.4s ⠿ a9ceb4e633c7 Pull complete 20.2s ⠿ fd80b0cb7230 Pull complete 20.3s ⠿ 8d120444f8b8 Pull complete 20.6s ⠿ 228d7167f27f Pull complete 21.0s ⠿ c71d47816735 Pull complete 21.3s ⠿ edmi-web-ui Pulled 19.5s ⠿ 9aae54b2144e Pull complete 15.0s ⠿ deb02d0f047e Pull complete 17.1s ⠿ faa46c06ae12 Pull complete 17.2s ⠿ 8bbe2a6a37c5 Pull complete 17.3s ⠿ f9b897942de0 Pull complete 17.4s ⠿ 7141e8eb7387 Pull complete 17.6s ⠿ c0ccde5fa165 Pull complete 17.7s ⠿ 8203d153ddc8 Pull complete 17.8s ⠿ ef58636d9683 Pull complete 18.0s ⠿ 45133997f00b Pull complete 18.1s ⠿ 0db6c69958e5 Pull complete 18.2s ⠿ b01475f50325 Pull complete 18.4s ⠿ edmi-init Pulled 21.9s ⠿ e7c96db7181b Pull complete 1.0s ⠿ f910a506b6cb Pull complete 1.0s ⠿ c2274a1a0e27 Pull complete 19.1s ⠿ b9df22590b50 Pull complete 19.5s ⠿ 2a68cad3fe5b Pull complete 20.0s ⠿ 980ec4e4c502 Pull complete 20.2s ⠿ 5b4b8f5271d4 Pull complete 20.4s ⠿ 19bd75f7d7d1 Pull complete 20.7s ⠿ 3c16d3d230bc Pull complete 21.0s ⠿ edmi-loader Pulled 22.4s ⠿ 927ebe035398 Pull complete 20.6s ⠿ c3e94fb116ad Pull complete 21.2s ⠿ edmi-db Pulled 26.1s ⠿ 45b42c59be33 Pull complete 10.2s ⠿ 40adec129f1a Pull complete 10.5s ⠿ b4c431d00c78 Pull complete 10.6s ⠿ 2696974e2815 Pull complete 10.9s ⠿ 564b77596399 Pull complete 13.1s ⠿ 5044045cf6f2 Pull complete 13.2s ⠿ d736e67e6ac3 Pull complete 13.3s ⠿ 390c1c9a5ae4 Pull complete 13.5s ⠿ fbb0dc403c2f Pull complete 24.6s ⠿ 1b9ba7c0986e Pull complete 24.7s ⠿ b6c9d2fab5c1 Pull complete 24.8s ⠿ 19f04f19f5bb Pull complete 24.9s ⠿ 0a195310fe0b Pull complete 25.1s ⠿ 1a99568d6863 Pull complete 25.2s [+] Running 7/7 ⠿ Network edmi-network Created 0.0s ⠿ Network edmi-monitoring-network Created 0.0s ⠿ Container edmi-db Started 11.5s ⠿ Container edmi-init Started 3.8s ⠿ Container edmi-server Started 4.3s ⠿ Container edmi-loader Started 4.3s ⠿ Container edmi-web-ui Started 6.1s edm@edm:~/issue$
Убедиться, что все контейнеры EDM Issue успешно запустились, используя команду:
Команда проверки статуса контейнеров EDM Issuedocker compose ps
Пример вывода команды при успешном запуске всех контейнеров EDM Issue Развернуть исходный кодedm@edm:~/issue$ docker compose ps NAME COMMAND SERVICE STATUS PORTS edmi-db "docker-entrypoint.s…" edmi-db running (healthy) 5432/tcp edmi-init "/bin/sh -c '/usr/lo…" edmi-init running (healthy) edmi-loader "/bin/sh -e /usr/loc…" edmi-loader running (healthy) 8098/tcp edmi-server "/bin/sh -e /usr/loc…" edmi-server running (healthy) 0.0.0.0:8098->8098/tcp, :::8098->8098/tcp edmi-web-ui "/usr/local/bin/entr…" edmi-web-ui running (healthy) 0.0.0.0:8091->80/tcp, :::8091->80/tcp edm@edm:~/issue$
Теперь с EDM Issue можно взаимодействовать через web-интерфейс и через интерфейс командной строки.
После первого запуска EDM Issue в текущем каталоге появятся три новых директории:
- db – содержит файлы базы данных, используемой в EDM Issue;
- config – содержит файлы конфигурации для сервисов EDM Issue;
- logs – содержит логи сервисов EDM Issue.
Остановка EDM Issue
Для остановки EDM Issue требуется произвести следующие шаги:
- Перейти в директорию с файлами работающего EDM Issue.
Выполнить команду:
Команда остановки EDM Issuedocker compose down
Пример вывода команды при успешной остановке всех контейнеров EDM Issue Развернуть исходный кодedm@edm:~/issue$ docker compose down [+] Running 7/7 ⠿ Container edmi-loader Removed 10.9s ⠿ Container edmi-web-ui Removed 1.2s ⠿ Container edmi-server Removed 11.1s ⠿ Container edmi-init Removed 10.8s ⠿ Container edmi-db Removed 0.9s ⠿ Network edmi-network Removed 0.1s ⠿ Network edmi-monitoring-network Removed edm@edm:~/issue$
EDM Issue теперь остановлен. Для повторного запуска остановленного EDM Issue нужно выполнить команду "docker compose up -d".
Удаление EDM Issue
Для удаления EDM Issue требуется произвести следующие шаги:
- Перейти в директорию с файлами работающего EDM Issue.
Выполнить команду:
Команда для удаления EDM Issue с хостаdocker compose down --remove-orphans --rmi all --volumes
Пример вывода команды при успешной остановке EDM с удалением данных в Docker Развернуть исходный кодedm@edm:~/issue$docker compose down --remove-orphans --rmi all --volumes [+] Running 6/6 ⠿ Volume issue_edmi-healthcheck Removed 0.0s ⠿ Image lab3.eltex.loc:5000/edmi-web-ui:1.2 Removed 0.1s ⠿ Image lab3.eltex.loc:5000/postgres:12.5 Removed 0.6s ⠿ Image lab3.eltex.loc:5000/edmi-server:1.2 Removed 0.2s ⠿ Image lab3.eltex.loc:5000/edmi-init:1.2 Removed 0.4s ⠿ Image lab3.eltex.loc:5000/edmi-loader:1.2 Removed edm@edm:~/issue$
В результате выполнения команды EDM Issue будет остановлен. В случае если на момент выполнения команды он еще функционировал, будут удалены служебные сети, хранилища и образы в Docker.
Удалить оставшиеся от EDM Issue каталоги и служебные файлы:
Удаление оставшихся служебных файловsudo rm -rf .env config data db docker-compose-cli.yml docker-compose.yml log monitoring
Теперь EDM Issue полностью удален с хоста.
- Нет меток