Приложение Spring Boot как сервис
Как правильно настроить приложение Spring Boot, упакованное в виде исполняемого файла jar в качестве службы в системе Linux? Это рекомендуемый подход, или я должен преобразовать это приложение в войну и установить в Tomcat?
В настоящее время я могу запустить загрузочное приложение Spring из screen сеанс, что приятно, но требует ручного запуска после перезагрузки сервера.
То, что я ищу, это общий совет / направление или образец init.d сценарий, если мой подход с исполняемым JAR является правильным.
20 ответов
Следующие работы для Springboot 1.3 и выше:
Как служба init.d
Исполняемый файл jar содержит обычные команды start, stop, restart и status. Он также настроит PID-файл в обычном каталоге / var / run и войдет в обычный каталог / var / log по умолчанию.
Вам просто нужно добавить ссылку на ваш jar-файл в /etc/init.d примерно так
sudo link -s /var/myapp/myapp.jar /etc/init.d/myapp
ИЛИ ЖЕ
sudo ln -s ~/myproject/build/libs/myapp-1.0.jar /etc/init.d/myapp_servicename
После этого вы можете сделать обычное
/etc/init.d/myapp start
Затем установите ссылку в зависимости от того, какой уровень запуска вы хотите, чтобы приложение запускалось / останавливалось при загрузке, если это необходимо.
Как системный сервис
Чтобы запустить приложение Spring Boot, установленное в var / myapp, вы можете добавить следующий скрипт в /etc/systemd/system/myapp.service:
[Unit]
Description=myapp
After=syslog.target
[Service]
ExecStart=/var/myapp/myapp.jar
[Install]
WantedBy=multi-user.target
Ссылка
http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/html/deployment-install.html
Далее следует самый простой способ установить приложение Java в качестве системной службы в Linux.
Давайте предположим, что вы используете systemd (что сегодня делает любой современный дистрибутив):
Во-первых, создайте файл сервиса в /etc/systemd/system названный например javaservice.service с этим содержанием:
[Unit]
Description=Java Service
[Service]
User=nobody
# The configuration file application.properties should be here:
WorkingDirectory=/data
ExecStart=/usr/bin/java -Xmx256m -jar application.jar
SuccessExitStatus=143
TimeoutStopSec=10
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
Во-вторых, уведомить systemd нового файла сервиса:
systemctl daemon-reload
и включите его, чтобы он работал при загрузке:
systemctl enable javaservice.service
В конце концов, вы можете использовать следующие команды для запуска / остановки вашего нового сервиса:
systemctl start javaservice
systemctl stop javaservice
systemctl restart javaservice
systemctl status javaservice
При условии, что вы используете systemdэто самый ненавязчивый и чистый способ настроить приложение Java в качестве системного сервиса.
Что мне особенно нравится в этом решении, так это то, что вам не нужно устанавливать и настраивать любое другое программное обеспечение. Отправлены systemd выполняет всю работу за вас, а ваш сервис ведет себя как любой другой системный сервис. Некоторое время я использую его в производстве, в разных дистрибутивах, и он работает так, как вы ожидаете.
Еще один плюс в том, что с помощью /usr/bin/javaВы можете легко добавить jvm параметры, такие как -Xmx256m,
Также прочитайте systemd участие в официальной документации Spring Boot: http://docs.spring.io/spring-boot/docs/current/reference/html/deployment-install.html
Вы также можете использовать http://supervisord.org/ - очень удобный демон, который можно использовать для простого управления сервисами. Эти сервисы определяются простыми конфигурационными файлами, определяющими, что выполнять с каким пользователем, в каком каталоге и т. Д. Существуют миллионы опций. У supervisord очень простой синтаксис, поэтому он является очень хорошей альтернативой написанию сценариев инициализации SysV.
Вот простой файл конфигурации супервизора для программы, которую вы пытаетесь запустить / контролировать. (поместите это в /etc/supervisor/conf.d/yourapp.conf)
/etc/supervisor/conf.d/yourapp.conf
[program:yourapp]
command=/usr/bin/java -jar /path/to/application.jar
user=usertorun
autostart=true
autorestart=true
startsecs=10
startretries=3
stdout_logfile=/var/log/yourapp-stdout.log
stderr_logfile=/var/log/yourapp-stderr.log
Для управления приложением вам потребуется выполнить supervisorctl, который предоставит вам подсказку, где вы можете запустить, остановить, статус yourapp.
CLI
# sudo supervisorctl
yourapp RUNNING pid 123123, uptime 1 day, 15:00:00
supervisor> stop yourapp
supervisor> start yourapp
Если supervisord демон уже запущен, и вы добавили конфигурацию для своей службы без перезапуска демона, вы можете просто сделать reread а также update команда в supervisorctl ракушка.
Это действительно дает вам все гибкие возможности, которые вы имели бы при использовании сценариев SysV Init, но прост в использовании и управлении. Посмотрите на документацию.
Я только что нашел способ сделать это сам, поэтому ниже я дошел до сценария контроллера службы CentOS init.d. Пока он работает довольно хорошо, но я не хакер Bash, так что я уверен, что есть возможности для улучшений, так что мысли об улучшении приветствуются.
Прежде всего, у меня есть короткий конфигурационный скрипт /data/svcmgmt/conf/my-spring-boot-api.sh для каждого сервиса, который устанавливает переменные среды.
#!/bin/bash
export JAVA_HOME=/opt/jdk1.8.0_05/jre
export APP_HOME=/data/apps/my-spring-boot-api
export APP_NAME=my-spring-boot-api
export APP_PORT=40001
Я использую CentOS, поэтому, чтобы мои службы запускались после перезапуска сервера, у меня есть сценарий управления службами в /etc/init.d/my-spring-boot-api:
#!/bin/bash
# description: my-spring-boot-api start stop restart
# processname: my-spring-boot-api
# chkconfig: 234 20 80
. /data/svcmgmt/conf/my-spring-boot-api.sh
/data/svcmgmt/bin/spring-boot-service.sh $1
exit 0
Как вы можете видеть, это вызывает сценарий начальной настройки для настройки переменных среды, а затем вызывает общий сценарий, который я использую для перезапуска всех моих служб Spring Boot. В этом общем сценарии можно найти суть всего этого:
#!/bin/bash
echo "Service [$APP_NAME] - [$1]"
echo " JAVA_HOME=$JAVA_HOME"
echo " APP_HOME=$APP_HOME"
echo " APP_NAME=$APP_NAME"
echo " APP_PORT=$APP_PORT"
function start {
if pkill -0 -f $APP_NAME.jar > /dev/null 2>&1
then
echo "Service [$APP_NAME] is already running. Ignoring startup request."
exit 1
fi
echo "Starting application..."
nohup $JAVA_HOME/bin/java -jar $APP_HOME/$APP_NAME.jar \
--spring.config.location=file:$APP_HOME/config/ \
< /dev/null > $APP_HOME/logs/app.log 2>&1 &
}
function stop {
if ! pkill -0 -f $APP_NAME.jar > /dev/null 2>&1
then
echo "Service [$APP_NAME] is not running. Ignoring shutdown request."
exit 1
fi
# First, we will try to trigger a controlled shutdown using
# spring-boot-actuator
curl -X POST http://localhost:$APP_PORT/shutdown < /dev/null > /dev/null 2>&1
# Wait until the server process has shut down
attempts=0
while pkill -0 -f $APP_NAME.jar > /dev/null 2>&1
do
attempts=$[$attempts + 1]
if [ $attempts -gt 5 ]
then
# We have waited too long. Kill it.
pkill -f $APP_NAME.jar > /dev/null 2>&1
fi
sleep 1s
done
}
case $1 in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
esac
exit 0
При остановке он попытается использовать Spring Boot Actuator для выполнения управляемого останова. Однако в случае, если Actuator не настроен или не может отключиться в течение разумного периода времени (я даю ему 5 секунд, что на самом деле немного мало), процесс будет остановлен.
Кроме того, сценарий предполагает, что java-процесс, выполняющий приложение, будет единственным с "my-spring-boot-api.jar" в тексте деталей процесса. Это безопасное предположение в моей среде и означает, что мне не нужно отслеживать PID.
Если вы хотите использовать Spring Boot 1.2.5 с Spring Boot Maven Plugin 1.3.0.M2, вот вам решение:
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.2.5.RELEASE</version>
</parent>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>1.3.0.M2</version>
<configuration>
<executable>true</executable>
</configuration>
</plugin>
</plugins>
</build>
<pluginRepositories>
<pluginRepository>
<id>spring-libs-milestones</id>
<url>http://repo.spring.io/libs-milestone</url>
</pluginRepository>
</pluginRepositories>
Затем скомпилируйте как обычно: mvn clean package, сделайте символическую ссылку ln -s /.../myapp.jar /etc/init.d/myappсделай его исполняемым chmod +x /etc/init.d/myapp и начать это service myapp start (с сервером Ubuntu)
Я знаю, что это более старый вопрос, но я хотел представить еще один способ - appassembler-maven-plugin. Вот соответствующая часть из моего POM, которая включает в себя множество дополнительных значений параметров, которые мы сочли полезными:
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>appassembler-maven-plugin</artifactId>
<configuration>
<generateRepository>true</generateRepository>
<repositoryLayout>flat</repositoryLayout>
<useWildcardClassPath>true</useWildcardClassPath>
<includeConfigurationDirectoryInClasspath>true</includeConfigurationDirectoryInClasspath>
<configurationDirectory>config</configurationDirectory>
<target>${project.build.directory}</target>
<daemons>
<daemon>
<id>${installer-target}</id>
<mainClass>${mainClass}</mainClass>
<commandLineArguments>
<commandLineArgument>--spring.profiles.active=dev</commandLineArgument>
<commandLineArgument>--logging.config=${rpmInstallLocation}/config/${installer-target}-logback.xml</commandLineArgument>
</commandLineArguments>
<platforms>
<platform>jsw</platform>
</platforms>
<generatorConfigurations>
<generatorConfiguration>
<generator>jsw</generator>
<includes>
<include>linux-x86-64</include>
</includes>
<configuration>
<property>
<name>wrapper.logfile</name>
<value>logs/${installer-target}-wrapper.log</value>
</property>
<property>
<name>wrapper.logfile.maxsize</name>
<value>5m</value>
</property>
<property>
<name>run.as.user.envvar</name>
<value>${serviceUser}</value>
</property>
<property>
<name>wrapper.on_exit.default</name>
<value>RESTART</value>
</property>
</configuration>
</generatorConfiguration>
</generatorConfigurations>
<jvmSettings>
<initialMemorySize>256M</initialMemorySize>
<maxMemorySize>1024M</maxMemorySize>
<extraArguments>
<extraArgument>-server</extraArgument>
</extraArguments>
</jvmSettings>
</daemon>
</daemons>
</configuration>
<executions>
<execution>
<id>generate-jsw-scripts</id>
<phase>package</phase>
<goals>
<goal>generate-daemons</goal>
</goals>
</execution>
</executions>
</plugin>
КАК СЛУЖБА ОКНА
Если вы хотите, чтобы это работало в машине Windows, загрузите winsw.exe из
http://repo.jenkins-ci.org/releases/com/sun/winsw/winsw/2.1.2/
После этого переименуйте его в jar filename (например: your-app.jar)
winsw.exe -> your-app.exe
Теперь создайте XML-файл your-app.xml и скопируйте в него следующее содержимое.
<?xml version="1.0" encoding="UTF-8"?>
<service>
<id>your-app</id>
<name>your-app</name>
<description>your-app as a Windows Service</description>
<executable>java</executable>
<arguments>-jar "your-app.jar"</arguments>
<logmode>rotate</logmode>
</service>
Убедитесь, что exe и xml вместе с jar в одной папке.
После этого откройте командную строку в Администраторе и установите ее в службу Windows.
your-app.exe install
eg -> D:\Springboot\your-app.exe install
Если это не с
Error: Registry key 'Software\JavaSoft\Java Runtime Environment'\CurrentVersion' has value '1.8', but '1.7' is required.
Затем попробуйте следующее:
Delete java.exe, javaw.exe and javaws.exe from C:\Windows\System32
вот и все:) .
Чтобы удалить службу в Windows
your-app.exe uninstall
Для просмотра / запуска / остановки службы: win + r и введите Администрирование, затем выберите службу из этого. Затем щелкните правой кнопкой мыши, выберите опцию - запустить / остановить
Вот скрипт, который развертывает исполняемый файл jar в качестве службы systemd.
Он создает пользователя для службы и файла.service и помещает файл jar в /var, а также выполняет базовую блокировку привилегий.
#!/bin/bash
# Argument: The jar file to deploy
APPSRCPATH=$1
# Argument: application name, no spaces please, used as folder name under /var
APPNAME=$2
# Argument: the user to use when running the application, may exist, created if not exists
APPUSER=$3
# Help text
USAGE="
Usage: sudo $0 <jar-file> <app-name> <runtime-user>
If an app with the name <app-name> already exist, it is stopped and deleted.
If the <runtime-user> does not already exist, it is created.
"
# Check that we are root
if [ ! "root" = "$(whoami)" ]; then
echo "Must be root. Please use e.g. sudo"
echo "$USAGE"
exit
fi
# Check arguments
if [ "$#" -ne 3 -o ${#APPSRCPATH} = 0 -o ${#APPNAME} = 0 -o ${#APPUSER} = 0 ]; then
echo "Incorrect number of parameters."
echo "$USAGE"
exit
fi
if [ ! -f $APPSRCPATH ]; then
echo "Can't find jar file $APPSRCPATH"
echo "$USAGE"
exit
fi
# Infered values
APPFILENAME=$(basename $APPSRCPATH)
APPFOLDER=/var/javaapps/$APPNAME
APPDESTPATH=$APPFOLDER/$APPFILENAME
# Stop the service if it already exist and is running
systemctl stop $APPNAME >/dev/null 2>&1
# Create the app folder, deleting any previous content
rm -fr $APPFOLDER
mkdir -p $APPFOLDER
# Create the user if it does not exist
if id "$APPUSER" >/dev/null 2>&1; then
echo "Using existing user $APPUSER"
else
adduser --disabled-password --gecos "" $APPUSER
echo "Created user $APPUSER"
fi
# Place app in app folder, setting owner and rights
cp $APPSRCPATH $APPDESTPATH
chown $APPUSER $APPDESTPATH
chmod 500 $APPDESTPATH
echo "Added or updated the $APPDESTPATH file"
# Create the .service file used by systemd
echo "
[Unit]
Description=$APPNAME
After=syslog.target
[Service]
User=$APPUSER
ExecStart=/usr/bin/java -jar $APPDESTPATH
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
" > /etc/systemd/system/$APPNAME.service
echo "Created the /etc/systemd/system/$APPNAME.service file"
# Reload the daemon
systemctl daemon-reload
# Start the deployed app
systemctl start $APPNAME
systemctl status $APPNAME
Пример: 
Я закончил тем, что делал обслуживание systemd для разметки WAR/JAR
Я называю java -jar, потому что он более гибкий. Попытался также положить ExecStart=spring-mvc.war, но, несмотря на то, что это исполняемый файл, я получил "Ошибка формата Exec"
В любом случае, systemd присутствует во всех дистрибутивах и предлагает отличное решение для перенаправления журналов (syserr важен, когда ваша служба даже не запускает, местоположение файла log4j будет пустым:)).
cat /etc/systemd/system/spring-mvc.service
[Unit]
Description=Spring MVC Java Service
[Service]
User=spring-mvc
# The configuration file application.properties should be here:
WorkingDirectory=/usr/local/spring-mvc
# Run ExecStartPre with root-permissions
PermissionsStartOnly=true
ExecStartPre=-/bin/mkdir -p /var/log/spring-mvc
ExecStartPre=/bin/chown -R spring-mvc:syslog /var/log/spring-mvc
ExecStartPre=/bin/chmod -R 775 /var/log/spring-mvc
#https://www.freedesktop.org/software/systemd/man/systemd.service.html#ExecStart=
ExecStart=/usr/bin/java \
-Dlog4j.configurationFile=log4j2-spring.xml \
-DLog4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector \
-Dspring.profiles.active=dev \
-Denvironment-type=dev \
-XX:+UseConcMarkSweepGC \
-XX:CMSInitiatingOccupancyFraction=80 \
-XX:NewSize=756m \
-XX:MetaspaceSize=256m \
-Dsun.net.inetaddr.ttl=5 \
-Xloggc:/var/log/spring-mvc/gc.log \
-verbose:gc \
-verbosegc \
-XX:+DisableExplicitGC \
-XX:+PrintGCDetails \
-XX:+PrintGCDateStamps \
-XX:+PreserveFramePointer \
-XX:+StartAttachListener \
-Xms1024m \
-Xmx1024m \
-XX:+HeapDumpOnOutOfMemoryError \
-jar spring-mvc.war
SuccessExitStatus=143
StandardOutput=journal
StandardError=journal
KillSignal=SIGINT
TimeoutStopSec=20
Restart=always
RestartSec=5
StartLimitInterval=0
StartLimitBurst=10
LimitNOFILE=500000
LimitNPROC=500000
#https://www.freedesktop.org/software/systemd/man/systemd.exec.html#LimitCPU=
#LimitCPU=, LimitFSIZE=, LimitDATA=, LimitSTACK=, LimitCORE=, LimitRSS=, LimitNOFILE=, LimitAS=, LimitNPROC=, LimitMEMLOCK=, LimitLOCKS=, LimitSIGPENDING=, LimitMSGQUEUE=, LimitNICE=, LimitRTPRIO=, LimitRTTIME=¶
SyslogIdentifier=spring-mvc
[Install]
WantedBy=multi-user.target
# https://www.freedesktop.org/software/systemd/man/journalctl.html
#check logs --- journalctl -u spring-mvc -f -o cat
rsyslog - перенаправить ввод системного журнала из приложения в определенную папку / файл
cat /etc/rsyslog.d/30-spring-mvc.conf
if $programname == 'spring-mvc' then /var/log/spring-mvc/spring-mvc.log
& stop
Logrotate
cat /etc/logrotate.d/spring-mvc.conf
/var/log/spring-mvc/spring-mvc.log
{
daily
rotate 30
maxage 30
copytruncate
missingok
notifempty
compress
dateext
dateformat _%Y-%m-%d_%H-%M
delaycompress
create 644 spring-mvc syslog
su spring-mvc syslog
}
войти gc
cat /etc/logrotate.d/spring-mvc-gc.conf
/var/log/spring-mvc/gc.log
{
daily
rotate 30
maxage 30
copytruncate
missingok
notifempty
compress
dateext
dateformat _%Y-%m-%d_%H-%M
delaycompress
create 644 spring-mvc syslog
su spring-mvc syslog
}
Мой скрипт SysVInit для Centos 6 / RHEL (пока не идеально). Этот скрипт требует ApplicationPidListener.
Источник /etc/init.d/app
#!/bin/sh
#
# app Spring Boot Application
#
# chkconfig: 345 20 80
# description: App Service
#
### BEGIN INIT INFO
# Provides: App
# Required-Start: $local_fs $network
# Required-Stop: $local_fs $network
# Default-Start: 3 4 5
# Default-Stop: 0 1 2 6
# Short-Description: Application
# Description:
### END INIT INFO
# Source function library.
. /etc/rc.d/init.d/functions
# Source networking configuration.
. /etc/sysconfig/network
exec="/usr/bin/java"
prog="app"
app_home=/home/$prog/
user=$prog
[ -e /etc/sysconfig/$prog ] && . /etc/sysconfig/$prog
lockfile=/var/lock/subsys/$prog
pid=$app_home/$prog.pid
start() {
[ -x $exec ] || exit 5
[ -f $config ] || exit 6
# Check that networking is up.
[ "$NETWORKING" = "no" ] && exit 1
echo -n $"Starting $prog: "
cd $app_home
daemon --check $prog --pidfile $pid --user $user $exec $app_args &
retval=$?
echo
[ $retval -eq 0 ] && touch $lockfile
return $retval
}
stop() {
echo -n $"Stopping $prog: "
killproc -p $pid $prog
retval=$?
[ $retval -eq 0 ] && rm -f $lockfile
return $retval
}
restart() {
stop
start
}
reload() {
restart
}
force_reload() {
restart
}
rh_status() {
status -p $pid $prog
}
rh_status_q() {
rh_status >/dev/null 2>&1
}
case "$1" in
start)
rh_status_q && exit 0
$1
;;
stop)
rh_status_q || exit 0
$1
;;
restart)
$1
;;
reload)
rh_status_q || exit 7
$1
;;
force-reload)
force_reload
;;
status)
rh_status
;;
condrestart|try-restart)
rh_status_q || exit 0
restart
;;
*)
echo $"Usage: $0 {start|stop|status|restart|condrestart|try-restart|reload|force-reload}"
exit 2
esac
exit $?
Образец конфигурационного файла /etc/sysconfig/app:
exec=/opt/jdk1.8.0_05/jre/bin/java
user=myuser
app_home=/home/mysuer/
app_args="-jar app.jar"
pid=$app_home/app.pid
Следующая конфигурация требуется в файле build.gradle в проектах Spring Boot.
build.gradle
jar {
baseName = 'your-app'
version = version
}
springBoot {
buildInfo()
executable = true
mainClass = "com.shunya.App"
}
исполняемый файл = истина
Это необходимо для создания полностью исполняемого jar-файла в системе unix (Centos и Ubuntu).
Создайте файл.conf
Если вы хотите настроить пользовательские свойства JVM или аргументы запуска приложения Spring Boot, вы можете создать файл.conf с тем же именем, что и имя приложения Spring Boot, и разместить его параллельно с файлом jar.
Учитывая, что your-app.jar - это имя вашего приложения Spring Boot, вы можете создать следующий файл.
JAVA_OPTS="-Xms64m -Xmx64m"
RUN_ARGS=--spring.profiles.active=prod
LOG_FOLDER=/custom/log/folder
Эта конфигурация установит оперативную память 64 МБ для приложения Spring Boot и активирует профиль продукта.
Создать нового пользователя в linux
Для повышения безопасности мы должны создать конкретного пользователя для запуска приложения Spring Boot как службы.
Создать нового пользователя
sudo useradd -s /sbin/nologin springboot
В Ubuntu / Debian измените указанную выше команду следующим образом:
sudo useradd -s /usr/sbin/nologin springboot
Установка пароля
sudo passwd springboot
Сделать Springboot владельцем исполняемого файла
chown springboot:springboot your-app.jar
Запретить изменение файла jar
chmod 500 your-app.jar
Это настроит разрешения jar так, чтобы он не мог быть записан и мог быть прочитан или выполнен только его владельцем springboot.
При желании вы можете сделать свой файл jar неизменяемым, используя команду изменения атрибута (chattr).
sudo chattr +i your-app.jar
Соответствующие разрешения также должны быть установлены для соответствующего файла.conf..conf требует доступа только для чтения (Octal 400) вместо доступа на чтение + выполнение (Octal 500)
chmod 400 your-app.conf
Создать службу Systemd
/etc/systemd/system/your-app.service
[Unit]
Description=Your app description
After=syslog.target
[Service]
User=springboot
ExecStart=/var/myapp/your-app.jar
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
Автоматически перезапускать процесс, если он был убит ОС
Добавьте два следующих атрибута (Restart и RestartSec), чтобы автоматически перезапустить процесс в случае сбоя.
/etc/systemd/system/your-app.service
[Service]
User=springboot
ExecStart=/var/myapp/your-app.jar
SuccessExitStatus=143
Restart=always
RestartSec=30
Изменение приведет к перезапуску приложения Spring Boot в случае сбоя с задержкой в 30 секунд. Если вы остановите службу с помощью команды systemctl, перезапуска не произойдет.
Запланировать обслуживание при запуске системы
Чтобы пометить приложение для автоматического запуска при загрузке системы, используйте следующую команду:
Включить приложение Spring Boot при запуске системы
sudo systemctl enable your-app.service
Запустить Остановить службу
systemctl можно использовать в Ubuntu 16.04 LTS и 18.04 LTS для запуска и остановки процесса.
Начать процесс
sudo systemctl start your-app
Остановить процесс
sudo systemctl stop your-app
Ссылки
https://docs.spring.io/spring-boot/docs/current/reference/html/deployment-install.html
Я пытаюсь создать приложения Springboot, которые представлены в виде сценария оболочки в стиле "init.d" со сжатым Java-приложением, прикрепленным к концу.
Путем символической ссылки этих сценариев из /etc/init.d/spring-app в /opt/spring-app.jar и chmod'ing jar, чтобы он был исполняемым, можно запустить "/etc/init.d/spring-app "/etc/init.d/spring-app stop" и другие возможности, такие как работа со статусом
Предположительно, поскольку скрипты стиля init.d из Springboot выглядят так, что они имеют необходимые магические строки (например, # Default-Start: 2 3 4 5) chkconfig сможет добавить его в качестве "службы"
Но я хотел заставить его работать с systemd
Чтобы сделать это, я попробовал многие из получателей в других ответах выше, но ни один из них не работал для меня на Centos 7.2 с Springboot 1.3. В основном они запускали службу, но не могли отслеживать pid
В конце концов я обнаружил, что следующее сработало для меня, когда была установлена ссылка /etc/init.d. Файл, аналогичный приведенному ниже, должен быть установлен как /usr/lib/systemd/system/spring-app.service
[Unit]
Description=My loverly application
After=syslog.target
[Service]
Type=forking
PIDFile=/var/run/spring-app/spring-app.pid
ExecStart=/etc/init.d/spring-app start
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
В этом вопросе ответ от @PbxMan должен помочь вам начать:
Запустите приложение Java как службу в Linux
Редактировать:
Есть другой, менее приятный способ запустить процесс при перезагрузке, используя cron:
@reboot user-to-run-under /usr/bin/java -jar /path/to/application.jar
Это работает, но не дает вам приятного интерфейса запуска / остановки для вашего приложения. Вы все еще можете просто kill это все равно...
Вы используете Maven? Тогда вы должны попробовать плагин AppAssembler:
Плагин Application Assembler - это плагин Maven для генерации скриптов для запуска Java-приложений.... Все артефакты (зависимости + артефакт из проекта) добавляются в путь к классам в сгенерированных сценариях bin.
Поддерживаемые платформы:
Unix-варианты
Windows NT (Windows 9x НЕ поддерживается)
Java Service Wrapper (JSW)
Смотрите: http://mojo.codehaus.org/appassembler/appassembler-maven-plugin/index.html
Я не знаю "стандартного" термоусадочного способа сделать это с помощью Java-приложения, но это определенно хорошая идея (вы хотите воспользоваться возможностями поддержки активности и мониторинга операционной системы, если они там есть), В планах обеспечить что-то из поддержки инструментов Spring Boot (maven и gradle), но сейчас вам, вероятно, придется катиться самостоятельно. Лучшее решение, которое я знаю сейчас, - это Foreman, который имеет декларативный подход и однострочные команды для упаковки сценариев инициализации для различных стандартных форматов ОС (monit, sys V, upstart и т. Д.). Есть также доказательства того, что люди настроили вещи с помощью gradle (например, здесь).
В системных файлах systemd вы можете установить каталог переменных среды или через EnvironmentFile, Я бы предложил действовать таким образом, так как это кажется наименьшим трением.
Пример файла модуля
$ cat /etc/systemd/system/hello-world.service
[Unit]
Description=Hello World Service
After=systend-user-sessions.service
[Service]
EnvironmentFile=/etc/sysconfig/hello-world
Type=simple
ExecStart=/usr/bin/java ... hello-world.jar
Затем настройте файл в /etc/sysconfig/hello-world который включает в себя заглавные имена ваших переменных Spring Boot. Например, переменная с именем server.port будет следовать форме SERVER_PORT в качестве переменной среды:
$ cat /etc/sysconfig/hello-world
SERVER_PORT=8081
Используемый здесь механизм заключается в том, что приложения Spring Boot возьмут список свойств, а затем переведут их, сделав все в верхнем регистре и заменив точки на подчеркивания. Как только приложение Spring Boot проходит через этот процесс, оно ищет переменные среды, которые соответствуют, и использует любые найденные соответственно.
Это выделено более подробно в этой статье вопросов и ответов под названием: Как установить свойство Spring Boot с подчеркиванием в его имени через переменные среды?
Рекомендации
Это можно сделать с помощью сервиса Systemd в Ubuntu.
<code>
[Unit]
Description=A Spring Boot application
After=syslog.target
[Service]
User=baeldung
ExecStart=/path/to/your-app.jar SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
</code>
Вы можете перейти по этой ссылке для более подробного описания и различных способов сделать это. http://www.baeldung.com/spring-boot-app-as-a-service
Создайте скрипт с именем your-app.service (rest-app.service). Мы должны поместить этот сценарий в каталог /etc/systemd/system. Вот пример содержания скрипта
[Unit]
Description=Spring Boot REST Application
After=syslog.target
[Service]
User=javadevjournal
ExecStart=/var/rest-app/restdemo.jar
SuccessExitStatus=200
[Install]
WantedBy=multi-user.target
Следующий:
service rest-app start
Ссылки
В ответ на превосходный ответ Чада, если вы получите сообщение об ошибке "Ошибка: не удалось найти или загрузить основной класс" - и вы потратите пару часов на его устранение, будь то выполнение сценария оболочки, запускающего ваше Java-приложение, или запуск его из самого systemd - и вы знаете, что ваш classpath является на 100% правильным, например, запуск сценария оболочки вручную работает так же, как и запуск того, что есть в systemd execstart. Убедитесь, что вы работаете как правильный пользователь! В моем случае я пробовал разных пользователей, после долгого времени устранения неполадок - у меня наконец-то появилась догадка, поставил root как пользователь - вуаля, приложение запустилось правильно. После определения, что это была неправильная проблема пользователя, я chown -R user:user папка и подпапки, а также приложение работали корректно как указанные пользователь и группа, поэтому больше не нужно запускать их как root (плохая защита).
Для SpringBoot 2.4.4 в дополнение к инструкциям @ismael
У меня было следующее в моем maven pom.xml, чтобы сделать его исполняемым jar
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<executable>true</executable>
</configuration>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>