Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jmnarloch/gocd-health-check-plugin

GO Continuous Delivery Health Check plugin
https://github.com/jmnarloch/gocd-health-check-plugin

Last synced: 4 days ago
JSON representation

GO Continuous Delivery Health Check plugin

Awesome Lists containing this project

README

        

# Go Continuous Delivery Health Check plugin

> Go Continuous Delivery task for awaiting until your application is healthy

[![Build Status](https://travis-ci.org/jmnarloch/gocd-health-check-plugin.svg)](https://travis-ci.org/jmnarloch/gocd-health-check-plugin)
[![Coverage Status](https://coveralls.io/repos/jmnarloch/gocd-health-check-plugin/badge.svg?branch=master&service=github)](https://coveralls.io/github/jmnarloch/gocd-health-check-plugin?branch=master)

## Installation

Download the plugin and copy it into `$GO_SERVER_HOME/plugins/external` and restart the Go server.

The plugin should appear on Plugins page.

## Usage

Add Health Check task to your build stage. The task with delay the execution of your pipeline according
to the configured setting in the same time performing fixed delay HTTP request to the provided health url.

The application health information is expected to be returned in a form of JSON with configurable expected status.

![Health Check task](screen.png)

## Options

### Url

The url to the application health information. (required)

Example: http://localhost:8080/health

### Attribute

The name of attribute indicating the application status. (required)

Example: status

Will match fallowing response:

```json

{"status": "UP"}

```

You can use dot-object notation to navigate over response JSON.

Example: health.status

```json

{
"health": {
"status": "green"
}
}

```

### Expected status

The expected application health status. (required)

Example: UP

### Delay

Time in seconds after a retry check will be performed after unsuccessful request. (required)

Example: 15

### Timeout

Maximum number of seconds to wait for the application to become healthy. (required)

Example: 60

## License

Apache 2.0