https://github.com/mallozup/saint-build

monitor your jenkins operations, jobs in async and functional elegance
https://github.com/mallozup/saint-build

ci clojure devops event-driven jenkins saint-build

Last synced: 23 days ago
JSON representation

monitor your jenkins operations, jobs in async and functional elegance

• Host: GitHub
• URL: https://github.com/mallozup/saint-build
• Owner: MalloZup
• License: gpl-3.0
• Created: 2019-07-18T17:48:17.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-07-28T08:18:44.000Z (over 5 years ago)
• Last Synced: 2024-10-20T13:20:20.282Z (23 days ago)
• Topics: ci, clojure, devops, event-driven, jenkins, saint-build
• Language: JavaScript
• Homepage:
• Size: 1.96 MB
• Stars: 13
• Watchers: 4
• Forks: 1
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![logo](doc/logo.png)

___

- [Quickstart](#quickstart)

- [specification](doc/specification.md)

- [features](#features)

- [architecture](#architecture)

- [who is using saint-build](#who-is-using-saint-build)

# Rationale:

Monitor jenkins events in async, functional, pragmatic way.

Sait-build send new events **only** when useful, with a smart cache mechanism.

The events handler sent notifications to medium of choices.

On a short-term the roadmap contains notifications, but other types of action can be implemented.

# Quickstart:

0) Edit the main configuration: [saintb-config.edn.example](saintb-config.edn.example)

See [specification](doc/specification.md) for more details.

1) Startup the daemon:

`java -jar saint-build-VERSION-standalone.jar`

* The configuration file should be on the same dir PWD as the daemon;

  the ENV variable `CONFIG_FILE_PATH` setup  config file from other locations.

# Features:

-  Monitor the build status of a given list of jobs, and send them via a medium or multiples of choice

-  Configure daemon (timeout)

# Architecture:

saint-build is composable and driven by the API.edn file.

It uses atoms for storing the states, and it build a cache for don't sending same event, but it trigger only new events when needed.

It is composable by design.

# Who is using saint-build

We are using saint-build at [SUSE](https://github.com/SUSE) 

# Constraints

- The project doesn't aim to support the full jenkins api.

- For moment all jobs events will sent to only 1 channel (rocketchat api). You will need to create 2 or more daemons with diff configuration pro team. ( this is also more isolated)

___

Copyright © 2019 Dario Maiocchi