Debian Packages

Learn why you should use Debian packages in your Spinnaker pipelines.

Why use Debian packages

While Spinnaker is flexible enough to use any dependency management system, it is predisposed to manage Debian packages due to its default settings with Rosco, Orca, and Jenkins.

  • Out-of-the-box settings for Spinnaker look for an archived package with a .deb suffix within Jenkins. Spinnaker also gets the version from the package and automatically appends it to the package name within Rosco. This makes it easy to specify your package in Rosco without the version number, mycompany-app. However, during the bake provisioning process Spinnaker installs the version that was specified by the Jenkins build: mycompany-app.3.24.9-3.

  • Debian packaging allows service teams to easily add their app specific configuration to common Packer templates. If you’re using any Debian-based system (Ubuntu, DSL, Astra, etc), you’ll likely be using Debian packages for your system configuration and dependency management. So it’s a natural extension to use a Debian package for your own applications. Using Debian packages helps reduce the variations in Packer templates, or variables passed to Packer templates, during the bake process.

Creating Debian packages

You can create a Debian package by using various open source packaging tools. If you’re using Java, use the OS Package library. You can also use the packaging tools provided by Debian.

Language Tool Package Types
Java OS Package deb/rpm
Python stdeb deb
Node node-deb deb
PHP php-deb-packager deb
Any pkgr deb/rpm
Any fpm deb/rpm/others

Example: Debian package with OSPackage Gradle plugin

Begin by creating a build.gradle. You also need to create a config/scripts/post-install.sh file in your project directory.

Below is an example of what a Gradle file might look like for an app that builds a war. This uses the gradle-ospackage-plugin package. Basic usage of the Deb Plugin in the Deb Plugin docs.

buildscript {
  repositories {
    jcenter()
    maven { url "https://plugins.gradle.org/m2/" }
  }
  dependencies {
       classpath 'com.netflix.nebula:gradle-ospackage-plugin:8.5.6'
   }
}

apply plugin: 'nebula.ospackage'

ospackage {
  packageName = "mycompanyname-service"
  version = "1.10.3"

  requires('nginx')

  postInstall file('config/scripts/post-install.sh')

  from('build/application.war') {
    into '/opt/application/'
  }
}

Then build your Debian package based on your Gradle build file:

gradle buildDeb

If the build succeeds then you should find a Debian package in the following path:

./build/distributions/mycompanyname-service.1.10.3_all.deb

Last modified December 9, 2022: (77a2e500)