update the docs for using host-network

[rdxmb]

with syntax before, there is
WARN[0000] network hostnet: network.external.name is deprecated in favor of network.name

tested with docker-compose-file-version 3.5
Server Version: 17.12.0-ce

in swarm mode

Proposed changes

Unreleased project version (optional)

Related issues (optional)

[rdxmb]

Hm, the warning disappears, but without using 'external' the swarm does create a network named
<STACK>_host

which is overlay. So what about the deprecation?

[gbarr01]

Hi, @rdxmb ... let's see if I understand you:

• You are referring to this page/section: https://docs.docker.com/compose/compose-file/#host-or-none
• You're in swarm mode, using Compose, and you want to use the host networking stack. But it's failing.
• You think that the use of external in this section may be wrong because of the deprecation note down the page.

networks:
  hostnet:
    external:
      name: host

@shin- are the Compose examples under "HOST OR NONE" accurate for v3.5? For reference: #4593 / #4959

[shin-]

The new recommend syntax would be:

networks:
  hostnet:
    external: true
    name: host

[rdxmb]

@gbarr01

You are referring to this page/section: https://docs.docker.com/compose/compose-file/#host-or-none
exactly.

You're in swarm mode, using Compose, and you want to use the host networking stack. But it's failing. You think that the use of external in this section may be wrong because of the deprecation note down the page.

Not exactly. It's not failing, its just a deprecation warning:
WARN[0000] network hostnet: network.external.name is deprecated in favor of network.name

networks:
hostnet:
external:
name: host

@shin- it seems to work. Thanks.

https://docs.docker.com/compose/compose-file/#network-configuration-reference

[rdxmb]

PR changed.