luxolus/open-nomad
2
0
Fork 0
Code Issues 1 Pull requests Packages Releases Wiki Activity
open-nomad/website/source/guides/install/index.html.md
Yishan Lin 968e67547a Revised NomadProject Structure 
- Revised "What is Nomad" copy
- Added "Key Features" section with links to task drivers & device plugins with lift-and-shift from README
- Added "Who Uses Nomad" section with users, talks, blog posts
- Removed Hadoop YARN, Docker Swarm, HTCondor from comparisons
- Revamped Guides section
- Inserted "Installing Nomad", "Upgrading", "Integrations" as persistent in Guides navbar
- Split Installing Nomad into two paths for users (one for Sandbox with "Quickstart", one for Production)
- Surfaced "Upgrading" and "Integrations" section from documentation
- Changed "Job Lifecycle" section into "Deploying & Managing Applications"
- Reworked "Operations" into "Operating Nomad"
- Reworked "Security" into "Securing Nomad"
- Segmented Namespaces, Resource Quotas, Sentinel into "Governance & Policy" subsection
- Reworked "Spark integration" into its own "Analytical Workloads" section
2019-05-08 14:40:38 -07:00

2.3 KiB
Raw Blame History

layout page_title sidebar_current description
guides Installing Nomad guides-install Learn how to install Nomad.

Installing Nomad

Installing Nomad is simple. There are two approaches to installing Nomad:

  1. Using a precompiled binary
  2. Installing from source

Downloading a precompiled binary is easiest, and we provide downloads over TLS along with SHA-256 sums to verify the binary.

Precompiled Binaries

To install the precompiled binary, download the appropriate package for your system. Nomad is currently packaged as a zip file. We do not have any near term plans to provide system packages.

Once the zip is downloaded, unzip it into any directory. The nomad (or nomad.exe for Windows) binary inside is all that is necessary to run Nomad. Any additional files, if any, are not required to run Nomad.

Copy the binary to anywhere on your system. If you intend to access it from the command-line, make sure to place it somewhere on your PATH.

Compiling from Source

To compile from source, you will need Go installed and configured properly (including a GOPATH environment variable set), as well as a copy of git in your PATH.

  1. Clone the Nomad repository from GitHub into your GOPATH:
```shell
$ mkdir -p $GOPATH/src/github.com/hashicorp && cd $_
$ git clone https://github.com/hashicorp/nomad.git
$ cd nomad
```
  1. Bootstrap the project. This will download and compile libraries and tools needed to compile Nomad:
```shell
$ make bootstrap
```
  1. Build Nomad for your current system and put the binary in ./bin/ (relative to the git checkout). The make dev target is just a shortcut that builds nomad for only your local build environment (no cross-compiled targets).
```shell
$ make dev
```

Verifying the Installation

To verify Nomad is properly installed, run nomad -v on your system. You should see help output. If you are executing it from the command line, make sure it is on your PATH or you may get an error about nomad not being found.

$ nomad -v