open-nomad/website/content/docs
Michael Schurter 3e50f72fad
core: merge reserved_ports into host_networks (#13651)
Fixes #13505

This fixes #13505 by treating reserved_ports like we treat a lot of jobspec settings: merging settings from more global stanzas (client.reserved.reserved_ports) "down" into more specific stanzas (client.host_networks[].reserved_ports).

As discussed in #13505 there are other options, and since it's totally broken right now we have some flexibility:

Treat overlapping reserved_ports on addresses as invalid and refuse to start agents. However, I'm not sure there's a cohesive model we want to publish right now since so much 0.9-0.12 compat code still exists! We would have to explain to folks that if their -network-interface and host_network addresses overlapped, they could only specify reserved_ports in one place or the other?! It gets ugly.
Use the global client.reserved.reserved_ports value as the default and treat host_network[].reserverd_ports as overrides. My first suggestion in the issue, but @groggemans made me realize the addresses on the agent's interface (as configured by -network-interface) may overlap with host_networks, so you'd need to remove the global reserved_ports from addresses shared with a shared network?! This seemed really confusing and subtle for users to me.
So I think "merging down" creates the most expressive yet understandable approach. I've played around with it a bit, and it doesn't seem too surprising. The only frustrating part is how difficult it is to observe the available addresses and ports on a node! However that's a job for another PR.
2022-07-12 14:40:25 -07:00
..
commands docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
concepts docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
configuration core: merge reserved_ports into host_networks (#13651) 2022-07-12 14:40:25 -07:00
devices
drivers docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
enterprise
install
integrations doc: explain permissions for Vault sys/capabilties-self 2022-07-06 10:01:30 -04:00
job-specification docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
nomad-vs-kubernetes Update supplement.mdx with the right GitHub spelling (#13326) 2022-06-10 11:46:19 +02:00
operations docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
other-specifications docs: typo on command word (#13582) 2022-07-05 16:24:25 -04:00
runtime docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
upgrade docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
ecosystem.mdx docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
faq.mdx docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
index.mdx
partnerships.mdx docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
schedulers.mdx docs: rename Internals to Concepts (#13696) 2022-07-11 16:55:33 -04:00
who-uses-nomad.mdx Lob.com uses Nomad too! (#13295) 2022-06-21 09:10:08 -04:00