FPM is an open source tool that can package applications and dependencies into native packages that can be installed and managed by the system's native package manager. It wraps directories, gems, Python modules, and Node packages into deb, rpm, or other package formats. This allows applications and their dependencies to be deployed and managed using the system's native packaging tools rather than requiring alternative installation methods. FPM handles common tasks like packaging runtime dependencies or application code so that the packaged application can be deployed and managed through the system's native package manager.

1. FPM
The Swiss Army knife of the casual packager
Emmanuel Bastien
September 2011
Ruby Drinkup Sophia

2. Who am I?
@ebastien
https://github.com/ebastien
Polyglot programmer
Technologies enthusiast
FOSS believer

3. A day in the life of a DevOps

4. When operating a production environment, one of your
best friends is your configuration management
software.
Puppet is a well known open source configuration
management tool.

5. What Puppet typically handles for you:
Network, Email and system tools
System user accounts
Monitoring agent
Web server
Database server
Ruby runtime
All your configuration files

6. All you have to do now is deploy your app and maybe
some Gems.
Puppet knows how to install (and uninstall) native
packages.
Wanna build one for your app?

7. Native packaging is great
Native packaging is hard
Distribution policies are here for good reasons...
...but you don't care about policies if you are not a
maintainer!

8. FPM to the rescue
"Effing Package Management"
https://github.com/jordansissel/fpm
by @jordansissel

9. FPM puts a native package blanket on top of:
directories
gems
Python modules
Node packages

10. It'll make it deployable by your system packages
manager but won't fool a maintainer.

11. FPM in practice

12. Packaging the runtime deps of rivierarb.fr
sudo gem install fpm
mkdir -p ~/tmp/gems
cd ~/tmp
gem install --no-ri --no-rdoc
--install-dir ~/tmp/gems
jekyll compass rdiscount
find ~/tmp/gems/cache/ -name "*.gem" | xargs -rn1
fpm -s gem -t deb

13. Packaging the content of rivierarb.fr
mkdir -p ~/tmp/opt/rivierarb
wget -O - http://github.com/rivierarb/rivierarb/tarball/gh-pages|
tar -xz --strip-components=1 -C ~/tmp/opt/rivierarb
fpm -s dir -t deb -n rivierarb -v 0.2.0 -a all
-d "rubygem-jekyll (>= 0.11.0)"
-d "rubygem-compass (>= 0.11.5)"
-d "rubygem-rdiscount (>= 1.6.8)"
./opt/rivierarb

14. Deploying rivierarb.fr
$ ls -1 *.deb
rivierarb_0.2.0_all.deb
rubygem-albino_1.3.3_all.deb
rubygem-chunky-png_1.2.1_all.deb
rubygem-classifier_1.3.3_all.deb
rubygem-compass_0.11.5_all.deb
rubygem-directory-watcher_1.4.1_all.deb
rubygem-fast-stemmer_1.0.0_amd64.deb
rubygem-fssm_0.2.7_all.deb
rubygem-jekyll_0.11.0_all.deb
rubygem-kramdown_0.13.3_all.deb
rubygem-liquid_2.2.2_all.deb
rubygem-maruku_0.6.0_all.deb
rubygem-posix-spawn_0.3.6_amd64.deb
rubygem-rdiscount_1.6.8_amd64.deb
rubygem-sass_3.1.7_all.deb
rubygem-syntax_1.0.0_all.deb

15. Deploying rivierarb.fr
Next steps:
Upload the packages to your private repository
Reference the new version in your Puppet manifest

16. Deploying rivierarb.fr
package { 'rivierarb': ensure => '0.2.0' }

17. References
http://github.com/jordansissel/fpm
http://morethanseven.net/2011/04/29/Creating-a-cucumber-nagios-package-with-fpm.html
http://projects.puppetlabs.com/projects/puppet/wiki
http://www.jejik.com/articles/2006/09/setting_up_and_managing_an_apt_repository_with_reprepro/
This work is licensed under the Creative Commons Attribution 3.0 Unported License.