Learn how to express task dependencies in Nomad jobs.
Install and run Nomad. Schedule jobs and explore the web UI.
This track will provide a quick survey of the Nomad web user interface and how to perform common operations with it. Get started here.
3 minLearn how to access the Nomad Web UI from a browser or from the CLI.
9 minLearn how to operate a job from the Web UI.
7 minLearn how to inspect the state of the cluster from the Web UI.
9 minLearn how to submit a job from the Web UI.
3 minConsiderations for your exploration and organizational deployment of the Nomad UI.
This track provides foundational knowledge for expressing your workload as Nomad jobs. This track also discusses how to submit, inspect, and monitor a running Nomad job.
4 minLearn how to deploy and manage a Nomad Job.
6 minMost applications require some kind of configuration. Whether the configuration is provided via the command line, environment variables, or a configuration file, Nomad has built-in functionality for configuration. This section details three common patterns for configuring tasks.
7 minThe job file is the unit of work in Nomad. Upon authoring, the job file is submitted to the server for evaluation and scheduling. This section discusses some techniques for submitting jobs.
8 minNomad exposes a number of tools and techniques for inspecting a running job. This is helpful in ensuring the job started successfully. Additionally, it can output any errors that occurred while starting the job.
6 minNomad provides a top-level mechanism for viewing application logs and data files via the command line interface. This section discusses the nomad alloc logs command and API interface.
5 minNomad supports reporting detailed job statistics and resource utilization metrics for most task drivers. This section describes the ways to inspect a job's resource consumption and utilization.
3 minLearn how to access the Nomad Web UI from a browser or from the CLI.
9 minLearn how to operate a job from the Web UI.
7 minLearn how to inspect the state of the cluster from the Web UI.
9 minLearn how to submit a job from the Web UI.
3 minConsiderations for your exploration and organizational deployment of the Nomad UI.
4 minLearn how to deploy and manage a Nomad Job.
6 minMost applications require some kind of configuration. Whether the configuration is provided via the command line, environment variables, or a configuration file, Nomad has built-in functionality for configuration. This section details three common patterns for configuring tasks.
7 minThe job file is the unit of work in Nomad. Upon authoring, the job file is submitted to the server for evaluation and scheduling. This section discusses some techniques for submitting jobs.
8 minNomad exposes a number of tools and techniques for inspecting a running job. This is helpful in ensuring the job started successfully. Additionally, it can output any errors that occurred while starting the job.
6 minNomad provides a top-level mechanism for viewing application logs and data files via the command line interface. This section discusses the nomad alloc logs command and API interface.
5 minNomad supports reporting detailed job statistics and resource utilization metrics for most task drivers. This section describes the ways to inspect a job's resource consumption and utilization.
Nomad provides configurable options to enable recovering failed tasks to avoid downtime. Nomad will try to restart a failed task on the node it is running on and also try to reschedule it on another node.
Nomad has built-in support for rolling, blue/green, and canary updates to simplify upgrades while minimizing or eliminating downtime.
3 minThis section describes common patterns for updating already-running jobs including rolling upgrades, blue/green deployments, and canary builds. Nomad provides built-in support for this functionality.
11 minNomad provides a built-in mechanism for rolling upgrades. Rolling upgrades incrementally transitions jobs between versions and using health check information to reduce downtime.
14 minNomad has built-in support for doing blue/green and canary deployments to more safely update existing applications and services.
4 minWell-behaved applications expose a way to perform cleanup prior to exiting. Nomad can optionally send a configurable signal to applications before killing them, allowing them to drain connections or gracefully terminate.
Nomad allows operators methods to express their placement preferences for job allocations within their cluster using affinities and spread. Nomad also helps to prevent priority inversion with preemption.
6 minLearn about advanced scheduling features including affinity and spread.
enterprise20 minLearn how to enabling and using preemption on service and batch jobs in Nomad Enterprise (0.9.3 and above).
20 minAffinities allows operators to express placement preferences for their jobs.
20 minBy using spread criteria in their job specification, Nomad job operators can ensure that failures across a physical domain such as datacenter or rack do not affect application availability.
This section covers features operators will need to understand to build and maintain Nomad clusters.
4 minLearn how to join nodes to create a Nomad cluster using Consul. You can manually join nodes. You can also automatically join nodes using cloud-provider metadata or Consul without operator involvement.
20 minFederation enables users to submit jobs or interact with the HTTP API targeting any region, from any server, even if that server resides in a different region.
12 minWorkload migration is a normal part of cluster operations for a variety of reasons: server maintenance, operating system upgrades, etc. Nomad offers a number of parameters for controlling how running jobs are migrated off of draining nodes.
10 minDon't panic! This is a critical first step. Depending on your deployment configuration, it may take only a single server failure for cluster unavailability. Recovery requires an operator to intervene, but recovery is straightforward.
25 minIt is possible to collect metrics on Nomad with Prometheus after enabling telemetry on Nomad servers and clients.
8 minThis guide covers how to configure and use Autopilot features.
Nomad has two primary types of traffic— UDP gossip and TCP API/RPC traffic. Learn how to configure Nomad to encrypt these protocols.
8 minNomad uses two different protocols for communication between cluster members. This guide introduces them and teaches you the appropriate security approach for each communication protocol.
10 minLearn how to encrypt Nomad's gossip protocol with a symmetric key. The gossip protocol is used to communicate membership and liveliness information between the servers.
45 minNomad uses mTLS to encrypt communication between Nomad cluster members. Learn how to configure Nomad for mTLS communication to increase network security between nodes.
Nomad provides capability-based access control. In this track explore Nomad access control objects, such as policies, rules, capabilities, and tokens; learn how to configure a Nomad cluster for ACLs; bootstrap the ACL system; submit your first policy; and grant a token based on it.
10 minIn this concept focused guide, you'll explore the three major components to the ACL system: capabilities, policies, and tokens.
5 minBefore using the Nomad ACL system, it must be enabled and bootstrapped. This guide explains the process.
20 minNomad provides an optional Access Control List (ACL) system which can be used to control access to data and APIs. The ACL system is capability-based, relying on tokens which are associated with policies to determine which fine grained rules can be applied.
30 minNomad uses tokens to authenticate requests to the cluster. Tokens map requests to ACL policies for Nomad to determine if a request is authorized.
20 minIn this guide, you will practice creating Nomad ACL policies to provide controlled access for two different personas to your Nomad Cluster.
45 minHashiCorp Vault has a secrets engine for generating short-lived Nomad tokens. This enables you to leverage Vault-supported authentication methods (token, LDAP, Okta, Amazon IAM, etc.) to obtain a short-lived Nomad token. This guide will demonstrate using Vault token to obtain a Nomad token
This track will explore techniques to run jobs on Nomad that require access to persistent storage.
3 minIt is possible to deploy and consume stateful workloads in Nomad. Nomad can integrate with various storage solutions such as Portworx and REX-Ray.
20 minThis guide walks you through configuring a host volume and then deploying a MySQL workload that uses it for persistent storage.
30 minThis guide walks you through deploying Container Storage Interface plugins, registering an AWS EBS volume with CSI, and then deploying a MySQL workload that uses it for persistent storage.
20 minYou will deploy a MySQL database which uses the Portworx Docker-volume driver to enable persistent volumes.
This track explores patterns for expressing task dependencies in Nomad jobs.
There are multiple approaches to load balancing within a Nomad cluster. Here we explore the most popular strategies.
20 minThere are a few approaches you can consider when deploying your load balancers for performance and HA
20 minFabio integrates natively with Consul and provides rich features with an optional Web UI.
20 minHAProxy natively integrates with service discovery data from Consul.
20 minNGINX pairs with Nomad's template stanza to allow for dynamic updates to its load balancing configuration.
20 minTraefik natively integrates with Consul using the Consul Catalog Provider.
Starting with Nomad 0.9, task and device drivers are now pluggable. This gives users the flexibility to introduce their own drivers by providing a binary rather than having to fork Nomad to make code changes to it. See the navigation menu on the left or the list below for guides on how to use some of the external drivers available for Nomad.
Learn the Nomad objects necessary to operate Nomad securely in a multi-team environment. Explore Nomad Enterprise features such as namespaces, resource quotas, and Sentinel.
enterprise3 minLearn the Nomad objects necessary to operate Nomad securely in a multi-team environment. Explore Nomad Enterprise features such as namespaces, resource quotas, and Sentinel.
enterprise8 minNomad Enterprise provides support for namespaces, which allow jobs and their associated objects to be segmented from each other and other users of the cluster.
enterprise8 minNomad Enterprise provides support for resource quotas, which allow operators to restrict the aggregate resource usage of namespaces.
enterprise8 minSentinel allows operators to express their policies as code, and have their policies automatically enforced.
Apache Spark is a popular data processing engine/framework that can use third-party schedulers. The Nomad ecosystem includes a fork of Apache Spark that natively integrates Nomad as a cluster manager and scheduler for Spark. Learn how to run Spark jobs in this environment.
5 minGet started with the Nomad-Spark integration.
5 minThe Nomad Spark integration uses a default job template when running Spark jobs in the cluster. Learn about the default job template and how to customize it.
4 minLearn how to configure resource allocation for your Spark applications.
3 minLearn how to dynamically scale Spark executors based the queue of pending tasks.
5 minLearn how to submit Spark jobs that run on a Nomad cluster.
From configuring Nomad to fetch Vault secrets for jobs to configuring Vault to provide Nomad secrets for operators, this track contains all of the guides with Nomad and Vault.
45 minHashiCorp Vault has a secrets engine for generating short-lived Nomad tokens. This enables you to leverage Vault-supported authentication methods (token, LDAP, Okta, Amazon IAM, etc.) to obtain a short-lived Nomad token. This guide will demonstrate using Vault token to obtain a Nomad token
30 minSecuring Nomad's cluster communication with TLS is important for both security and easing operations. Nomad can use mutual TLS (mTLS) for authenticating for all HTTP and RPC communication. This guide will leverage Vault's PKI secrets engine to accomplish this task.
20 minLearn how to deploy an application, PostgreSQL, in Nomad and retrieve dynamic credentials by integrating with Vault.
Deploy a production ready Nomad Enterprise cluster with the Reference Architecture and Deployment guide.
enterprise15 minThis reference architecture describes the recommended compute and networking resources you should provision when using Nomad Enterprise in a production environment.
enterprise12 minThis deployment guide covers the steps required to install and configure a single Nomad Enterprise cluster as defined in the Nomad Enterprise Reference Architecture.
3 minThis section describes common patterns for updating already-running jobs including rolling upgrades, blue/green deployments, and canary builds. Nomad provides built-in support for this functionality.
11 minNomad provides a built-in mechanism for rolling upgrades. Rolling upgrades incrementally transitions jobs between versions and using health check information to reduce downtime.
14 minNomad has built-in support for doing blue/green and canary deployments to more safely update existing applications and services.
4 minWell-behaved applications expose a way to perform cleanup prior to exiting. Nomad can optionally send a configurable signal to applications before killing them, allowing them to drain connections or gracefully terminate.
6 minLearn about advanced scheduling features including affinity and spread.
enterprise20 minLearn how to enabling and using preemption on service and batch jobs in Nomad Enterprise (0.9.3 and above).
20 minAffinities allows operators to express placement preferences for their jobs.
20 minBy using spread criteria in their job specification, Nomad job operators can ensure that failures across a physical domain such as datacenter or rack do not affect application availability.
4 minLearn how to join nodes to create a Nomad cluster using Consul. You can manually join nodes. You can also automatically join nodes using cloud-provider metadata or Consul without operator involvement.
20 minFederation enables users to submit jobs or interact with the HTTP API targeting any region, from any server, even if that server resides in a different region.
12 minWorkload migration is a normal part of cluster operations for a variety of reasons: server maintenance, operating system upgrades, etc. Nomad offers a number of parameters for controlling how running jobs are migrated off of draining nodes.
10 minDon't panic! This is a critical first step. Depending on your deployment configuration, it may take only a single server failure for cluster unavailability. Recovery requires an operator to intervene, but recovery is straightforward.
25 minIt is possible to collect metrics on Nomad with Prometheus after enabling telemetry on Nomad servers and clients.
8 minThis guide covers how to configure and use Autopilot features.
8 minNomad uses two different protocols for communication between cluster members. This guide introduces them and teaches you the appropriate security approach for each communication protocol.
10 minLearn how to encrypt Nomad's gossip protocol with a symmetric key. The gossip protocol is used to communicate membership and liveliness information between the servers.
45 minNomad uses mTLS to encrypt communication between Nomad cluster members. Learn how to configure Nomad for mTLS communication to increase network security between nodes.
10 minIn this concept focused guide, you'll explore the three major components to the ACL system: capabilities, policies, and tokens.
5 minBefore using the Nomad ACL system, it must be enabled and bootstrapped. This guide explains the process.
20 minNomad provides an optional Access Control List (ACL) system which can be used to control access to data and APIs. The ACL system is capability-based, relying on tokens which are associated with policies to determine which fine grained rules can be applied.
30 minNomad uses tokens to authenticate requests to the cluster. Tokens map requests to ACL policies for Nomad to determine if a request is authorized.
20 minIn this guide, you will practice creating Nomad ACL policies to provide controlled access for two different personas to your Nomad Cluster.
45 minHashiCorp Vault has a secrets engine for generating short-lived Nomad tokens. This enables you to leverage Vault-supported authentication methods (token, LDAP, Okta, Amazon IAM, etc.) to obtain a short-lived Nomad token. This guide will demonstrate using Vault token to obtain a Nomad token
3 minIt is possible to deploy and consume stateful workloads in Nomad. Nomad can integrate with various storage solutions such as Portworx and REX-Ray.
20 minThis guide walks you through configuring a host volume and then deploying a MySQL workload that uses it for persistent storage.
30 minThis guide walks you through deploying Container Storage Interface plugins, registering an AWS EBS volume with CSI, and then deploying a MySQL workload that uses it for persistent storage.
20 minYou will deploy a MySQL database which uses the Portworx Docker-volume driver to enable persistent volumes.
20 minThere are a few approaches you can consider when deploying your load balancers for performance and HA
20 minFabio integrates natively with Consul and provides rich features with an optional Web UI.
20 minHAProxy natively integrates with service discovery data from Consul.
20 minNGINX pairs with Nomad's template stanza to allow for dynamic updates to its load balancing configuration.
20 minTraefik natively integrates with Consul using the Consul Catalog Provider.
enterprise3 minLearn the Nomad objects necessary to operate Nomad securely in a multi-team environment. Explore Nomad Enterprise features such as namespaces, resource quotas, and Sentinel.
enterprise8 minNomad Enterprise provides support for namespaces, which allow jobs and their associated objects to be segmented from each other and other users of the cluster.
enterprise8 minNomad Enterprise provides support for resource quotas, which allow operators to restrict the aggregate resource usage of namespaces.
enterprise8 minSentinel allows operators to express their policies as code, and have their policies automatically enforced.
5 minGet started with the Nomad-Spark integration.
5 minThe Nomad Spark integration uses a default job template when running Spark jobs in the cluster. Learn about the default job template and how to customize it.
4 minLearn how to configure resource allocation for your Spark applications.
3 minLearn how to dynamically scale Spark executors based the queue of pending tasks.
5 minLearn how to submit Spark jobs that run on a Nomad cluster.
45 minHashiCorp Vault has a secrets engine for generating short-lived Nomad tokens. This enables you to leverage Vault-supported authentication methods (token, LDAP, Okta, Amazon IAM, etc.) to obtain a short-lived Nomad token. This guide will demonstrate using Vault token to obtain a Nomad token
30 minSecuring Nomad's cluster communication with TLS is important for both security and easing operations. Nomad can use mutual TLS (mTLS) for authenticating for all HTTP and RPC communication. This guide will leverage Vault's PKI secrets engine to accomplish this task.
20 minLearn how to deploy an application, PostgreSQL, in Nomad and retrieve dynamic credentials by integrating with Vault.
enterprise15 minThis reference architecture describes the recommended compute and networking resources you should provision when using Nomad Enterprise in a production environment.
enterprise12 minThis deployment guide covers the steps required to install and configure a single Nomad Enterprise cluster as defined in the Nomad Enterprise Reference Architecture.
Looking for specific Nomad information? The Nomad documentation provides reference material and in-depth details on: