Learn about configurable rollout and rollback strategies with Nomad Multi-Region Deployments.
Install and run a sample Nomad environment. Schedule the sample job, deploy multiple instances of it, and perform a rolling update.
Take a quick survey of the Nomad web user interface and learn how to perform common operations with it.
3 minAccess the Nomad Web UI from a browser and open a specific Web UI page from the CLI.
9 minUse Nomad's Web UI to inspect and monitor the running workload in your Nomad cluster.
7 minInspect the state of the cluster from the Web UI.
9 minUse the Nomad Web UI to plan and submit a job to the Nomad cluster.
3 minLearn some considerations for your exploration and organizational deployment of the Nomad UI.
Learn the fundamentals of expressing your workload as Nomad jobs. Submit, inspect, and monitor a running Nomad job.
4 minLearn how to deploy and manage a Nomad Job.
6 minUse Nomad's job specification to pass runtime configuration to your workloads using command line arguments, environment variables, or configuration files.
7 minLearn about Nomad job files. The job file is the unit of work in Nomad, and is submitted to the server for evaluation and scheduling of your workload.
8 minUse the Nomad CLI to inspect the status of a running job to determine if it started or what errors might have occurred.
6 minInspect the logs of applications running in Nomad using the "nomad alloc logs" command or the Nomad API.
5 minInspect a job's resource consumption and utilization information captured by Nomad's task drivers.
3 minAccess the Nomad Web UI from a browser and open a specific Web UI page from the CLI.
9 minUse Nomad's Web UI to inspect and monitor the running workload in your Nomad cluster.
7 minInspect the state of the cluster from the Web UI.
9 minUse the Nomad Web UI to plan and submit a job to the Nomad cluster.
3 minLearn some considerations for your exploration and organizational deployment of the Nomad UI.
4 minLearn how to deploy and manage a Nomad Job.
6 minUse Nomad's job specification to pass runtime configuration to your workloads using command line arguments, environment variables, or configuration files.
7 minLearn about Nomad job files. The job file is the unit of work in Nomad, and is submitted to the server for evaluation and scheduling of your workload.
8 minUse the Nomad CLI to inspect the status of a running job to determine if it started or what errors might have occurred.
6 minInspect the logs of applications running in Nomad using the "nomad alloc logs" command or the Nomad API.
5 minInspect a job's resource consumption and utilization information captured by Nomad's task drivers.
Learn about how Nomad attempts to keep jobs running in the event of the unexpected through local retries and rescheduling to other nodes.
Minimize or eliminate downtime during upgrades using rolling, blue/green, or canary updates.
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 minConfigure a Nomad job to perform rolling updates.
14 minConfigure your Nomad job for blue/green and canary deployments to more safely update existing applications and services.
4 minConfigure the signal that Nomad sends to applications before killing them, allowing them to drain connections or gracefully terminate.
Express placement preferences for job allocations within your cluster using affinities and spread. Prevent priority inversion with preemption.
6 minLearn about advanced scheduling features including affinity and spread.
enterprise20 minEnable and use preemption on service and batch jobs in Nomad Enterprise (0.9.3 and above) to keep critical jobs running by evicting lower priority work.
20 minExpress placement preferences for your jobs using affinities. Affinities act like soft constraints, and jobs using them will run even if the affinity can not be met.
20 minPrevent failures across a physical domain such as datacenter or rack from affecting application availability by using spread criteria in your jobs.
Learn the features operators will need to build and maintain Nomad clusters.
4 minJoin nodes to create a Nomad cluster. Learn manual clustering and automatic clustering using cloud auto-join or Consul.
20 minSubmit jobs or interact with the HTTP API targeting any region, from any server, even if that server resides in a different region.
12 minLearn how Nomad migrates workloads during migration events, like node drains for maintenance. Explore the defaults and learn how to customize the migration configuration for your own applications.
10 minDon't panic! Learn the steps necessary to recover a single node failure, multi-node failure, or a complete loss of quorum. Recovery requires an operator to intervene, but it is straightforward.
25 minCollect metrics on Nomad using Prometheus after enabling telemetry on Nomad server and client nodes.
Encrypt Nomad's intercluster traffic—UDP gossip and TCP API/RPC traffic.
8 minLearn the two types of traffic encryption used in a Nomad cluster.
10 minEncrypt Nomad's gossip protocol, which is used to communicate membership and liveliness information between the servers.
45 minEncrypt API and RPC traffic using mutual TLS (mTLS) to increase the security of your Nomad cluster.
Configure a Nomad cluster for ACLs, bootstrap the ACL system, author your first policy, and grant a token based on it.
10 minExplore 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 tutorial explains the process.
20 minLearn about the objects used to write Nomad ACL policies.
30 minCreate management tokens, learn about token internals, and make client tokens based on an ACL policy.
20 minCreate Nomad ACL policies to provide controlled access for two different personas in a Nomad Cluster.
45 minConfigure the Nomad secrets engine in Vault to deliver Vault-managed Nomad ACL tokens.
Explore techniques to run jobs on Nomad that require access to persistent storage.
3 minNomad allows users to mount persistent data from local or remote storage volumes into task environments in several ways: Container Storage Interface plugins, Nomad Host Volume support, and Docker Volume drivers.
20 minConfigure and deploy a host volume to support a MySQL workload that requires persistent storage.
30 minConfigure and deploy the AWS EBS volume CSI plugin to connect an EBS volume to a MySQL workload that requires persistent storage.
20 minDeploy a MySQL database using the Portworx Docker-volume driver to enable persistent volumes.
Learn patterns for expressing task dependencies in Nomad jobs.
Integrate your Nomad cluster with several popular load balancers using Consul for service discovery.
20 minThere are a few approaches you can consider when deploying your load balancers for performance and HA
20 minLoad balance your application with Fabio. Fabio integrates natively with Consul and provides rich features with an optional Web UI.
20 minUse HAProxy's native Consul integration to load balance your application.
20 minGenerate an NGINX configuration for your application using Nomad's template stanza and dynamically reload the NGNIX configuration when changes occur.
20 minLoad balance your application using Traefik's Consul Catalog Provider.
Learn how to use external task driver plugins with Nomad.
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 minSegment jobs and their associated objects from each other and other users of the cluster using Nomad Enterprise namespaces.
enterprise8 minRestrict the aggregate resource usage of namespaces by using Nomad Enterprise resource quotas.
enterprise8 minExpress your policies as code and have them automatically enforced by Nomad using Nomad Enterprise's Sentinel support.
Configure Nomad to obtain secrets from Vault for Nomad workloads. Learn how to configure the Nomad secrets engine in Vault.
45 minConfigure the Nomad secrets engine in Vault to deliver Vault-managed Nomad ACL tokens.
30 minUse Vault and consul-template to create and configure Vault-managed mTLS certificates for Nomad's API and RPC traffic.
20 minGenerate and use Vault-managed PostgreSQL credentials as part of a Nomad job specification.
Use Nomad's Consul integration for health checking, service discovery, and service mesh capabilities.
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 tutorial 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 minConfigure a Nomad job to perform rolling updates.
14 minConfigure your Nomad job for blue/green and canary deployments to more safely update existing applications and services.
4 minConfigure the signal that Nomad sends to applications before killing them, allowing them to drain connections or gracefully terminate.
6 minLearn about advanced scheduling features including affinity and spread.
enterprise20 minEnable and use preemption on service and batch jobs in Nomad Enterprise (0.9.3 and above) to keep critical jobs running by evicting lower priority work.
20 minExpress placement preferences for your jobs using affinities. Affinities act like soft constraints, and jobs using them will run even if the affinity can not be met.
20 minPrevent failures across a physical domain such as datacenter or rack from affecting application availability by using spread criteria in your jobs.
4 minJoin nodes to create a Nomad cluster. Learn manual clustering and automatic clustering using cloud auto-join or Consul.
20 minSubmit jobs or interact with the HTTP API targeting any region, from any server, even if that server resides in a different region.
12 minLearn how Nomad migrates workloads during migration events, like node drains for maintenance. Explore the defaults and learn how to customize the migration configuration for your own applications.
10 minDon't panic! Learn the steps necessary to recover a single node failure, multi-node failure, or a complete loss of quorum. Recovery requires an operator to intervene, but it is straightforward.
25 minCollect metrics on Nomad using Prometheus after enabling telemetry on Nomad server and client nodes.
8 minLearn the two types of traffic encryption used in a Nomad cluster.
10 minEncrypt Nomad's gossip protocol, which is used to communicate membership and liveliness information between the servers.
45 minEncrypt API and RPC traffic using mutual TLS (mTLS) to increase the security of your Nomad cluster.
10 minExplore 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 tutorial explains the process.
20 minLearn about the objects used to write Nomad ACL policies.
30 minCreate management tokens, learn about token internals, and make client tokens based on an ACL policy.
20 minCreate Nomad ACL policies to provide controlled access for two different personas in a Nomad Cluster.
45 minConfigure the Nomad secrets engine in Vault to deliver Vault-managed Nomad ACL tokens.
3 minNomad allows users to mount persistent data from local or remote storage volumes into task environments in several ways: Container Storage Interface plugins, Nomad Host Volume support, and Docker Volume drivers.
20 minConfigure and deploy a host volume to support a MySQL workload that requires persistent storage.
30 minConfigure and deploy the AWS EBS volume CSI plugin to connect an EBS volume to a MySQL workload that requires persistent storage.
20 minDeploy a MySQL database using 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 minLoad balance your application with Fabio. Fabio integrates natively with Consul and provides rich features with an optional Web UI.
20 minUse HAProxy's native Consul integration to load balance your application.
20 minGenerate an NGINX configuration for your application using Nomad's template stanza and dynamically reload the NGNIX configuration when changes occur.
20 minLoad balance your application using Traefik's 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 minSegment jobs and their associated objects from each other and other users of the cluster using Nomad Enterprise namespaces.
enterprise8 minRestrict the aggregate resource usage of namespaces by using Nomad Enterprise resource quotas.
enterprise8 minExpress your policies as code and have them automatically enforced by Nomad using Nomad Enterprise's Sentinel support.
45 minConfigure the Nomad secrets engine in Vault to deliver Vault-managed Nomad ACL tokens.
30 minUse Vault and consul-template to create and configure Vault-managed mTLS certificates for Nomad's API and RPC traffic.
20 minGenerate and use Vault-managed PostgreSQL credentials as part of a Nomad job specification.
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 tutorial 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: