Skip to content

Revise documentation for default-address-pools #18782

Open
@polarathene

Description

@polarathene

Is this a docs issue?

  • My issue is about the documentation content or website

Type of issue

I can't find what I'm looking for

Description

I could find this myself since I was aware of it from participating in a review that added the information, but recall difficulty finding such information prior.

Main concern is the current location is not as visible for users seeking it as it's not strictly related to IPv6. I've seen this confusion with users recently, thus opening an issue for their benefit 👍


Current docs reference from IPv6 page:

image

Source reference:

https://github.com/moby/moby/blob/ce1ee98aba41e117c59bf17a108191eed14e9b9c/libnetwork/ipamutils/utils.go#L18-L27

@dvdksn and @akerouanton discussed to add a page dedicated to describing IP allocation and how that works, so we can cover this in the follow-up. - Source

It's a lengthy PR review discussion, so perhaps that was referring to "follow-up" as within the same PR, but users may have trouble discovering this non-IPv6 specific information that lives in the IPv6 docs only.


Previous docs issues requesting this information:

Location

https://docs.docker.com/config/daemon/ipv6/#dynamic-ipv6-subnet-allocation

Suggestion

The default-address-pools information could be extracted from IPv6 page to it's own page? The dockerd reference page has a related config/option should probably also reference it for easier discovery?

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions