New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Document the default address pool for local networks #8663
Comments
Thanks to @bluikko for pointing out this gap in documentation! moby/moby#29376 (comment) |
3 years past — and the chances to find the actual default values, this table, are much better on StackOverflow than on https://docs.docker.com 👎
Source: ipamutils/utils.go in docker/libnetwork |
The persistent problem with Docker documentation: seems to be geared towards explaining basics of things for for beginners (or developers not familiar with networking/server administration) and very thin on actual details. Basically it's developers trying to be sysadmins and failing. Results of throwing away decades of system administration experience in the name of "devops". |
warning this comment may contain sarcasm |
There hasn't been any activity on this issue for a long time. Prevent issues from auto-closing with a /lifecycle stale |
@docker-robot no, stop. That people aren't screaming about an issue, doesn't make the issue disappear. /remove-lifecycle stale |
Erm, something weird here:
|
@candlerb: Right! Thanks for spotting this one. |
Hey @candlerb, you're right. Just drilled into the source — found this definition:
Applies at least to docker v20.10.12 and likely many more (but probably not all) versions. Verify via the I'm updating the table above. Thanks for noting! @trapier you may want to update the head post as well 🙏 |
There hasn't been any activity on this issue for a long time. Prevent issues from auto-closing with a /lifecycle stale |
@ulidtko: the table you have provided here still has errors AFAICS.
|
/remove-lifecycle stale |
Closed issues are locked after 30 days of inactivity. If you have found a problem that seems similar to this, please open a new issue. /lifecycle locked |
Problem description
The default pool for
docker swarm init --default-addr-pool
is covered in the swarm documentation:Ref: https://docs.docker.com/engine/swarm/swarm-mode/#configuring-default-address-pools
The analogous default for local networks (
dockerd --default-address-pool
) is not currently represented in the documentation. The defaults are as follows (including swarmglobal
networks as well for reference):Problem location
Filing this in docker.github.io, but it might be best to address by adding a section to https://github.com/docker/cli/blob/master/docs/reference/commandline/dockerd.md.
Project version(s) affected
dockerd --default-address-pool
was released with server 18.06 (moby/moby#36396).Suggestions for a fix
Note the "default" default address pool via a new section on https://github.com/docker/cli/blob/master/docs/reference/commandline/dockerd.md. Adding a section might also present the opportunity to document the CLI syntax:
Ref: moby/moby#36396 (comment)
The text was updated successfully, but these errors were encountered: