From 7548eecbaae6824e1051cf511dd004f99a6a93c0 Mon Sep 17 00:00:00 2001 From: Luiz Aoqui Date: Tue, 22 Aug 2023 15:07:22 -0400 Subject: [PATCH] docs: clarify reference to `network.mode` in docker `network_mode` config (#18277) --- website/content/docs/drivers/docker.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/website/content/docs/drivers/docker.mdx b/website/content/docs/drivers/docker.mdx index 4a4ef03ed..7f446eaf6 100644 --- a/website/content/docs/drivers/docker.mdx +++ b/website/content/docs/drivers/docker.mdx @@ -285,11 +285,11 @@ config { The default `network_mode` for tasks that use group networking in [`bridge`] mode will be `container:`, where the name is the container name of the parent container used to share network namespaces between tasks. If you set - 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. You must also set any DNS options in the `network.dns` - block and not in the task configuration. + the group [`network.mode`][] to `"bridge"` you should not set this Docker + `network_mode` config, otherwise 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. 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 @@ -1222,6 +1222,7 @@ Windows is relatively new and rapidly evolving you may want to consult the [Connect]: /nomad/docs/job-specification/connect [`bridge`]: /nomad/docs/job-specification/network#bridge [network block]: /nomad/docs/job-specification/network#bridge-mode +[`network.mode`]: /nomad/docs/job-specification/network#mode [`pids_limit`]: /nomad/docs/drivers/docker#pids_limit [Windows isolation]: https://learn.microsoft.com/en-us/virtualization/windowscontainers/manage-containers/hyperv-container [cores]: /nomad/docs/job-specification/resources#cores