open-nomad/dist/README.md

45 lines
1.3 KiB
Markdown

# Dist
The `dist` folder contains sample configs for various platforms.
## Conventions
On unixes we will place agent configs under `/etc/nomad.d` and store
data under `/var/lib/nomad/`. You will need to create both of these
directories. We assume that `nomad` is installed to
`/usr/local/bin/nomad`.
## Agent Configs
The following example configuration files are provided:
- `server.hcl`
- `client.hcl`
Place one of these under `/etc/nomad.d` depending on the node's
role. You should use `server.hcl` to configure a node as a server
(which is responsible for scheduling) or `client.hcl` to configure a
node as a client (which is responsible for running workloads).
Read <https://nomadproject.io/docs/agent/configuration/index.html> to
learn which options are available and how to configure them.
## Systemd
On systems using systemd the basic systemd unit file under
`systemd/nomad.service` starts and stops the nomad agent. Place it
under `/etc/systemd/system/nomad.service`.
You can control Nomad with `systemctl start|stop|restart nomad`.
The `system/nomad.service` unit file is compatible with systemd v230
or higher.
## Upstart
On systems using upstart the basic upstart file under
`upstart/nomad.conf` starts and stops the nomad agent. Place it under
`/etc/init/nomad.conf`.
You can control Nomad with `start|stop|restart nomad`.