/dockhand-jenkins

Upstream Jenkins Shared Library to Build, Promote, and Deploy Docker images

Primary LanguageGroovyMIT LicenseMIT

dockhand

Build

The Dockhand Jenkins Shared Library is a Groovy library meant to be used by any build pipelines that need to build images, push them to a remote registry, and trigger deployments to kubernetes clusters with Helm. The library encapsulates build functionality such as:

  • configuring git and checking out the repo to a build workspace
  • providing a wrapper to docker-compose to handle errors during docker-compose build, docker-compose up and docker-compose down when building and testing images
  • automatically updating the build-versions repo upon successful image builds
  • injection of secrets from Vault or AWS Secrets Manager using dockcmd into Helm Charts at deployment time
  • Handling automatic deployments of Helm charts upon commit to it’s corresponding application repos

dockhand is an upstream Jenkins Shared Library to Build, Promote, and Deploy Docker images.

Getting Started

  1. Fork the project
  2. Copy config.example.yaml to config.yaml in resources/com/boxboat/jenkins/
  3. Adjust global config values

Documentation

See docs/README.md

Quick Links