hashicorp / hashicorp/nomad

Nomad `host_network` documentation and example improvments

Open
#8,575 0 comments 4 reactions 0 assignees View on GitHub
theme/docs theme/networking
Dominant language
Go
Stars
17k
Forks
2.1k
Avg merge
1d 9h
Merged PRs (30d)
105

Description

The Multi-Host Interface feature released in 0.12 can be tricky to configure properly as there are numerous different ways users can configure their host's network interfaces. It's also not clear from existing documentation how a `host_network` interfaces with some driver's networking features (ex. #8488).

The following documentation improvements are underway to help this.

* Updated examples in the docker driver documentation
* Multi-Host Interface learn guide
* New internals documentation on how to debug/understand how packets flow through Nomad's `bridge` networking mode, including the use of `host_network`.

Also cover #6873

Contributor guide

No contributing guide indexed for this repository

Research direction

Review the existing Docker driver documentation, the Multi-Host Interface learn guide, and issue #6873 first. Done means updated Docker examples, a clearer Multi-Host Interface guide, and internals documentation explaining how to debug packet flow through bridge networking with host_network.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker
Domain
documentation, networking
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.