Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

GoCD task plugin skeleton

This is merely a skeleton plugin that plugin developers can fork to get quickly started with writing task plugins for GoCD. It works out of the box, but you should change it to do something besides executing curl.

All the documentation is hosted at

Getting started

  • Edit the file build.gradle to change the plugin id, description and some other metadata.
  • Edit the file settings.gradle to change the name of this project.
  • Edit the class to add any configuration fields that should be shown in the view.
  • Edit the file which contains the model for your task configuration.
  • Edit the task.template.html file which contains the view for the plugin settings page of your plugin.
  • Edit the class to perform validation of the task configuration as performed by a user.
  • Edit the and class to execute the task, and pipe stdout/stderr correctly.

Building the code base

To build the jar, run ./gradlew clean test assemble


Copyright 2017 ThoughtWorks, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

About the license and releasing your plugin under a different license

The skeleton code in this repository is licensed under the Apache 2.0 license. The license itself specifies the terms under which derivative works may be distributed (the license also defines derivative works). The Apache 2.0 license is a permissive open source license that has minimal requirements for downstream licensors/licensees to comply with.

This does not prevent your plugin from being licensed under a different license as long as you comply with the relevant clauses of the Apache 2.0 license (especially section 4). Typically, you clone this repository and keep the existing copyright notices. You are free to add your own license and copyright notice to any modifications.

This is not legal advice. Please contact your lawyers if needed.