Nomad: recommendations for singleton deployments [DRAFT]

[tgross]

WIP: this isn't related to any release. I need to take one more pass thru before it'll be ready for review.

Many users have a requirement to run exactly one instance of a given allocation because it requires exclusive access to some cluster-wide resource, which we'll refer to here as a "singleton allocation". This is challenging to implement, so this document is intended to describe an accepted design to publish as a how-to/tutorial.

Links

Jira: https://hashicorp.atlassian.net/browse/NMD-1039
Deploy previews: waiting

Contributor checklists

Review urgency:

• ASAP: Bug fixes, broken content, imminent releases
• 3 days: Small changes, easy reviews
• 1 week: Default expectation
• Best effort: No urgency

Pull request:

• Verify that the PR is set to merge into the correct base branch
• Verify that all status checks passed
• Verify that the preview environment deployed successfully
• Add additional reviewers if they are not part of assigned groups

Content:

• I added redirects for any moved or removed pages
• I followed the Education style guide
• I looked at the local or Vercel build to make sure the content rendered correctly

Reviewer checklist

• This PR is set to merge into the correct base branch.
• The content does not contain technical inaccuracies.
• The content follows the Education content and style guides.
• I have verified and tested changes to instructions for end users.

[github-actions]

Vercel Previews Deployed

Name	Status	Preview	Updated (UTC)
Dev Portal	✅ Ready (Inspect)	Visit Preview	Fri Dec 5 20:00:59 UTC 2025
Unified Docs API	✅ Ready (Inspect)	Visit Preview	Fri Dec 5 19:56:13 UTC 2025

[github-actions]

Broken Link Checker

No broken links found! 🎉