Nomad is a flexible, enterprise-grade cluster scheduler designed to easily integrate into existing workflows. Nomad can run a diverse workload of micro-service, batch, containerized and non-containerized applications. Nomad is easy to operate and scale and integrates seamlessly with Consul and Vault.
Go JavaScript HTML CSS HCL Shell Other
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
acl fixup from code review Oct 17, 2017
api nomad: add 'Dispatch' field to Job Jun 11, 2018
client Merge pull request #4535 from hashicorp/f-keep-docker-container-0.8.4 Jul 26, 2018
command Merge pull request #4565 from hashicorp/b-compare-cert-alg Aug 15, 2018
demo Merge pull request #4164 from PeterDaveHello/update-demo-vagrantfile Apr 20, 2018
dev dev files Jun 1, 2018
dist systemd unit - Do not restart if unit fails 3 times in 10s Aug 6, 2018
e2e e2e/cli: comment fixups Aug 2, 2018
helper add signature algorithm to error message Aug 13, 2018
integrations spelling: registrations Mar 11, 2018
jobspec Canary tags structs May 7, 2018
lib Move delayheap to lib package Mar 14, 2018
nomad Merge pull request #4565 from hashicorp/b-compare-cert-alg Aug 15, 2018
plugins vet Aug 13, 2018
scheduler Merge pull request #4414 from hashicorp/b-stop-summary Jul 16, 2018
scripts Remove old protoc installer Aug 1, 2018
terraform Fix typo Aug 13, 2018
testutil test: build with mock_driver by default Apr 18, 2018
ui Remove the old json viewer Aug 14, 2018
vendor vendor github.com/golang/protobuf/ptypes/empty Aug 14, 2018
version remove structs + bump version Jun 11, 2018
website Clarify max_parallel interaction with taskgroups Aug 16, 2018
.gitattributes Remove invalid gitattributes Feb 14, 2018
.gitignore ignore tags Apr 26, 2018
.travis.yml upgrade nomad to 1.10.2 May 21, 2018
CHANGELOG.md add #4462 to changelog Jul 25, 2018
GNUmakefile add dev dependency for generating protobufs Aug 6, 2018
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md Mar 22, 2016
LICENSE Initial commit Jun 1, 2015
README.md add note to readme to install protoc for local development Aug 6, 2018
Vagrantfile Remove old protoc installer Aug 1, 2018
appveyor.yml test: build with mock_driver by default Apr 18, 2018
build_linux_arm.go Fix 32bit arm build Feb 9, 2017
main.go cli: differentiate normal output vs info Mar 30, 2018
main_test.go Adding initial skeleton Jun 1, 2015

README.md

Nomad Build Status Join the chat at https://gitter.im/hashicorp-nomad/Lobby

Nomad is a cluster manager, designed for both long lived services and short lived batch processing workloads. Developers use a declarative job specification to submit work, and Nomad ensures constraints are satisfied and resource utilization is optimized by efficient task packing. Nomad supports all major operating systems and virtualized, containerized, or standalone applications.

The key features of Nomad are:

  • Docker Support: Jobs can specify tasks which are Docker containers. Nomad will automatically run the containers on clients which have Docker installed, scale up and down based on the number of instances requested, and automatically recover from failures.

  • Operationally Simple: Nomad runs as a single binary that can be either a client or server, and is completely self contained. Nomad does not require any external services for storage or coordination. This means Nomad combines the features of a resource manager and scheduler in a single system.

  • Multi-Datacenter and Multi-Region Aware: Nomad is designed to be a global-scale scheduler. Multiple datacenters can be managed as part of a larger region, and jobs can be scheduled across datacenters if requested. Multiple regions join together and federate jobs making it easy to run jobs anywhere.

  • Flexible Workloads: Nomad has extensible support for task drivers, allowing it to run containerized, virtualized, and standalone applications. Users can easily start Docker containers, VMs, or application runtimes like Java. Nomad supports Linux, Windows, BSD, and OSX, providing the flexibility to run any workload.

  • Built for Scale: Nomad was designed from the ground up to support global scale infrastructure. Nomad is distributed and highly available, using both leader election and state replication to provide availability in the face of failures. Nomad is optimistically concurrent, enabling all servers to participate in scheduling decisions which increases the total throughput and reduces latency to support demanding workloads. Nomad has been proven to scale to cluster sizes that exceed 10k nodes in real-world production environments.

  • HashiCorp Ecosystem: HashiCorp Ecosystem: Nomad integrates with the entire HashiCorp ecosystem of tools. Like all HashiCorp tools, Nomad follows the UNIX design philosophy of doing something specific and doing it well. Nomad integrates with Terraform, Consul, and Vault for provisioning, service discovery, and secrets management.

For more information, see the introduction section of the Nomad website.

Getting Started & Documentation

All documentation is available on the Nomad website.

Developing Nomad

If you wish to work on Nomad itself or any of its built-in systems, you will first need Go installed on your machine (version 1.10.2+ is required).

Developing with Vagrant There is an included Vagrantfile that can help bootstrap the process. The created virtual machine is based off of Ubuntu 16, and installs several of the base libraries that can be used by Nomad.

To use this virtual machine, checkout Nomad and run vagrant up from the root of the repository:

$ git clone https://github.com/hashicorp/nomad.git
$ cd nomad
$ vagrant up

The virtual machine will launch, and a provisioning script will install the needed dependencies.

Developing locally For local dev first make sure Go is properly installed, including setting up a GOPATH. After setting up Go, clone this repository into $GOPATH/src/github.com/hashicorp/nomad. Then you can download the required build tools such as vet, cover, godep etc by bootstrapping your environment.

$ make bootstrap
...

Afterwards type make test. This will run the tests. If this exits with exit status 0, then everything is working!

$ make test
...

To compile a development version of Nomad, run make dev. This will put the Nomad binary in the bin and $GOPATH/bin folders:

$ make dev

Optionally run Consul to enable service discovery and health checks:

$ sudo consul agent -dev

And finally start the nomad agent:

$ sudo bin/nomad agent -dev

If the Nomad UI is desired in the development version, run make dev-ui. This will build the UI from source and compile it into the dev binary.

$ make dev-ui
...
$ bin/nomad
...

To compile protobuf files, installing protoc is required: See
https://github.com/google/protobuf for more information.

Note: Building the Nomad UI from source requires Node, Yarn, and Ember CLI. These tools are already in the Vagrant VM. Read the UI README for more info.

To cross-compile Nomad, run make release. This will compile Nomad for multiple platforms and place the resulting binaries into the ./pkg directory:

$ make release
...
$ ls ./pkg
...