chaoranxie / singularity

Scheduler (HTTP API and webapp) for running mesos tasks—long running processes, one-off tasks, and scheduled jobs. #hubspot-open-source

Overview

Singularity is an API and web application for running and scheduling Apache Mesos tasks — including long running processes, scheduled jobs, and one-off tasks.

It focuses on a batteries-included approach: Singularity and its components provide an entire Platform as a Service (PaaS) to end-users. It has many features which have been introduced to reduce developer friction and ensure proper operation and reliable deployment of tasks. Users may even be unfamiliar with and shielded from the details of Mesos.

For a more thorough explanation of the concepts behind Singularity and Mesos click here.

---

Features###

• Native Docker Support
• JSON REST API and Java Client
• Fully featured web application (replaces and improves Mesos Master UI)
• Rich load balancer integration with Baragon
• Deployments, automatic rollbacks, and healthchecks
• Webhooks for third party integrations
• Configurable email alerts to service owners
• Historical deployment and task data
• Custom executor with extended log features

---

Getting Started

Requirements

• Mesos
• ZooKeeper
• Java 7+
• MySQL (optional)

Contact

• [email protected] // singularity-users
• #singularity-framework on freenode

Install

• Local Testing with Vagrant

---

Reference

Deployment

• API
• Configuration
• Examples
• Custom Executor Components

Development

• Local Development with Vagrant
• Hacking on the UI
• Understanding the basepom / Maven structure
• Third-party load balancer API design requirements
• Publishing releases (for committers)