1. docker
  2. Commit ae6f09b29ccbcd11c842d5b8cf319d7ce2da41be
Browse code

deprecate "top-level" network information in NetworkSettings

When inspecting a container, `NetworkSettings` contains top-level
information about the default ("bridge") network;

`EndpointID`, `Gateway`, `GlobalIPv6Address`, `GlobalIPv6PrefixLen`,
`IPAddress`, `IPPrefixLen`, `IPv6Gateway`, and `MacAddress`.

These properties are deprecated in favor of per-network properties in
`NetworkSettings.Networks`. These properties were already "deprecated" in
docker 1.9, but kept around for backward compatibility.

Refer to [#17538](https://github.com/docker/docker/pull/17538) for further
information.

This officially deprecates these properties, and marks them
for removal in 1.16

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

Sebastiaan van Stijn authored on 2016/11/15 23:41:52
Showing 1 changed files
docs/deprecated.md
History View file @ ae6f09b
... ... 
@@ -20,6 +20,26 @@ The following list of features are deprecated in Engine.
20 20 
 To learn more about Docker Engine's deprecation policy,
21 21 
 see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy).
22 22
23 
+
24 
+### Top-level network properties in NetworkSettings
25 
+
26 
+**Deprecated In Release: v1.13.0**
27 
+
28 
+**Target For Removal In Release: v1.16**
29 
+
30 
+When inspecting a container, `NetworkSettings` contains top-level information
31 
+about the default ("bridge") network;
32 
+
33 
+`EndpointID`, `Gateway`, `GlobalIPv6Address`, `GlobalIPv6PrefixLen`, `IPAddress`,
34 
+`IPPrefixLen`, `IPv6Gateway`, and `MacAddress`.
35 
+
36 
+These properties are deprecated in favor of per-network properties in
37 
+`NetworkSettings.Networks`. These properties were already "deprecated" in
38 
+docker 1.9, but kept around for backward compatibility.
39 
+
40 
+Refer to [#17538](https://github.com/docker/docker/pull/17538) for further
41 
+information.
42 
+
23 43 
 ## `filter` param for `/images/json` endpoint
24 44 
 **Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/tag/v1.13.0)**
25 45