JHipster module, packages a JHipster application into a debian/ubuntu .deb package
This is a JHipster module, that is meant to be used in a JHipster application. The module uses the jdeb library to repackage the war and configuration files into a .deb archive
As this is a JHipster module, we expect you have JHipster and its related tools already installed:
To install this module:
npm install -g generator-jhipster-debian-packagerTo update this module:
npm update -g generator-jhipster-debian-packagerIn your JHipster project directory run:
yo jhipster-debian-packagerThis will add a jdeb goal to the pom.xml and support files that will create a .deb archive in the target directory when mvn package is called.
Options :
--forceif you don't want questions to be asked.--cleanto uninstall the module instead of installing.
NOTE: with the current version of JHipster, some modifications must be done manually in the pom.xml:
- upgrade Spring Boot version to 1.3.2.RELEASE (because of issue spring-projects/spring-boot#4866)
- with JHipster version <= 2.26.2, set the war as executable for the prod profile with
<executable>true</executable>
You can then use the command
dpkg-i target/myapp_0.0.1~SNAPSHOT_all.debto install the package on a debian or ubuntu server. Or you can deploy it to an apt repository.
The executable war will be installed and started as a linux service. To start it manually use:
sudo service <appname> startBy default, the application is started with the prod profile. This can be changed in the /etc/default/<appname> configuration file.
The package installs the following files:
/usr/share/<appname>/lib/<appname>-<version>.war: your JHipster application as executable war symlinked to/usr/share/<appname>/bin/<appname>/etc/default/<appname>: the launch script configuration file (see Spring Boot doc. The .conf file is symlinked to this file)/etc/<appname>/: the directory for the configuration files (application.yml, ...)/var/log/<appname>/: the directory for the application logs
Apache-2.0 © [Christophe Bornet]