To run a production Nomad cluster, you need to deploy a small number of server nodes (typically 3), which are responsible
for being part of the consensus protocol, and a larger
number of client nodes, which are used for running jobs. You must also have a Consul cluster
deployed (see the Consul AWS Module) in one of the following
configurations:
Deploy a standalone Consul cluster by following the instructions in the Consul AWS
Module.
Use the scripts from the install-nomad module in a Packer template to create a Nomad AMI.
Deploy a small number of server nodes (typically, 3) using the nomad-cluster module. Execute the
run-nomad script on each node during boot, setting the --server flag. You will
need to configure each node with the connection details for your standalone Consul cluster.
Deploy as many client nodes as you need using the nomad-cluster module. Execute the
run-nomad script on each node during boot, setting the --client flag.
{"treedata":{"name":"root","toggled":true,"children":[{"name":".circleci","children":[{"name":"config.yml","path":".circleci/config.yml","sha":"20968ed882b09a03245770f84b523b73cd64df78"}]},{"name":".gitignore","path":".gitignore","sha":"6c4ebe4426586b7febbaba178294ef59b8272c05"},{"name":"CODEOWNERS","path":"CODEOWNERS","sha":"5949dbc0fa6d4dd6610575e3c878c353d92da44a"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","sha":"4c6520097a38c2b63e7a91e20a4c06f8005e6fe4"},{"name":"LICENSE","path":"LICENSE","sha":"7a4a3ea2424c09fbe48d455aed1eaa94d9124835"},{"name":"NOTICE","path":"NOTICE","sha":"4653ef2dace926e046f74ab82c82647558c7e94f"},{"name":"README.md","path":"README.md","sha":"48583f19e9257d330a8d9e6f041b101932490d56"},{"name":"_ci","children":[{"name":"publish-amis-in-new-account.md","path":"_ci/publish-amis-in-new-account.md","sha":"3182a0a90775f7bb9622c037196ac2a1f15e455d"},{"name":"publish-amis.sh","path":"_ci/publish-amis.sh","sha":"6902cb1e3d7624ecc91096bcd48c5c91e248c653"}]},{"name":"_docs","children":[{"name":"amazon-linux-ami-list.md","path":"_docs/amazon-linux-ami-list.md","sha":"6607a70497e27d57222552281825053783ad7bb2"},{"name":"architecture-nomad-consul-colocated.png","path":"_docs/architecture-nomad-consul-colocated.png","sha":"438a8b71d1afdc7f91065b910e9de2d6d7d9517c"},{"name":"architecture-nomad-consul-separate.png","path":"_docs/architecture-nomad-consul-separate.png","sha":"df28d183fb8090fabc457ee56f3fb43ded6a5b13"},{"name":"architecture.png","path":"_docs/architecture.png","sha":"e539a77e88af6849d0893be35a8c5b5270edb195"},{"name":"nomad-icon.png","path":"_docs/nomad-icon.png","sha":"193298e1f719d6fb51513d0d9631dafaa17cfaf3"},{"name":"ubuntu16-ami-list.md","path":"_docs/ubuntu16-ami-list.md","sha":"4c1af1d6d863e0e6120520b65d823ee2ae2e2079"}]},{"name":"core-concepts.md","path":"core-concepts.md","sha":"314e6e4769a0316adbce0ff39196f1821544c9ce","toggled":true},{"name":"examples","children":[{"name":"nomad-consul-ami","children":[{"name":"README.md","path":"examples/nomad-consul-ami/README.md","sha":"3e1ffc13902ee7ff46ef750a1e03d316ff4afedf"},{"name":"nomad-consul-docker.json","path":"examples/nomad-consul-ami/nomad-consul-docker.json","sha":"89df67eabeeb9e07f039dbe085e1932f592992d3"},{"name":"nomad-consul.json","path":"examples/nomad-consul-ami/nomad-consul.json","sha":"58a462d3443bf5f067f24f438919aab6c696b715"},{"name":"setup_amazon-linux.sh","path":"examples/nomad-consul-ami/setup_amazon-linux.sh","sha":"afa4e86365348ab91616f08d3fae0a28c64e158f"},{"name":"setup_nomad_consul.sh","path":"examples/nomad-consul-ami/setup_nomad_consul.sh","sha":"c4e68a5affa34caab8e4197028dfc1970c33da6e"},{"name":"setup_ubuntu.sh","path":"examples/nomad-consul-ami/setup_ubuntu.sh","sha":"81268f86b1ccf5a567ec913dd1dbbe3b3868ad93"}]},{"name":"nomad-consul-separate-cluster","children":[{"name":"README.md","path":"examples/nomad-consul-separate-cluster/README.md","sha":"4f8ee73c20f575cb86ed28fb05840d093e6f2f15"},{"name":"main.tf","path":"examples/nomad-consul-separate-cluster/main.tf","sha":"c29c23f9c54e171826309ed3f00a13552b3c6147"},{"name":"outputs.tf","path":"examples/nomad-consul-separate-cluster/outputs.tf","sha":"fab958b55d52594d98df8391c4282e5c4c1f008a"},{"name":"user-data-consul-server.sh","path":"examples/nomad-consul-separate-cluster/user-data-consul-server.sh","sha":"659e77d66aa4140f776cfbeb9e71f1a874b00682"},{"name":"user-data-nomad-client.sh","path":"examples/nomad-consul-separate-cluster/user-data-nomad-client.sh","sha":"c52069299ee4fe73fbd9cd5d4f48be8ef6a35b3d"},{"name":"user-data-nomad-server.sh","path":"examples/nomad-consul-separate-cluster/user-data-nomad-server.sh","sha":"1b99ff7d6b56999da42c04d5405e81c738214af1"},{"name":"variables.tf","path":"examples/nomad-consul-separate-cluster/variables.tf","sha":"78d0882b72b80b9b8eea67d4950e15b826647e1d"}]},{"name":"nomad-examples-helper","children":[{"name":"README.md","path":"examples/nomad-examples-helper/README.md","sha":"4b42111e7abf289798df0c62847edc722bcd6256"},{"name":"example.nomad","path":"examples/nomad-examples-helper/example.nomad","sha":"63958e3d491757da48a72255ec3b8882302ba33e"},{"name":"nomad-examples-helper.sh","path":"examples/nomad-examples-helper/nomad-examples-helper.sh","sha":"7f5f10afb2331d88268d53fe7e7d8deb0585a8db"}]},{"name":"root-example","children":[{"name":"README.md","path":"examples/root-example/README.md","sha":"9c2e4ffd4e0ffcf6e4d4a6d31583205251a6c67d"},{"name":"user-data-client.sh","path":"examples/root-example/user-data-client.sh","sha":"d6bac10fb2bb654d3255052d863ab19c9cdd41bc"},{"name":"user-data-server.sh","path":"examples/root-example/user-data-server.sh","sha":"109bdeb1f8df56b35d6bf1a6e5346cae4aca61f5"}]}]},{"name":"main.tf","path":"main.tf","sha":"5b21e3855375c578f5946961181efd25ad8426bc"},{"name":"modules","children":[{"name":"install-nomad","children":[{"name":"README.md","path":"modules/install-nomad/README.md","sha":"f793a3975dc6d8a06873a7f6a8ef1892eba01d84"},{"name":"install-nomad","path":"modules/install-nomad/install-nomad","sha":"5a74c98520010121d95d3432f08dffced7c2f761"},{"name":"supervisor-initd-script.sh","path":"modules/install-nomad/supervisor-initd-script.sh","sha":"171b91613e98ab2bd10282025caff1707918c95a"},{"name":"supervisord.conf","path":"modules/install-nomad/supervisord.conf","sha":"d96beb0ca9a16279ed1bdf74cbb6516275d85085"}]},{"name":"nomad-cluster","children":[{"name":"README.md","path":"modules/nomad-cluster/README.md","sha":"e47de8d5174ca6020601898c386a8de2e06f021d"},{"name":"main.tf","path":"modules/nomad-cluster/main.tf","sha":"e46194c1170b25016dd4ed1dfb068af1583d47a6"},{"name":"outputs.tf","path":"modules/nomad-cluster/outputs.tf","sha":"341778300126873e11e2cf9d964bccd927c2644e"},{"name":"variables.tf","path":"modules/nomad-cluster/variables.tf","sha":"b0293a8dc30f988ca63af42e06e7a7cefaabde91"}]},{"name":"nomad-security-group-rules","children":[{"name":"README.md","path":"modules/nomad-security-group-rules/README.md","sha":"c35eab862bdd870569408a9ad55e8abb6894e4fe"},{"name":"main.tf","path":"modules/nomad-security-group-rules/main.tf","sha":"51438a98f6defe8045c21437e4b1d95b3f42061c"},{"name":"variables.tf","path":"modules/nomad-security-group-rules/variables.tf","sha":"a3d9d4b0b2abcce058d41b61b099fa115a7babd3"}]},{"name":"run-nomad","children":[{"name":"README.md","path":"modules/run-nomad/README.md","sha":"c66430e400076f3afbbfa9ff55abcc2aec7564f2"},{"name":"run-nomad","path":"modules/run-nomad/run-nomad","sha":"0216b1713f86310fa21fba9d4feacbffc45c9067"}]}]},{"name":"outputs.tf","path":"outputs.tf","sha":"f3efe59a6784255e79e0a7a77cf4b4ce2461278f"},{"name":"test","children":[{"name":"Gopkg.lock","path":"test/Gopkg.lock","sha":"fc3214f34d7c2f6d5d1c1ab6f9ecf1a85bfb06f8"},{"name":"Gopkg.toml","path":"test/Gopkg.toml","sha":"a84c6ed7e5bfce6f72e9e08666f1665af01a3f84"},{"name":"README.md","path":"test/README.md","sha":"874818e6da7a9c0c9338edde0c27fa3f8a3b3d05"},{"name":"aws_helpers.go","path":"test/aws_helpers.go","sha":"c7b6601bf58485e5deddbb1e17f433b0c12c9dae"},{"name":"nomad_consul_cluster_colocated_test.go","path":"test/nomad_consul_cluster_colocated_test.go","sha":"365b422c08e52295c1ff0bb211df4d5c973766a9"},{"name":"nomad_consul_cluster_separate_test.go","path":"test/nomad_consul_cluster_separate_test.go","sha":"0750f6f9bc45a650355e0d3c2557abae45ac7e73"},{"name":"nomad_helpers.go","path":"test/nomad_helpers.go","sha":"1750e3d729d429c9062fde804f4a66a0d514d22d"},{"name":"terratest_helpers.go","path":"test/terratest_helpers.go","sha":"f6e176e37bc9ce4c5322834a0325bc9ff1b836b4"}]},{"name":"variables.tf","path":"variables.tf","sha":"0941f7c8577a1db5d7fdafbd274deb87813c0ca9"}]},"detailsContent":"<h1 class=\"preview__body--title\" id=\"background\">Background</h1><div class=\"preview__body--border\"></div><p>To run a production Nomad cluster, you need to deploy a small number of server nodes (typically 3), which are responsible\nfor being part of the <a href=\"https://www.nomadproject.io/docs/internals/consensus.html\" class=\"preview__body--description--blue\" target=\"_blank\">consensus protocol</a>, and a larger\nnumber of client nodes, which are used for running jobs. You must also have a <a href=\"https://www.consul.io/\" class=\"preview__body--description--blue\" target=\"_blank\">Consul</a> cluster\ndeployed (see the <a href=\"/repos/terraform-aws-consul\" class=\"preview__body--description--blue\">Consul AWS Module</a>) in one of the following\nconfigurations:</p>\n<ol>\n<li><a href=\"#deploy-nomad-and-consul-in-the-same-cluster\" class=\"preview__body--description--blue\">Deploy Nomad and Consul in the same cluster</a></li>\n<li><a href=\"#deploy-nomad-and-consul-in-separate-clusters\" class=\"preview__body--description--blue\">Deploy Nomad and Consul in separate clusters</a></li>\n</ol>\n<h2 class=\"preview__body--subtitle\" id=\"deploy-nomad-and-consul-in-the-same-cluster\">Deploy Nomad and Consul in the same cluster</h2>\n<ol>\n<li>\n<p>Use the <a href=\"/repos/terraform-aws-consul/modules/install-consul\" class=\"preview__body--description--blue\">install-consul\nmodule</a> from the Consul AWS\nModule and the <a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/install-nomad\" class=\"preview__body--description--blue\">install-nomad module</a> from this Module in a Packer template to create\nan AMI with Consul and Nomad.</p>\n<p>If you are just experimenting with this Module, you may find it more convenient to use one of our official public AMIs:</p>\n<ul>\n<li><a href=\"/repos/v0.6.0/terraform-aws-nomad/_docs/ubuntu16-ami-list.md\" class=\"preview__body--description--blue\">Latest Ubuntu 16 AMIs</a>.</li>\n<li><a href=\"/repos/v0.6.0/terraform-aws-nomad/_docs/amazon-linux-ami-list.md\" class=\"preview__body--description--blue\">Latest Amazon Linux AMIs</a>.</li>\n</ul>\n<p><strong>WARNING! Do NOT use these AMIs in your production setup. In production, you should build your own AMIs in your own\nAWS account.</strong></p>\n</li>\n<li>\n<p>Deploy a small number of server nodes (typically, 3) using the <a href=\"/repos/terraform-aws-consul/modules/consul-cluster\" class=\"preview__body--description--blue\">consul-cluster\nmodule</a>. Execute the\n<a href=\"/repos/terraform-aws-consul/modules/run-consul\" class=\"preview__body--description--blue\">run-consul script</a> and the\n<a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/run-nomad\" class=\"preview__body--description--blue\">run-nomad script</a> on each node during boot, setting the <code>--server</code> flag in both\nscripts.</p>\n</li>\n<li>\n<p>Deploy as many client nodes as you need using the <a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/nomad-cluster\" class=\"preview__body--description--blue\">nomad-cluster module</a>. Execute the\n<a href=\"/repos/terraform-aws-consul/modules/run-consul\" class=\"preview__body--description--blue\">run-consul script</a> and the\n<a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/run-nomad\" class=\"preview__body--description--blue\">run-nomad script</a> on each node during boot, setting the <code>--client</code> flag in both\nscripts.</p>\n</li>\n</ol>\n<p>Check out the <a href=\"/repos/v0.6.0/terraform-aws-nomad/examples/root-example\" class=\"preview__body--description--blue\">nomad-consul-colocated-cluster example</a> for working\t\nsample code.</p>\n<h2 class=\"preview__body--subtitle\" id=\"deploy-nomad-and-consul-in-separate-clusters\">Deploy Nomad and Consul in separate clusters</h2>\n<ol>\n<li>Deploy a standalone Consul cluster by following the instructions in the <a href=\"/repos/terraform-aws-consul\" class=\"preview__body--description--blue\">Consul AWS\nModule</a>.</li>\n<li>Use the scripts from the <a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/install-nomad\" class=\"preview__body--description--blue\">install-nomad module</a> in a Packer template to create a Nomad AMI.</li>\n<li>Deploy a small number of server nodes (typically, 3) using the <a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/nomad-cluster\" class=\"preview__body--description--blue\">nomad-cluster module</a>. Execute the\n<a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/run-nomad\" class=\"preview__body--description--blue\">run-nomad script</a> on each node during boot, setting the <code>--server</code> flag. You will\nneed to configure each node with the connection details for your standalone Consul cluster.</li>\n<li>Deploy as many client nodes as you need using the <a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/nomad-cluster\" class=\"preview__body--description--blue\">nomad-cluster module</a>. Execute the\t\n<a href=\"/repos/v0.6.0/terraform-aws-nomad/modules/run-nomad\" class=\"preview__body--description--blue\">run-nomad script</a> on each node during boot, setting the <code>--client</code> flag.</li>\n</ol>\n<p>Check out the <a href=\"/repos/v0.6.0/terraform-aws-nomad/examples/nomad-consul-separate-cluster\" class=\"preview__body--description--blue\">nomad-consul-separate-cluster example</a> for working sample code.</p>\n","repoName":"terraform-aws-nomad","repoRef":"v0.5.1","serviceDescriptor":{"serviceName":"HashiCorp Nomad","serviceRepoName":"terraform-aws-nomad","serviceRepoOrg":"hashicorp","cloudProviders":["aws"],"description":"Deploy a Nomad cluster. Supports automatic bootstrapping, discovery of Consul servers, automatic recovery of failed servers.","imageUrl":"nomad.png","licenseType":"open-source","technologies":["Terraform","Bash"],"compliance":[],"tags":[""]},"serviceCategoryName":"Docker orchestration","fileName":"core-concepts.md","filePath":"/core-concepts.md","title":"Repo Browser: HashiCorp Nomad","description":"Browse the repos in the Gruntwork Infrastructure as Code Library."}
.circleci
.gitignore
