diff --git a/install/linux/docker-ce/centos.md b/install/linux/docker-ce/centos.md index f60b6c82c0..b7a6a5bae3 100644 --- a/install/linux/docker-ce/centos.md +++ b/install/linux/docker-ce/centos.md @@ -131,32 +131,29 @@ from the repository. #### Install Docker CE -1. Install the latest version of Docker CE, or go to the next step to install a - specific version. +1. Install the _latest version_ of Docker CE, or go to the next step to install a specific version: ```bash $ sudo yum install docker-ce ``` - > **Warning**: If you have multiple Docker repositories enabled, installing + If prompted to accept the GPG key, verify that the fingerprint matches + `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. + + > Got multiple Docker repositories? + > + > If you have multiple Docker repositories enabled, installing > or updating without specifying a version in the `yum install` or > `yum update` command always installs the highest possible version, > which may not be appropriate for your stability needs. - {:.warning} - If this is the first time you are installing a package from a recently added - repository, you are prompted to accept the GPG key, and - the key's fingerprint is shown. Verify that the fingerprint is - correct, and if so, accept the key. The fingerprint should match - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`. + Docker is installed but not started. The `docker` group is created, but no users are added to the group. - Docker is installed but not started. The `docker` group is created, but no - users are added to the group. +2. To install a _specific version_ of Docker CE, list the available versions + in the repo, then select and install: -2. On production systems, you should install a specific version of Docker CE - instead of always using the latest. List the available versions. This - example uses the `sort -r` command to sort the results by version number, - highest to lowest, and is truncated. + a. List and sort the versions available in your repo. This example sorts + results by version number, highest to lowest, and is truncated: ```bash $ yum list docker-ce --showduplicates | sort -r @@ -164,23 +161,20 @@ from the repository. docker-ce.x86_64 {{ site.docker_ce_stable_version }}.0.ce-1.el7.centos docker-ce-stable ``` - The contents of the list depend upon which repositories are enabled, and - are specific to your version of CentOS (indicated by the `.el7` suffix - on the version, in this example). Choose a specific version to install. The - second column is the version string. You can use the entire version string, - but **you need to include at least to the first hyphen**. The third column - is the repository name, which indicates which repository the package is from - and by extension its stability level. To install a specific version, append - the version string to the package name and separate them by a hyphen (`-`). + The list returned depends on which repositories are enabled, and is specific + to your version of CentOS (indicated by the `.el7` suffix in this example). - > **Note**: The version string is the package name plus the version up to - > the first hyphen. In the example above, the fully qualified package name - > is `docker-ce-18.03.0.ce`. + b. Install a specific version by its fully qualified package name, which is + the package name (`docker-ce`) plus the version string (2nd column) up to + the first hyphen, separated by a hyphen (`-`), for example, + `docker-ce-18.03.0.ce`. ```bash - $ sudo yum install + $ sudo yum install docker-ce- ``` + Docker is installed but not started. The `docker` group is created, but no users are added to the group. + 3. Start Docker. ```bash diff --git a/install/linux/docker-ce/debian.md b/install/linux/docker-ce/debian.md index 5adcb3b9e6..3ca3eb80dd 100644 --- a/install/linux/docker-ce/debian.md +++ b/install/linux/docker-ce/debian.md @@ -218,8 +218,7 @@ from the repository. $ sudo apt-get update ``` -2. Install the latest version of Docker CE, or go to the next step to install a - specific version. Any existing installation of Docker is replaced. +2. Install the _latest version_ of Docker CE, or go to the next step to install a specific version: ```bash $ sudo apt-get install docker-ce @@ -231,11 +230,10 @@ from the repository. > or updating without specifying a version in the `apt-get install` or > `apt-get update` command always installs the highest possible version, > which may not be appropriate for your stability needs. - {:.warning} -3. On production systems, you should install a specific version of Docker CE - instead of always using the latest. This output is truncated. List the - available versions: +3. To install a _specific version_ of Docker CE, list the available versions in the repo, then select and install: + + a. List the versions available in your repo: ```bash $ apt-cache madison docker-ce @@ -243,12 +241,10 @@ from the repository. docker-ce | {{ site.docker_ce_stable_version }}.0~ce-0~debian | https://download.docker.com/linux/debian jessie/stable amd64 Packages ``` - The contents of the list depend upon which repositories are enabled. Choose - a specific version to install. The second column is the version string. The - third column is the repository name, which indicates which repository the - package is from and by extension its stability level. To install a specific - version, append the version string to the package name and separate them by - an equals sign (`=`): + b. Install a specific version by its fully qualified package name, which is + the package name (`docker-ce`) plus the version string (2nd column) up to + the first hyphen, separated by a an equals sign (`=`), for example, + `docker-ce=18.03.0.ce`. ```bash $ sudo apt-get install docker-ce= diff --git a/install/linux/docker-ce/fedora.md b/install/linux/docker-ce/fedora.md index 55e771ddb3..6e76a6c626 100644 --- a/install/linux/docker-ce/fedora.md +++ b/install/linux/docker-ce/fedora.md @@ -122,18 +122,14 @@ from the repository. #### Install Docker CE -1. Install the latest version of Docker CE, or go to the next step to install a - specific version. +1. Install the _latest version_ of Docker CE, or go to the next step to install a specific version: ```bash $ sudo dnf install docker-ce ``` - If this is the first time you are installing a package from a recently added - repository, you are prompted to accept the GPG key, and - the key's fingerprint is shown. Verify that the fingerprint matches - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35` and if so, accept the - key. + If prompted to accept the GPG key, verify that the fingerprint matches + `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. > Got multiple Docker repositories? > @@ -141,12 +137,14 @@ from the repository. > or updating without specifying a version in the `dnf install` or > `dnf update` command always installs the highest possible version, > which may not be appropriate for your stability needs. - {:.warning-vanilla} -2. On production systems, you should install a specific version of Docker CE - instead of always using the latest. List the available versions. This - example uses the `sort -r` command to sort the results by version number, - highest to lowest, and is truncated. + Docker is installed but not started. The `docker` group is created, but no users are added to the group. + +2. To install a _specific version_ of Docker CE, list the available versions + in the repo, then select and install: + + a. List and sort the versions available in your repo. This example sorts + results by version number, highest to lowest, and is truncated: ```bash $ dnf list docker-ce --showduplicates | sort -r @@ -154,25 +152,27 @@ from the repository. docker-ce.x86_64 {{ site.docker_ce_stable_version }}.0.fc26 docker-ce-stable ``` - The contents of the list depend upon which repositories are enabled, and - are specific to your version of Fedora (indicated by the `.fc26` suffix - on the version, in this example). Choose a specific version to install. The - second column is the version string. The third column is the repository - name, which indicates which repository the package is from and by extension - its stability level. To install a specific version, append the version - string to the package name and separate them by a hyphen (`-`): + The list returned depends on which repositories are enabled, and is specific + to your version of Fedora (indicated by the `.fc26` suffix in this example). + + b. Install a specific version by its fully qualified package name, which is + the package name (`docker-ce`) plus the version string (2nd column) up to + the first hyphen, separated by a hyphen (`-`), for example, + `docker-ce-18.03.0.ce`. ```bash - $ sudo dnf -y install docker-ce- + $ sudo dnf -y install docker-ce- ``` -4. Start Docker. + Docker is installed but not started. The `docker` group is created, but no users are added to the group. + +3. Start Docker. ```bash $ sudo systemctl start docker ``` -5. Verify that Docker CE is installed correctly by running the `hello-world` +4. Verify that Docker CE is installed correctly by running the `hello-world` image. ```bash diff --git a/install/linux/docker-ce/ubuntu.md b/install/linux/docker-ce/ubuntu.md index 10602591c4..0bc9b66302 100644 --- a/install/linux/docker-ce/ubuntu.md +++ b/install/linux/docker-ce/ubuntu.md @@ -234,8 +234,7 @@ the repository. $ sudo apt-get update ``` -2. Install the latest version of Docker CE, or go to the next step to install a - specific version. Any existing installation of Docker is replaced. +2. Install the _latest version_ of Docker CE, or go to the next step to install a specific version: ```bash $ sudo apt-get install docker-ce @@ -247,11 +246,10 @@ the repository. > or updating without specifying a version in the `apt-get install` or > `apt-get update` command always installs the highest possible version, > which may not be appropriate for your stability needs. - {:.warning-vanilla} -3. On production systems, you should install a specific version of Docker CE - instead of always using the latest. This output is truncated. List the - available versions. +3. To install a _specific version_ of Docker CE, list the available versions in the repo, then select and install: + + a. List the versions available in your repo: ```bash $ apt-cache madison docker-ce @@ -259,12 +257,10 @@ the repository. docker-ce | {{ site.docker_ce_stable_version }}.0~ce-0~ubuntu | {{ download-url-base }} xenial/stable amd64 Packages ``` - The contents of the list depend upon which repositories are enabled. Choose - a specific version to install. The second column is the version string. The - third column is the repository name, which indicates which repository the - package is from and by extension its stability level. To install a specific - version, append the version string to the package name and separate them by - an equals sign (`=`): + b. Install a specific version by its fully qualified package name, which is + the package name (`docker-ce`) plus the version string (2nd column) up to + the first hyphen, separated by a an equals sign (`=`), for example, + `docker-ce=18.03.0.ce`. ```bash $ sudo apt-get install docker-ce=