nomad 0,4,9,0,4,3,0,4 travis-ci vagrant

A Distributed, Highly Available, Datacenter-Aware Scheduler

Star Fork Watch Issue Download
1 month after MPL-2.0
go get github.com/hashicorp/nomad/api
go get github.com/hashicorp/nomad
go get github.com/hashicorp/nomad/nomad/structs
go get github.com/hashicorp/nomad/command
go get github.com/hashicorp/nomad/command/agent
go get github.com/hashicorp/nomad/nomad
go get github.com/hashicorp/nomad/client/allocdir
go get github.com/hashicorp/nomad/jobspec
go get github.com/hashicorp/nomad/client/config
go get github.com/hashicorp/nomad/scheduler
go get github.com/hashicorp/nomad/client/driver
go get github.com/hashicorp/nomad/client/fingerprint
go get github.com/hashicorp/nomad/nomad/watch
go get github.com/hashicorp/nomad/client/driver/structs
go get github.com/hashicorp/nomad/nomad/state
go get github.com/hashicorp/nomad/client
go get github.com/hashicorp/nomad/client/getter
go get github.com/hashicorp/nomad/client/driver/env
go get github.com/hashicorp/nomad/command/agent/consul
go get github.com/hashicorp/nomad/command/agent/consul
go get github.com/hashicorp/nomad/client/stats
go get github.com/hashicorp/nomad/helper/discover
go get github.com/hashicorp/nomad/helper/flag-slice
go get github.com/hashicorp/nomad/helper/gated-writer
go get github.com/hashicorp/nomad/client/structs
go get github.com/hashicorp/nomad/nomad/structs/config
go get github.com/hashicorp/nomad/nomad/types
go get github.com/hashicorp/nomad/client/driver/executor
go get github.com/hashicorp/nomad/client/driver/logging
go get github.com/hashicorp/nomad/helper/stats
go get github.com/hashicorp/nomad/helper/args
go get github.com/hashicorp/nomad/helper/fields
go get github.com/hashicorp/nomad/helper/flatmap

Nomad Build Status 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.

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

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

  • Distributed and Highly-Available: Nomad servers cluster together and perform leader election and state replication to provide high availability in the face of failure. The Nomad scheduling engine is optimized for optimistic concurrency allowing all servers to make scheduling decisions to maximize throughput.

  • HashiCorp Ecosystem: Nomad integrates with the entire HashiCorp ecosystem of tools. Along with all HashiCorp tools, Nomad is designed in the unix philosophy of doing something specific and doing it well. Nomad integrates with tools like Packer, Consul, and Terraform to support building artifacts, service discovery, monitoring and capacity 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.8+ 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 14, 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
...
$ bin/nomad
...

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

$ make bin
...
$ ls ./pkg
...

Related Repositories

nomad-ui

nomad-ui

A user interface for the HashiCorp Nomad scheduler ...

nomad-ci

nomad-ci

A fully featured CI setup based on Nomad, Jenkins, Selenium, Consul and Docker ...

nomad-intro

nomad-intro

Introduction to Hashicorp Nomad ...

chef-nomad

chef-nomad

chef cookbook for managing hashicorp's nomad scheduler ...

nomad-docker-wrapper

nomad-docker-wrapper

A hack to allow Docker bind mounts in Nomad ...


Top Contributors

dadgar diptanu armon sean- cbednarski ryanuber catsby achanda nak3 sethvargo charlieok schmichael captainill ChrisHines grubernaut mitchellh a86c6f7964 dimfeld pearkes mlafeldt vishalnayak pshima carlosdp ChrisAubuchon kaskavalci mwieczorek ErikEvenson capone212 jefferai parasyte

Releases

-   v0.4.1 zip tar
-   v0.4.1-rc1 zip tar
-   v0.4.0 zip tar
-   v0.4.0-rc2 zip tar
-   v0.4.0-rc1 zip tar
-   v0.3.2 zip tar
-   v0.3.2-rc2 zip tar
-   v0.3.2-rc1 zip tar
-   v0.3.1 zip tar
-   v0.3.0 zip tar
-   v0.3.0-rc2 zip tar
-   v0.3rc1 zip tar
-   v0.2.3 zip tar
-   v0.2.3-rc1 zip tar
-   v0.2.2 zip tar
-   v0.2.1 zip tar
-   v0.2.0 zip tar
-   v0.1.2 zip tar
-   v0.1.1 zip tar
-   v0.1.0 zip tar
-   v0.0.0 zip tar
-   show zip tar