hashicorp/nomad · error

Missing job task groups

Error message

Missing job task groups

What it means

Job.Validate() requires at least one task group. A Nomad job is a container of task groups; with none defined there is nothing to schedule, so the spec is invalid and this error is appended to the multierror.

Source

Thrown at nomad/structs/structs.go:4777

	switch j.Type {
	case JobTypeCore, JobTypeService, JobTypeBatch, JobTypeSystem, JobTypeSysBatch:
	case "":
		mErr.Errors = append(mErr.Errors, errors.New("Missing job type"))
	default:
		mErr.Errors = append(mErr.Errors, fmt.Errorf("Invalid job type: %q", j.Type))
	}
	if len(j.Datacenters) == 0 && !j.IsMultiregion() {
		mErr.Errors = append(mErr.Errors, errors.New("Missing job datacenters"))
	} else {
		for _, v := range j.Datacenters {
			if v == "" {
				mErr.Errors = append(mErr.Errors, errors.New("Job datacenter must be non-empty string"))
			}
		}
	}

	if len(j.TaskGroups) == 0 {
		mErr.Errors = append(mErr.Errors, errors.New("Missing job task groups"))
	}
	for idx, constr := range j.Constraints {
		if err := constr.Validate(); err != nil {
			outer := fmt.Errorf("Constraint %d validation failed: %s", idx+1, err)
			mErr.Errors = append(mErr.Errors, outer)
		}
	}
	if j.Type == JobTypeSystem {
		if j.Affinities != nil {
			mErr.Errors = append(mErr.Errors, fmt.Errorf("System jobs may not have an affinity block"))
		}
	} else {
		for idx, affinity := range j.Affinities {
			if err := affinity.Validate(); err != nil {
				outer := fmt.Errorf("Affinity %d validation failed: %s", idx+1, err)
				mErr.Errors = append(mErr.Errors, outer)
			}
		}

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Add at least one `group "name" { ... }` block containing a `task` stanza to the job file
2. Ensure template logic always renders at least one group
3. Append at least one &TaskGroup{...} (with a task) when building jobs in Go

Example fix

// before
job "web-app" {
  type = "service"
  datacenters = ["dc1"]
}
// after
job "web-app" {
  type = "service"
  datacenters = ["dc1"]
  group "web" {
    task "server" {
      driver = "docker"
      config { image = "nginx" }
    }
  }
}

if len(j.TaskGroups) == 0 {
    return fmt.Errorf("job must define at least one task group")
}

func hasTaskGroups(j *structs.Job) bool { return j != nil && len(j.TaskGroups) > 0 }

if err := job.Validate(); err != nil {
    if strings.Contains(err.Error(), "Missing job task groups") {
        return fmt.Errorf("add at least one group block with a task: %w", err)
    }
}

When it happens

Trigger: Submitting a job spec with no `group` blocks via nomad job run or POST /v1/jobs, or calling Job.Validate() on a structs.Job with len(j.TaskGroups) == 0.

Common situations: Deleting all groups while refactoring an HCL file; template conditionals that render zero group blocks; programmatic job builders that never append a TaskGroup.

Understand the failure class

Background: "missing required argument" and "the following required arguments were not provided": what required-argument errors mean and how to fix them — this error's family across 20 libraries.

Related errors

• Missing job ID
• Job ID contains a space
• Missing job name
• Missing job type
• Disconnect cannot be configured with both lost_after and sto

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/703cb17624be6923. Report an issue: GitHub.