Skip to content

Commit

Permalink
docs: add note about docker DNS config when using bridge mode
Browse files Browse the repository at this point in the history
The Docker DNS configuration options are not compatible with a
group-level network in `bridge` mode. Warn users about this in the
Docker task configuration docs.
  • Loading branch information
tgross committed Mar 8, 2022
1 parent 6707062 commit 3955c33
Showing 1 changed file with 17 additions and 8 deletions.
25 changes: 17 additions & 8 deletions website/content/docs/drivers/docker.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -100,13 +100,21 @@ config {
}
```

- `dns_search_domains` - (Optional) A list of DNS search domains for the container
to use.

- `dns_options` - (Optional) A list of DNS options for the container to use.

- `dns_servers` - (Optional) A list of DNS servers for the container to use
(e.g. ["8.8.8.8", "8.8.4.4"]). Requires Docker v1.10 or greater.
- `dns_search_domains` - (Optional) A list of DNS search domains for
the container to use. If you are using bridge networking mode with a
`network` block in the task group, you must set all DNS options in
the `network.dns` block instead.

- `dns_options` - (Optional) A list of DNS options for the container
to use. If you are using bridge networking mode with a `network`
block in the task group, you must set all DNS options in the
`network.dns` block instead.

- `dns_servers` - (Optional) A list of DNS servers for the container
to use (e.g. ["8.8.8.8", "8.8.4.4"]). Requires Docker v1.10 or
greater. If you are using bridge networking mode with a `network`
block in the task group, you must set all DNS options in the
`network.dns` block instead.

- `entrypoint` - (Optional) A string list overriding the image's entrypoint.

Expand Down Expand Up @@ -257,7 +265,8 @@ config {
the group `network.mode = "bridge"` you should not set the Docker config
`network_mode`, or the container will be unable to reach other containers in
the task group. This will also prevent [Connect]-enabled tasks from reaching
the Envoy sidecar proxy.
the Envoy sidecar proxy. You must also set any DNS options in the `network.dns`
block and not in the task configuration.

If you are in the process of migrating from the default Docker network to
group-wide bridge networking, you may encounter issues preventing your
Expand Down

0 comments on commit 3955c33

Please sign in to comment.