[dromara] Простое и легкое онлайн-построение с низким уровнем вмешательства, автоматическое развертывание, ежедневная эксплуатация и обслуживание, а также программное обеспечение для мониторинга проекта.
[ Это родное программное обеспечение для работы на английском языке]
Международный сайт: https://jpom.dromara.org?
Материковая станция: https://jpom.top?
Если это распределенный проект, описанные выше шаги усложняются.
Позвольте Jpom помочь вам решить эти болевые точки! Однако это только самые основные функции, которые реализует Jpom.
- Некоторые функции серверов Windows могут вызывать проблемы совместимости из-за особенностей системы. Рекомендуется полностью протестировать их в реальных условиях использования. Linux в настоящее время имеет хорошую совместимость
- Пожалуйста, устанавливайте сервер и плагин в разные каталоги, никогда не устанавливайте их в один и тот же каталог.
- Чтобы удалить плагин или сервер Jpom, сначала остановите соответствующую службу, а затем удалите соответствующие программные файлы, папки журналов и папки каталогов данных.
- Локальная сборка зависит от системной среды. Если для команды сборки требуется maven или node, соответствующую среду необходимо установить на сервере, на котором собирается проект. Если вы уже запустили сервер, а затем установили соответствующую среду, вам необходимо перезагрузить сервер через командную строку, прежде чем среда вступит в силу.
- На сервере Ubuntu/Debian плагин может не быть добавлен. Создайте файл .bash_profile в корневом каталоге текущего пользователя.
- Не рекомендуется выполнять переход на более раннюю версию после обновления до 2.7.x, так как это может привести к несовместимости данных.
- Поскольку текущий плагин и сервер текущей версии 2.xx в основном используют протокол http для связи, сети плагина и сервера требуют совместимости, поэтому будьте внимательны при их использовании.
- Начато планирование и обновление версии Jpom 3.0, с нетерпением ждите появления новой версии.
Обязательно прочтите перед обновлением: CHANGELOG.md
Jpom поддерживает несколько методов установки для удовлетворения индивидуальных потребностей разных пользователей. Вам нужно выбрать только один метод установки.
Примечание. Каталог установки находится в каталоге, в котором выполняется команда!
️ Особое напоминание: при выполнении установки в один клик обратите внимание, что команды выполнения не могут находиться в одном каталоге, то есть серверная часть и агентская часть не могут быть установлены в один и тот же каталог!Если вам нужно изменить путь хранения данных и журналов сервера, измените свойство конфигурации
jpom.path
в файлеapplication.yml
.
# 一键默认安装
curl -fsSL https://jpom.top/docs/install.sh | bash -s Server jdk+default
# 一键默认安装 + 自动配置开机自启服务
curl -fsSL https://jpom.top/docs/install.sh | bash -s Server jdk+default+service
# 安装服务端和 jdk 环境
yum install -y wget &&
wget -O install.sh https://jpom.top/docs/install.sh &&
bash install.sh Server jdk
# 安装服务端和 jdk、maven 环境
yum install -y wget &&
wget -O install.sh https://jpom.top/docs/install.sh &&
bash install.sh Server jdk+mvn
# ubuntu
apt-get install -y wget &&
wget -O install.sh https://jpom.top/docs/install.sh &&
bash install.sh Server jdk
После успешного запуска порт сервера — 2122
, а доступ к странице управления можно получить через http://127.0.0.1:2122/
(если она не доступна локально, необходимо заменить 127.0.0.1 на IP-адрес сервера). вы установили).
Если вы не можете получить доступ к системе управления, выполните команду
systemctl status firewalld
чтобы проверить, включен ли брандмауэр. Если в строке состояния отображается зеленый цвет «Active: active (running)
вам необходимо разрешить порт2122
.# 放行管理系统的 2122 端口 firewall-cmd --add-port=2122/tcp --permanent # 重启防火墙才会生效 firewall-cmd --reloadЕсли порт по-прежнему недоступен после его освобождения в операционной системе и вы используете облачный сервер, перейдите на серверную часть облачного сервера и проверьте, разрешают ли правила группы безопасности порт 2122.
️ Примечание. В системах Linux существует множество видов межсетевых экранов: Firewall, Iptables, SELinux и т. д. При проверке конфигурации межсетевого экрана необходимо проверить их все.
Если сервер, на котором установлен сервер, также нуждается в управлении, то плагин также необходимо установить на сервер (сервер и плагин могут быть установлены одновременно на одном сервере)
️ Особое напоминание: при выполнении установки в один клик обратите внимание, что команды выполнения не могут находиться в одном каталоге, то есть серверная часть и агентская часть не могут быть установлены в один и тот же каталог!Если вам нужно изменить путь к данным подключаемого модуля и хранилищу журналов, измените свойство конфигурации
jpom.path
в файлеapplication.yml
.
# 一键默认安装
curl -fsSL https://jpom.top/docs/install.sh | bash -s Agent jdk+default
# 一键默认安装 + 自动配置开机自启服务
curl -fsSL https://jpom.top/docs/install.sh | bash -s Agent jdk+default+service
# 安装插件端和 jdk 环境
yum install -y wget &&
wget -O install.sh https://jpom.top/docs/install.sh &&
bash install.sh Agent jdk
# ubuntu
apt-get install -y wget &&
wget -O install.sh https://jpom.top/docs/install.sh &&
bash install.sh Agent jdk
После успешного запуска порт плагина — 2123
, и плагин предоставляется серверу.
️ Примечание. При использовании контейнерного метода установки сначала необходимо установить docker. Нажмите, чтобы перейти к документу по установке Docker.
docker run -p 2122:2122 --name jpom-server jpomdocker/jpom
docker pull registry.cn-chengdu.aliyuncs.com/jpomdocker/jpom
mkdir -p /home/jpom-server/logs
mkdir -p /home/jpom-server/data
mkdir -p /home/jpom-server/conf
docker run -d -p 2122:2122
--name jpom-server
-v /home/jpom-server/logs:/usr/local/jpom-server/logs
-v /home/jpom-server/data:/usr/local/jpom-server/data
-v /home/jpom-server/conf:/usr/local/jpom-server/conf
jpomdocker/jpom
docker pull jpomdocker/jpom
mkdir -p /home/jpom-server/logs
mkdir -p /home/jpom-server/data
mkdir -p /home/jpom-server/conf
docker run -d -p 2122:2122
--name jpom-server
-v /home/jpom-server/logs:/usr/local/jpom-server/logs
-v /home/jpom-server/data:/usr/local/jpom-server/data
-v /home/jpom-server/conf:/usr/local/jpom-server/conf
jpomdocker/jpom
docker pull registry.cn-chengdu.aliyuncs.com/jpomdocker/jpom
docker volume create jpom-server-data
docker volume create jpom-server-logs
docker volume create jpom-server-conf
docker run -d -p 2122:2122
--name jpom-server
-v jpom-server-data:/usr/local/jpom-server/data
-v jpom-server-logs:/usr/local/jpom-server/logs
-v jpom-server-conf:/usr/local/jpom-server/conf
jpomdocker/jpom
docker pull jpomdocker/jpom
docker volume create jpom-server-data
docker volume create jpom-server-logs
docker volume create jpom-server-conf
docker run -d -p 2122:2122
--name jpom-server
-v jpom-server-data:/usr/local/jpom-server/data
-v jpom-server-logs:/usr/local/jpom-server/logs
-v jpom-server-conf:/usr/local/jpom-server/conf
jpomdocker/jpom
Контейнерная установка доступна только в серверной версии. Из-за изоляции между контейнером и хост-средой многие функции на стороне плагина не могут нормально использоваться, поэтому контейнеризация на стороне плагина не имеет большого значения.
Чтобы установить докер, настроить образы, автоматически запуститься, найти каталог после установки и т. д., обратитесь к документу https://jpom.top/pages/b63dc5/.
При запуске в более ранней версии Docker может возникнуть ошибка
ls: cannot access'/usr/local/jpom-server/lib/': Operation not permitted
. В этом случае вам необходимо добавить параметр--privileged
, например. как:docker run -p 2122:2122 --name jpom-server jpomdocker/jpom --privileged
agent-xxx-release
находятся все установочные файлы на стороне подключаемого модуля.2123
server-xxx-release
содержит все установочные файлы сервера.2122
Доступ к странице управления: http://127.0.0.1:2122/
(для нелокального доступа замените 127.0.0.1
на IP-адрес вашего сервера).web-vue
и выполните npm install
(для пакетов зависимостей необходимо заранее собрать и установить среду vue, подробности см. в README.md в каталоге web-vue).npm run build
, чтобы упаковать проект vue.mvn clean package
modules/agent/target/agent-xxx-release
2123
modules/server/target/server-xxx-release
2122
Доступ к странице управления: http://127.0.0.1:2122/
(для нелокального доступа замените 127.0.0.1
на IP-адрес вашего сервера).Вы также можете использовать
script/release.bat
илиscript/release.sh
для быстрой упаковки.
Необходимо обратить внимание на изменение значения токена в файле
.env
yum install -y git
git clone https://gitee.com/dromara/Jpom.git
cd Jpom
docker-compose -f docker-compose.yml up
# docker-compose -f docker-compose.yml up --build
# docker-compose -f docker-compose.yml build --no-cache
# docker-compose -f docker-compose-local.yml up
# docker-compose -f docker-compose-local.yml build --build-arg TEMP_VERSION=.0
# docker-compose -f docker-compose-cluster.yml up --build
org.dromara.jpom.JpomAgentApplication
2123
org.dromara.jpom.JpomServerApplication
2122
web-vue
(предварительным условием является то, что в локальной среде разработки есть среды node и npm).npm install
на консоли.npm run dev
на консоли.http://127.0.0.1:3000/
(для нелокального доступа замените 127.0.0.1
на IP-адрес вашего сервера) # 服务端管理脚本 (命令行)
./bin/Server.bat start # 启动Jpom服务端
./bin/Server.bat stop # 停止Jpom服务端
./bin/Server.bat restart # 重启Jpom服务端
./bin/Server.bat status # 查看Jpom服务端运行状态
# 服务端管理脚本 (控制面板),按照面板提示输入操作
./bin/Server.bat
# 插件端管理脚本
./bin/Agent.bat start # 启动Jpom插件端
./bin/Agent.bat stop # 停止Jpom插件端
./bin/Agent.bat restart # 重启Jpom插件端
./bin/Agent.bat status # 查看Jpom插件端运行状态
# 插件端管理脚本(控制面板),按照面板提示输入操作
./bin/Agent.bat
После запуска в системе Windows вам необходимо отслеживать статус запуска в соответствии с журналом. Если появляются искаженные символы, проверьте или измените формат кодировки. Рекомендуемый формат кодировки bat в системе Windows —
GB2312
# 服务端
./bin/Server.sh start # 启动Jpom服务端
./bin/Server.sh stop # 停止Jpom服务端
./bin/Server.sh restart # 重启Jpom服务端
./bin/Server.sh status # 查看Jpom服务端运行状态
./bin/Service.sh install # 创建Jpom服务端的应用服务(jpom-server)
# 插件端
./bin/Agent.sh start # 启动Jpom插件端
./bin/Agent.sh stop # 停止Jpom插件端
./bin/Agent.sh restart # 重启Jpom插件端
./bin/Agent.sh status # 查看Jpom插件端运行状态
./bin/Service.sh install # 创建Jpom插件端的应用服务(jpom-agent)
Данная услуга по установке предназначена только для справки. На практике конфигурацию можно настроить в соответствии с потребностями.
После успешной
./bin/Service.sh install
systemctl {статус | старт | остановка | перезапуск} jpom-сервер
systemctl {статус | старт | стоп | перезапуск} jpom-агент
В корневом пути запущенного проекта:
./conf/application.yml
программы./conf/application.ymlapplication.yml
application.yml
./conf/logback.xml
logback.xml
logback.xml
Некоторые изображения могут загружаться медленно.
Node.js компилирует указанный каталог:
yarn --cwd xxxx/ install
yarn --cwd xxxx/ build
Maven компилирует указанный каталог:
mvn -f xxxx/pom.xml clean package
Спасибо всем, кто ценит и вносит свой вклад. Ваша поддержка является движущей силой для нас, чтобы продолжать обновляться и двигаться вперед!
Чтобы лучше поддерживать проект с открытым исходным кодом, мы решили запустить периферийные продукты.
Поддержите нас покупкой, чтобы вы не только получили небольшой продукт, но и мы получили прибыль от вашей покупки (цена на периферийные продукты будет немного выше рыночной цены, поэтому, если вы не возражаете, пожалуйста, не размещайте заказ)
Отправка вклада считается подписанием соглашения CLA.
Будучи проектом с открытым исходным кодом, Jpom не может обойтись без поддержки сообщества. Любой может вносить изменения и предложения. Независимо от того, насколько велик или мал ваш вклад, ваш вклад поможет тысячам пользователей и разработчиков, и ваш вклад всегда останется в списке участников проекта. В этом также смысл проектов с открытым исходным кодом!
Чтобы обеспечить качество и спецификацию кода проекта, а также помочь вам быстрее понять структуру проекта, пожалуйста, прочтите, прежде чем писать:
Форкните этот репозиторий.
После Форка под вашей учетной записью появится дополнительный склад, точно такой же, как этот склад. Клонируйте склад своей учетной записи локально.
Обратите внимание на замену分支名
и用户名
в ссылке.
Если вы вносите код, укажите dev
в качестве названия ветки; если вы вносите документы, заполните в качестве названия ветки docs
.
git clone -b 分支名 https://gitee.com/用户名/Jpom.git
Измените код/документ и отправьте его после изменения.
# 把修改的文件添加到暂存区
git add .
# 提交到本地仓库,说明您具体做了什么修改
git commit -m '填写您做了什么修改'
# 推送到远程仓库,分支名替换成 dev 或者 docs
git push origin 分支名
Войдите на свой склад, после чего вы увидите PR-запрос. Нажмите «Запросить слияние» и подождите, пока администратор объединит ваш код.
ветвь | иллюстрировать |
---|---|
владелец | Основная ветка, защищенная ветка, эта ветка не принимает PR. После того, как бета-ветка будет протестирована и проблем не возникнет, она будет объединена в эту ветку. |
бета | Ветка бета-версии, защищенная ветка, данная ветка не принимает PR. После тестирования в ветке разработки он будет объединен с этой веткой. |
разработчик | Ветка разработки принимает PR, отправьте PR в ветку разработки. |
документы | Раздел документации проекта, принятие PR, введение функций проекта, обобщение часто задаваемых вопросов и т. д. |
В настоящее время ветки dev и docs в основном используются и принимают изменения PR. Остальные ветки являются архивными, и участники могут их игнорировать.
Сделано с помощью contrib.rocks.
Название проекта | Адрес проекта | Введение в проект |
---|---|---|
SpringBoot_v2 | https://gitee.com/bdj/SpringBoot_v2 | Чистый каркас на основе Springboot |
Проект TLog GVP | https://gitee.com/dromara/TLog | Облегченный артефакт отслеживания тегов распределенного журнала, доступ к которому можно получить за 10 минут, который автоматически размечает журналы тегами для полного отслеживания ссылок микросервисов. |
Са-Токен | https://gitee.com/dromara/sa-токен | Возможно, это самая комплексная система аутентификации полномочий Java в истории! |
Извержение | https://gitee.com/erupt/erupt | Нулевой интерфейсный код, чистая разработка аннотаций, опыт управления администратором |
бегемот4j | https://gitee.com/magegoofy/hippo4j | Мощная структура динамического пула потоков с функциями мониторинга и оповещения. |
HertzBeat | https://gitee.com/dromara/hertzbeat | Простая в использовании и дружелюбная система облачного мониторинга, агент не требуется, мощные возможности настраиваемого мониторинга. |