Browse code

Edits to plugin upgrade warning

Signed-off-by: Misty Stanley-Jones <misty@docker.com>

Misty Stanley-Jones authored on 2016/12/10 07:41:51
Showing 1 changed files
... ...
@@ -7,21 +7,21 @@ be found.
7 7
 
8 8
 ## 1.13.0 (2016-12-08)
9 9
 
10
-**IMPORTANT**: In Docker 1.13 managed plugin api changed from the experimental
11
-version introduced in Docker 1.12. Plugins installed with Docker 1.12 should
12
-therefore be **uninstalled** _before_ upgrading to Docker 1.13. You can
13
-uninstall plugins using the `docker plugin rm` command.
10
+**IMPORTANT**: In Docker 1.13, the managed plugin api changed, as compared to the experimental
11
+version introduced in Docker 1.12. You must **uninstall** plugins which you installed with Docker 1.12
12
+_before_ upgrading to Docker 1.13. You can uninstall plugins using the `docker plugin rm` command.
14 13
 
15
-If you have already upgraded to Docker 1.13 without uninstalling plugins, and
16
-get this error message during docker daemon startup;
14
+If you have already upgraded to Docker 1.13 without uninstalling
15
+previously-installed plugins, you may see this message when the Docker daemon
16
+starts:
17 17
 
18 18
     Error starting daemon: json: cannot unmarshal string into Go value of type types.PluginEnv
19 19
 
20
-Take the following steps to manually remove all plugins;
20
+To manually remove all plugins and resolve this problem, take the following steps:
21 21
 
22
-- Remove plugins.json from: `/var/lib/docker/plugins/`
23
-- Restart Docker
24
-- Reinstall your plugins
22
+1. Remove plugins.json from: `/var/lib/docker/plugins/`.
23
+2. Restart Docker. Verify that the Docker daemon starts with no errors.
24
+3. Reinstall your plugins.
25 25
 
26 26
 ### Builder
27 27
 + Add capability to specify images used as a cache source on build. These images do not need to have local parent chain and can be pulled from other registries [#26839](https://github.com/docker/docker/pull/26839)
... ...
@@ -599,7 +599,7 @@ installing docker, please make sure to update them accordingly.
599 599
 
600 600
 
601 601
 ### DEPRECATION
602
-* Environment variables `DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE` and `DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE` have been renamed  
602
+* Environment variables `DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE` and `DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE` have been renamed
603 603
   to `DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE` and `DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE` respectively [#22574](https://github.com/docker/docker/pull/22574)
604 604
 * Remove deprecated `syslog-tag`, `gelf-tag`, `fluentd-tag` log option in favor of the more generic `tag` one [#22620](https://github.com/docker/docker/pull/22620)
605 605
 * Remove deprecated feature of passing HostConfig at API container start [#22570](https://github.com/docker/docker/pull/22570)
... ...
@@ -770,7 +770,7 @@ installing docker, please make sure to update them accordingly.
770 770
 - Fix a panic that could occur when cleanup after a container started with invalid parameters ([#21716](https://github.com/docker/docker/pull/21716))
771 771
 - Fix a race with event timers stopping early ([#21692](https://github.com/docker/docker/pull/21692))
772 772
 - Fix race conditions in the layer store, potentially corrupting the map and crashing the process ([#21677](https://github.com/docker/docker/pull/21677))
773
-- Un-deprecate auto-creation of host directories for mounts. This feature was marked deprecated in ([#21666](https://github.com/docker/docker/pull/21666))  
773
+- Un-deprecate auto-creation of host directories for mounts. This feature was marked deprecated in ([#21666](https://github.com/docker/docker/pull/21666))
774 774
   Docker 1.9, but was decided to be too much of a backward-incompatible change, so it was decided to keep the feature.
775 775
 + It is now possible for containers to share the NET and IPC namespaces when `userns` is enabled ([#21383](https://github.com/docker/docker/pull/21383))
776 776
 + `docker inspect <image-id>` will now expose the rootfs layers ([#21370](https://github.com/docker/docker/pull/21370))