info.solidsoft.gradle:cdeliveryboy

CDeliveryBoy - Continuous Delivery for FOSS projects


Keywords
cd, continuous-delivery, gradle, gradle-plugin, release-automation, travis, travis-ci
License
Apache-2.0

Documentation

CDeliveryBoy Build Status Maven Central

Continuous Delivery solution for Gradle based FOSS projects.

Vision

Long time ago the vision sprung to my mind. Starting my new FOSS project I would like to be able to get a (doing nothing) template with all build-related stuff and Continuous Delivery to the Central Repository fully configured withing a few (at most several) minutes. Just to be able to immediately focus on the main problem to solve (aka "business logic"), not the infrastructure around. CDeliveryBoy is an attempt to achieve that. I already use it in my projects and there is a chance it can be useful also for some other FOSS authors.

Quick start

To be precisely defined. In the meantime please take a look at the Dummy CD project (a cDeliveryBoy branch) with sample (working) configuration or CDeliveryBoy project itself.

Features

This plugin provides (on its own or by internally orchestrating other plugins) the following release steps:

  • version management
  • artifacts building
  • tagging and pushing changes back to GitHub
  • promotion of uploaded artifacts to Maven Central

After initial configuration the whole release process is performed automatically on Travis when requested by a command placed in a commit message.

Requirements

The project should fulfill the following conditions:

  • configured artifacts upload to Sonatype Nexus OSS (with artifacts signing)
  • configured Travis build

Hint: gradle-template could be as a starting point.

Sample configuration

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'info.solidsoft.gradle:cdeliveryboy:0.8.0'
    }
}

apply plugin: 'info.solidsoft.cdeliveryboy'

cDeliveryBoy {
    nexus {
        autoPromote = false
    }
}

nexusStaging {
    packageGroup = "YOUR-PACKAGE-GROUP-IN-NEXUS"
}

scmVersion {
}

project.version = scmVersion.version

Rationale

I've been tired of manual releasing the FOSS projects I maintain. Being professionally deeply involved in Continuous Delivery of high quality "Enterprise-Class applications" I wanted to have a light version of CD available for me and other people prefering automation and convenience.

Alternatives

CDeliveryBoy has been created as there was no comprehensive solutions for Gradle available. CDeliveryBoy assumes a developer wants to follow proposed release flow in his/her project to speed up the things. However, in a situation the "default flow" is not enough there is also Mockito Release Tools, which emerged in the meantime, offering great flexibility (as the cost of more steep learning curve).

Additional information

The project is available as a technology preview and it definitely will be evolving in the way that breaks backward compatibility. Please take it into account before using it in production.

CDeliveryBoy has been written by Marcin ZajÄ…czkowski. The author can be contacted directly via email: mszpak ATT wp DOTT pl. There is also Marcin's blog available: Solid Soft - working code is not enough.

The project is licensed under the terms of the Apache License, Version 2.0.