Find a file
Alex Dadgar f5d91b5338 Benchmark for rotator
BenchmarkRotator/1KB-8            200000              5572 ns/op
BenchmarkRotator/2KB-8            200000              8338 ns/op
BenchmarkRotator/4KB-8            100000             14246 ns/op
BenchmarkRotator/8KB-8             50000             25279 ns/op
BenchmarkRotator/16KB-8            30000             48602 ns/op
BenchmarkRotator/32KB-8            20000             92159 ns/op
BenchmarkRotator/64KB-8            10000            154766 ns/op
BenchmarkRotator/128KB-8            5000            296872 ns/op
BenchmarkRotator/256KB-8            3000            551793 ns/op
2018-05-10 14:15:15 -07:00
acl fixup from code review 2017-10-17 17:34:06 -04:00
api Canary tags structs 2018-05-07 14:50:01 -05:00
client Benchmark for rotator 2018-05-10 14:15:15 -07:00
command Merge pull request #4259 from hashicorp/f-deployment-improvements 2018-05-08 16:37:10 -05:00
demo Merge pull request #4164 from PeterDaveHello/update-demo-vagrantfile 2018-04-20 13:59:01 -07:00
dev dev helper for three node server cluster 2018-04-12 16:24:25 -07:00
dist Lots of fixes from @sethvargo 2017-08-01 15:40:36 -07:00
e2e Update end to end tests to use shorter progress deadlines 2018-05-07 14:55:01 -05:00
helper Fix the CPU Information error message 2018-05-08 14:11:29 -04:00
integrations spelling: registrations 2018-03-11 18:40:53 +00:00
jobspec Canary tags structs 2018-05-07 14:50:01 -05:00
lib Move delayheap to lib package 2018-03-14 16:10:32 -05:00
nomad newlines in test 2018-05-07 14:55:01 -05:00
scheduler Add test 2018-05-07 14:55:01 -05:00
scripts Bump versions 2018-04-13 16:16:16 -07:00
terraform bump Nomad to 0.8.1, Hadoop to 2.7.6 2018-04-18 22:33:58 +00:00
testutil test: build with mock_driver by default 2018-04-18 14:45:33 -07:00
ui Merge pull request #4201 from hashicorp/f-ui-fuzzy-job-search 2018-05-05 09:56:15 -07:00
vendor Merge pull request #4259 from hashicorp/f-deployment-improvements 2018-05-08 16:37:10 -05:00
version version bump and remove generated 2018-04-27 11:10:00 -07:00
website change default to 10m and docs 2018-05-07 14:50:01 -05:00
.gitattributes Remove invalid gitattributes 2018-02-14 14:47:43 -08:00
.gitignore ignore tags 2018-04-26 16:35:13 -07:00
.travis.yml travis: use go 1.10.x 2018-03-22 09:53:16 -07:00
appveyor.yml test: build with mock_driver by default 2018-04-18 14:45:33 -07:00
build_linux_arm.go Fix 32bit arm build 2017-02-09 11:22:17 -08:00
CHANGELOG.md update CHANGELOG 2018-05-08 17:07:10 -05:00
GNUmakefile Travis tests binary built with generated files 2018-04-26 15:24:53 -07:00
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md 2016-03-21 18:12:50 -07:00
LICENSE Initial commit 2015-06-01 12:21:00 +02:00
main.go cli: differentiate normal output vs info 2018-03-30 11:42:11 -07:00
main_test.go Adding initial skeleton 2015-06-01 13:46:21 +02:00
README.md Oxford comma-ing 2018-03-06 16:48:54 -08:00
Vagrantfile Improve CPU core detection in Vagrantfile 2018-04-16 15:11:20 +08:00

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.9+ 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
...

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
...