9d85195361
* Fix links to ACL guides * Managing Nomad guide links; links in jsx pages * job updates guide URLS * node-drain guide URLS * outage recovery guide links * fix guide links - sentinel * fix guide links - namespaces * fix guide links - quotas * fix guide links - autopilot * more guide links. * more guide links - continued. * Updating redirects for learn * Getting Started * Load Balancing Guides * update redirects for ui guide * Consolidate spark redirects to point to GH repo * operating job update part 1 * finish operating job links; operations guides links. * finish guide redirects * coalesce EOL redirects for spark guides. * one last link * Checked links and found a few more stray links * Found more .htmls * Fixup links for new HC websites * Post-merge fixups * linkcheck caught missing ids
106 lines
3.1 KiB
Plaintext
106 lines
3.1 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Installing Nomad for QuickStart
|
|
sidebar_title: Quickstart
|
|
description: Learn how to install Nomad locally or in a sandbox.
|
|
---
|
|
|
|
# Quickstart
|
|
|
|
This page lists multiple methods to installing Nomad locally or in a sandbox
|
|
environment.
|
|
|
|
These installations are designed to get you started with Nomad easily and should
|
|
be used only for experimentation purposes. If you are looking to install Nomad
|
|
in production, please refer to our [Production Installation](/docs/install/production) guide here.
|
|
|
|
<Tabs>
|
|
<Tab heading="Interactive Online Environment">
|
|
|
|
Experiment with Nomad in your browser via the Katacoda interactive learning platform.
|
|
|
|
- [Introduction to Nomad](https://www.katacoda.com/hashicorp/scenarios/nomad-introduction)
|
|
|
|
- [Nomad Playground](https://katacoda.com/hashicorp/scenarios/playground)
|
|
|
|
</Tab>
|
|
<Tab heading="Create a Cloud Lab">
|
|
|
|
Install Nomad on the public cloud.
|
|
|
|
- AWS
|
|
|
|
- [CloudFormation](https://aws.amazon.com/quickstart/architecture/nomad/)
|
|
|
|
- [Terraform](https://github.com/hashicorp/nomad/blob/master/terraform/aws/README.md)
|
|
|
|
- Azure
|
|
|
|
- [Terraform](https://github.com/hashicorp/nomad/tree/master/terraform/azure)
|
|
|
|
</Tab>
|
|
<Tab heading="Try it Locally">
|
|
|
|
## Install Nomad on your machine
|
|
|
|
If you would like to try Nomad locally, you can install Nomad on your local
|
|
machine using the same steps that you would for a production environments and
|
|
run a single-node development instance using the `nomad agent -dev` command
|
|
|
|
[Installing Nomad][installing-binary]
|
|
|
|
## Run Nomad in Vagrant
|
|
|
|
Alternatively, you can use a Vagrant to set up a development environment for Nomad.
|
|
Vagrant is a tool for building and managing virtual machine environments.
|
|
|
|
-> **Note**: To use the Vagrant environment, first install Vagrant following
|
|
these [instructions](https://www.vagrantup.com/docs/installation/). You will
|
|
also need a virtualization tool, such as [VirtualBox][].
|
|
|
|
You can download a Vagrantfile which will start a small Nomad cluster. First
|
|
create a new directory for your Vagrant environment.
|
|
|
|
```shell-session
|
|
$ mkdir nomad-vagrant
|
|
```
|
|
|
|
Change into the directory you made with the previous command.
|
|
|
|
```shell-session
|
|
$ cd nomad-vagrant
|
|
```
|
|
|
|
Now you can get the Nomad installation configuration.
|
|
|
|
```shell-session
|
|
$ curl -O https://raw.githubusercontent.com/hashicorp/nomad/master/demo/vagrant/Vagrantfile
|
|
```
|
|
|
|
Now that you have created a new directory and downloaded the `Vagrantfile`
|
|
you must create the virtual machine with the `vagrant up` command.
|
|
|
|
```shell-session
|
|
$ vagrant up
|
|
```
|
|
|
|
This will take a few minutes as the base Ubuntu box must be downloaded
|
|
and provisioned with both Docker and Nomad. Once this completes, you should
|
|
see this output.
|
|
|
|
```plaintext
|
|
Bringing machine 'default' up with 'virtualbox' provider...
|
|
==> default: Importing base box 'bento/ubuntu-18.04'...
|
|
...
|
|
==> default: Running provisioner: docker...
|
|
```
|
|
|
|
At this point the Vagrant box is running and ready to go.
|
|
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
[installing-binary]: /docs/install#precompiled-binaries
|
|
[vagrant-environment]: https://learn.hashicorp.com/tutorials/nomad/get-started-install#vagrant-setup-optional
|
|
[virtualbox]: https://www.virtualbox.org/
|