Docker Containers with HashiCorp Nomad Guide -

HashiCorp Nomad Docker: A Beginner’s Guide to Container Orchestration

Managing containers can feel difficult at first. However, HashiCorp Nomad makes orchestration much simpler.

As a result, teams can deploy Docker containers faster. Moreover, scaling workloads becomes easy and predictable.

HashiCorp Nomad Docker deployment running NGINX container in a local cluster

What Is HashiCorp Nomad?

HashiCorp Nomad is a simple workload orchestrator. Unlike Kubernetes, it avoids complex setup and heavy system use.

It runs both container and non-container workloads. Therefore, you can manage different applications from one tool.

Nomad works well for small teams. In addition, it fits test and learning environments.

When paired with ZippyOPS, Nomad becomes secure and scalable. As a result, teams reach production faster.

Prerequisites for Running Docker Containers in Hashicorp Nomad

Before you start, a few tools are required. First, install Nomad on your system.

Next, install Docker and make sure it is running. After that, start a Nomad agent.

Start Hashicorp Nomad in Development Mode

Development mode is best for learning. To begin, run the command below:

nomad agent -dev

This mode starts a local cluster. Later, you can switch to production mode.

Step 1: Create a Hashicorp Nomad Job File

Nomad uses job files written in HCL. In simple words, the file tells Nomad what to run.

Below is an example that runs NGINX. For beginners, this setup is easy to follow.

File name: docker.nomad

job "nginx-job" {
  datacenters = ["dc1"]

  group "web-group" {
    count = 1

    task "nginx" {
      driver = "docker"

      config {
        image = "nginx:latest"
        ports = ["http"]
      }

      resources {
        network {
          port "http" {
            static = 8080
          }
        }
      }
    }
  }
}

Hashicorp Nomad Job File Explained

Job sets the job name and datacenter
Group links related tasks
Task defines the Docker image
Resources control ports and limits

Together, these parts run a container. As a result, Nomad handles scheduling for you.

Step 2: Deploy the Job

Once the file is ready, deploy it. To do this, run:

nomad run docker.nomad

Nomad then starts the container. At this point, the job becomes active.

Step 3: Check Job Status

After deployment, check the job status. For this, run:

nomad status nginx-job

This shows job details and health. Meanwhile, you can also use the web interface.

Hashicorp Nomad Web UI

The Nomad Web UI gives a clear view of jobs. To access it, open:

http://localhost:4646

Step 4: Access the Container

Now open your browser. Then, visit:

http://localhost:8080

You should see the NGINX welcome page. At the same time, monitoring tools help track usage.

Step 5: Stop the Job

When testing is done, stop the job. Use this command:

nomad stop nginx-job

Nomad frees all resources. As a result, your system stays clean.

Advanced Examples

Add Environment Variables

env {
  APP_ENV = "production"
}

Mount Host Volumes

volumes = [
  "/host/path:/container/path"
]

Scale Containers

To scale, increase the count. For example:

count = 3

Nomad spreads containers across nodes. Therefore, scaling stays simple.

Beginner Tips

Start with development mode
Check jobs in the Web UI
Review logs for errors

nomad logs <allocation-id>

In addition, managed services reduce effort. As a result, teams save time.

Conclusion

Running Docker containers with Docker and HashiCorp Nomad is easy to learn. By using job files, teams gain control and speed.

Nomad offers a simple choice over Kubernetes. When combined with ZippyOPS, it delivers a secure and smooth setup.