From 3c0a167ed51ba1ed4ad93bbeaca43490f807e492 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Thu, 14 May 2020 01:27:58 +0200 Subject: [PATCH] document deprecation of legacy `~/.dockercfg` config-file The docker CLI up until v1.7.0 used the `~/.dockercfg` file to store credentials after authenticating to a registry (`docker login`). Docker v1.7.0 replaced this file with a new CLI configuration file, located in `~/.docker/config.json`. When implementing the new configuration file, the old file (and file-format) was kept as a fall-back, to assist existing users with migrating to the new file. Given that the old file format encourages insecure storage of credentials (credentials are stored unencrypted), and that no version of the CLI since Docker v1.7.0 has created this file, the file is marked deprecated, and support for this file will be removed in a future release. Signed-off-by: Sebastiaan van Stijn --- docs/deprecated.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/deprecated.md b/docs/deprecated.md index 76883a4f4a0a..2db707313421 100644 --- a/docs/deprecated.md +++ b/docs/deprecated.md @@ -52,6 +52,7 @@ Status | Feature -----------|------------------------------------------------------------------------------------------------------------------------------------|------------|------------ Deprecated | [Kernel memory limit](#kernel-memory-limit) | v20.03.0 | - Deprecated | [Classic Swarm and overlay networks using external key/value stores](#classic-swarm-and-overlay-networks-using-cluster-store) | v20.03.0 | - +Deprecated | [Support for the legacy `~/.dockercfg` configuration file for authentication](#support-for-legacy-dockercfg-configuration-files) | v20.03.0 | - Deprecated | [CLI plugins support](#cli-plugins-support) | v20.03.0 | - Deprecated | [Pushing and pulling with image manifest v2 schema 1](#pushing-and-pulling-with-image-manifest-v2-schema-1) | v19.03.0 | v20.03.0 Removed | [`docker engine` subcommands](#docker-engine-subcommands) | v19.03.0 | v20.03.0 @@ -106,6 +107,22 @@ networks using an external key/value store. The corresponding`--cluster-advertis `--cluster-store`, and `--cluster-store-opt` daemon options have been marked deprecated, and will be disabled or removed in a future release. + +### Support for legacy `~/.dockercfg` configuration files + +**Deprecated in Release: v20.03.0** + +The docker CLI up until v1.7.0 used the `~/.dockercfg` file to store credentials +after authenticating to a registry (`docker login`). Docker v1.7.0 replaced this +file with a new CLI configuration file, located in `~/.docker/config.json`. When +implementing the new configuration file, the old file (and file-format) was kept +as a fall-back, to assist existing users with migrating to the new file. + +Given that the old file format encourages insecure storage of credentials +(credentials are stored unencrypted), and that no version of the CLI since +Docker v1.7.0 has created this file, the file is marked deprecated, and support +for this file will be removed in a future release. + ### CLI plugins support **Deprecated in Release: v20.03.0**