Debian package and submit it to Debian

[dzc34]

Previous discussion with @rydroid:
https://github.com/Asqatasun/Asqatasun/issues/158

It is a "feature" proposition. There is no Debian package and even no way to build one. It would be great to have a way to build one and submit it to Debian to install this program more easily.

similar issue but less complete
#82 Automatically create a debian package at the maven build

documentation

• https://www.debian.org/doc/debian-policy/
• examples in French:
  • https://www.debian.org/doc/manuals/packaging-tutorial/packaging-tutorial.fr.pdf
  • https://doc.ubuntu-fr.org/tutoriel/creer_un_paquet
  • http://alp.developpez.com/tutoriels/debian/creer-paquet/
  • https://openclassrooms.com/courses/creer-un-paquet-deb

package Java apps on Ubuntu / Debian

• documentation:
  • https://www.debian.org/doc/packaging-manuals/java-policy/
• examples:
  • http://pkg-java.alioth.debian.org/examples/
  • https://blog.nekoconeko.nl/blog/2013/08/28/java_and_debian_packaging.html
  • http://pygmalion.nitri.de/create-a-debian-package-from-an-executable-jar-592.html
  • http://xmodulo.com/how-to-create-deb-debian-package-for-java-web-application.html
  • http://blog.pryds.eu/2013/02/package-java-apps-for-ubuntu-and-debian.html
  • http://blog.noizeramp.com/2005/08/31/packaging-java-applications-for-ubuntu-and-other-debians/
  • in french:
    • https://doc.ubuntu-fr.org/tutoriel/comment_publier_une_application_java

https://trac.osgeo.org/ubuntugis/wiki/java-packaging
There a multiples way to package Java apps on Ubuntu.

1. Fastest way is to get the jar/war file and make a package containing them. Your debian/rules will simply extract it at the right place.
2. It ends up making a package similar to the first way, but using tools like jdeb to make it automatically for you. jdeb(​https://github.com/tcurdt/jdeb) is a plugin for maven/ant that automatically creates a package from your Java app if it's using Maven or Ant to build.
3. There are also tools to help creating a package built from source ​https://wiki.debian.org/Java/Packaging. It works out of the box for ants and manually building the app
4. For maven projects, Maven-Debian-Helper(​https://wiki.debian.org/Java/MavenDebianHelper) makes it really easy to package an app if all the depencies are available.

1. get the jar/war file and make a package containing them

# Prerequisites
apt-get install       debhelper       \
                        cdbs            \
                        lintian         \
                        build-essential \
                        fakeroot        \
                        devscripts      \
                        pbuilder        \
                        dh-make         \
                        debootstrap

# First test
mkdir test_package_debian
cd test_package_debian
wget https://github.com/Asqatasun/Contrast-Finder/releases/download/v0.6.0/contrast-finder_0.6.0.i386.tar.gz
mv -v contrast-finder_0.6.0.i386.tar.gz contrast-finder_0.6.0.orig.tar.xz
tar zxvf contrast-finder_0.6.0.orig.tar.xz
mv contrast-finder_0.6.0.i386 contrast-finder_0.6.0
cd contrast-finder_0.6.0
dh_make -y -s -e [email protected] -p contrast-finder_0.6.0 
rm -rf *ex *EX README* && ls -l

# What's next?
...
...

# check package
dpkg --contents *.deb 
lintian -Iv *.deb 

# install package
dpkg -i *.deb
apt-get -f install

# See package information
dpkg -l tomcat7 libspring-instrument-java contrast-finder   

# Check directories
ls -l /etc/contrast-finder
ls -l /var/log/contrast-finder/
ls -l /var/lib/tomcat7/webapps
ls -l /usr/share/tomcat7/lib/spring3-instrument-tomcat* 

2. maven plugin jdeb

another way: maven plugin to create Debian packages from Java builds

• jdeb documentation
• jdeb on search.maven.org
• https://github.com/tcurdt/jdeb

it's works, but not ready for submit it to Debian repository (and not easy way)
see #82 Automatically create a debian package at the maven build

[dzc34]

added to #161 and closed

[dzc34]

remove the dedicated branch (unused):

• debian/changelog
• debian/compat
• debian/control
• debian/docs

debian/compat file

9

debian/control file

Package: contrast-finder
Architecture: all
Depends: tomcat7
Section: java
Priority: extra
Description: ...