Contents

KPM: the Kill Bill Package Manager
==================================

The goal of KPM is to facilitate the installation of Kill Bill and its plugins.

kpm can be used interactively to search and download individual artifacts (Kill Bill war, plugins, etc.) or to perform an automatic Kill Bill installation using a configuration file.

Installation
------------

    gem install kpm

Ruby 2.1+ or JRuby 1.7.11+ is recommended.

Quick start
-----------

Create a kpm.yml file as follows:

    killbill:
      version: 0.12.1
      webapp_path: /opt/tomcat/webapps/ROOT
      plugins_dir: /var/tmp/bundles
      plugins:
        java:
          - name: analytics-plugin
            version: 0.7.2
        ruby:
          - name: stripe-plugin
            version: 0.2.1
    kaui:
      version: LATEST
      webapp_path: /opt/tomcat/webapps/kaui

This instructs kpm to:
* Download the Kill Bill war (version 0.12.1) and install it as `/opt/tomcat/webapps/ROOT`
* Setup the Analytics (Java) plugin (version 0.7.2) and the Stripe (Ruby) plugin (version 0.2.1) under `/var/tmp/bundles`
* Download the latest Kaui war and install it as `/opt/tomcat/webapps/kaui`

To start the installation:

    kpm install kpm.yml

To help you with discovery of plugins, you can run

    kpm search_for_plugins

This will list available (official) plugins. We maintain a list of recommended versions to use at https://github.com/killbill/killbill-cloud/blob/master/kpm/lib/kpm/plugins_directory.yml.

There are more advanced commands and options available, just run `kpm --help` for details.

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
kpm-0.0.13	README.md
kpm-0.0.12	README.md
kpm-0.0.11	README.md