phrinx/service-artifact-gradle-plugin

Gradle plugin for building a prim and proper service artifact

Service Artifact Gradle Plugin

Gradle plugin for building a prim and proper service artifact. This plugin is meant to codify some standards and conventions around building service artifacts that can be easily built, tested and deployed

Dependencies

This plugin will include the appropriate versions of the following plugins:

• jruby-gradle base
• jruby-gradle jar
• asciidoctor

Usage

Example

plugins {
    id "com.github.lookout.service-artifact" version "0.1.6"
}

/* serviceVersion is a helper method which will add SNAPSHOT when appropriate,
 * but also introduce the appropriate Gerrit or Travis meta-data into the version
 * number (e.g. 1.0.{GERRIT_CHANGE}.{GERRIT_PATCH})
 */
version = service.version('1.0')
description = 'A sample Service to be built with Gradle'
group = 'com.github.lookout'

/* The following is an example of what a Gradle file might look like
 * for a JRuby-based service artifact.
 *
 * A service artifact is a self-contained artifact containing everything
 * execute a service. An artifact will take the form of a .tar.gz file,
 * and inside would be:
 *
 *  my-fancy-service.tar.gz
 *      - bin/ # managmeent scripts, as determined by @mbbx6spp
 *          - start
 *          - stop
 *      - my-fancy-service.jar
 */

service {
    jruby {
        /* Include these directories into the service jar.
         *
         * By default everything in src/main/ruby will be included
         */
        include 'backend', 'lib'
    }

    /* scripts inside of bin/ will override the defaults,
     * but this closure can be used to source additional scripts
     */
    scripts {
        include 'examples/bin'
    }
}

dependencies {
    gems "rubygems:faraday:1.0"
    gems "rubygems:sinatra:1.4.6"
}

Tasks

(NOTE: many of these tasks are not yet implemented)

Build

• serviceTarGz
• serviceZip
• serviceJar
• assemble

Test

• (JRuby) spec
• (JRuby) cucumber
• check

Publish

• publish

Internal-ish

• prepareServiceScripts - empty by default, can be used to set up build logic to generate service scripts
• prepareServiceJar - largely empty right now, just a standard dependency to chain builder tasks like shadowJar for jruby-gradle-jar plugin off of.

Documentation

• docs
• (asciidoctor) asciidoctor