mirror of https://github.com/docker/docs.git
Update EE and CE install instructions (#4556)
This commit is contained in:
parent
7da2baedef
commit
66681478fe
|
@ -0,0 +1,343 @@
|
|||
{% assign section = include.section %}
|
||||
|
||||
{% comment %}
|
||||
|
||||
Include a chunk of this file, using variables already set in the file
|
||||
where you want to reuse the chunk.
|
||||
|
||||
Usage: {% include ee-linux-install-reuse.md section="ee-install-intro" %}
|
||||
|
||||
{% endcomment %}
|
||||
|
||||
|
||||
|
||||
{% if section == "ee-install-intro" %}
|
||||
|
||||
To get started with Docker EE on {{ linux-dist-long }}, make sure you
|
||||
[meet the prerequisites](#prerequisites), then
|
||||
[install Docker](#install-docker-ee).
|
||||
|
||||
{% elsif section == "ee-url-intro" %}
|
||||
|
||||
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
|
||||
repository URL associated with your trial or subscription. These instructions
|
||||
work for Docker EE for {{ linux-dist-long }} and for Docker EE for Linux, which
|
||||
includes access to Docker EE for all Linux distributions. To get this
|
||||
information:
|
||||
|
||||
- Go to [https://store.docker.com/my-content](https://store.docker.com/my-content).
|
||||
- Each subscription or trial you have access to is listed. Click the **Setup**
|
||||
button for **Docker Enterprise Edition for {{ linux-dist-long }}**.
|
||||
- Copy the URL from the field labeled
|
||||
**Copy and paste this URL to download your Edition**.
|
||||
|
||||
Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
|
||||
|
||||
To learn more about Docker EE, see
|
||||
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
|
||||
|
||||
|
||||
|
||||
{% elsif section == "ways-to-install" %}
|
||||
|
||||
You can install Docker EE in different ways, depending on your needs:
|
||||
|
||||
- Most users
|
||||
[set up Docker's repositories](#install-using-the-repository) and install
|
||||
from them, for ease of installation and upgrade tasks. This is the
|
||||
recommended approach.
|
||||
|
||||
- Some users download the {{ package-format }} package and install it manually
|
||||
and manage upgrades completely manually. This is useful in situations such as
|
||||
installing Docker on air-gapped systems with no access to the internet.
|
||||
|
||||
|
||||
|
||||
{% elsif section == "set-up-yum-repo" %}
|
||||
|
||||
1. Remove any existing Docker repositories from `/etc/yum.repos.d/`.
|
||||
|
||||
2. Temporarily store the Docker EE repository URL you noted down in the
|
||||
[prerequisites](#prerequisites) in an environment variable.
|
||||
This will not persist when the current session ends.
|
||||
|
||||
```bash
|
||||
$ export DOCKERURL='<DOCKER-EE-URL>'
|
||||
```
|
||||
|
||||
3. Store your Docker EE repository URL in a `yum` variable in `/etc/yum/vars/`.
|
||||
This command relies on the variable you stored in the previous step.
|
||||
|
||||
```bash
|
||||
$ sudo sh -c 'echo "$DOCKERURL/{{ linux-dist-url-slug }}" > /etc/yum/vars/dockerurl'
|
||||
```
|
||||
|
||||
{% if linux-dist == "rhel" %}
|
||||
|
||||
Store your OS version string in `/etc/yum/vars/dockerosversion`. Most users
|
||||
should use `7`, but you can also use the more specific minor version,
|
||||
starting from `7.2`.
|
||||
|
||||
{% endif %}
|
||||
|
||||
4. Install required packages. `yum-utils` provides the `yum-config-manager`
|
||||
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
|
||||
`devicemapper` storage driver.
|
||||
|
||||
```bash
|
||||
$ sudo yum install -y yum-utils \
|
||||
device-mapper-persistent-data \
|
||||
lvm2
|
||||
```
|
||||
|
||||
{% if linux-dist == "rhel" %}
|
||||
5. Enable the `extras` RHEL repository. This ensures access to the
|
||||
`container-selinux` package which is required by `docker-ee`.
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhel-7-server-extras-rpms
|
||||
```
|
||||
|
||||
Depending on cloud provider, you may also need to enable another repository.
|
||||
|
||||
For AWS:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhui-REGION-rhel-server-extras
|
||||
```
|
||||
|
||||
> **Note**: `REGION` here is literal, and does *not* represent the region
|
||||
> your machine is running in.
|
||||
|
||||
For Azure:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhui-rhel-7-server-rhui-extras-rpms
|
||||
```
|
||||
{% endif %}
|
||||
|
||||
6. Use the following command to add the **stable** repository:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager \
|
||||
--add-repo \
|
||||
"$DOCKERURL/{{ linux-dist-url-slug }}/docker-ee.repo"
|
||||
```
|
||||
|
||||
|
||||
{% elsif section == "install-using-yum-repo" %}
|
||||
|
||||
1. Install the latest version of Docker EE, or go to the next step to install a
|
||||
specific version.
|
||||
|
||||
```bash
|
||||
$ sudo yum -y install docker-ee
|
||||
```
|
||||
|
||||
If this is the first time you have refreshed the package index since adding
|
||||
the Docker repositories, you will be prompted to accept the GPG key, and
|
||||
the key's fingerprint will be shown. Verify that the fingerprint matches
|
||||
`{{ gpg-fingerprint }}` and if so, accept the key.
|
||||
|
||||
2. On production systems, you should install a specific version of Docker EE
|
||||
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.
|
||||
|
||||
> **Note**: This `yum list` command only shows binary packages. To show
|
||||
> source packages as well, omit the `.x86_64` from the package name.
|
||||
|
||||
```bash
|
||||
$ sudo yum list docker-ee.x86_64 --showduplicates | sort -r
|
||||
|
||||
docker-ee.x86_64 {{ minor-version }}.ee.2-1.el7.{{ linux-dist }} docker-ee-stable-17.06
|
||||
```
|
||||
|
||||
The contents of the list depend upon which repositories you have enabled,
|
||||
and will be specific to your version of {{ linux-dist-long }}
|
||||
(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 (`-`):
|
||||
|
||||
> **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-ee-17.06.1.ee.2`.
|
||||
|
||||
```bash
|
||||
$ sudo yum -y install <FULLY-QUALIFIED-PACKAGE-NAME>
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
|
||||
that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
4. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**.
|
||||
|
||||
5. Start Docker.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
6. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker
|
||||
commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
|
||||
non-privileged users to run Docker commands and for other optional configuration
|
||||
steps.
|
||||
|
||||
|
||||
|
||||
{% elsif section == "upgrade-using-yum-repo" %}
|
||||
|
||||
To upgrade Docker EE:
|
||||
|
||||
1. If upgrading to a new major Docker EE version (such as when going from
|
||||
Docker 17.03.x to Docker 17.06.x),
|
||||
[add the new repository](#set-up-the-repository){: target="_blank" class="_" }.
|
||||
|
||||
2. Run `sudo yum makecache fast`.
|
||||
|
||||
3. Follow the
|
||||
[installation instructions](#install-docker), choosing the new version you
|
||||
want to install.
|
||||
|
||||
|
||||
{% elsif section == "install-using-yum-package" %}
|
||||
|
||||
If you cannot use the official Docker repository to install Docker EE, you can
|
||||
download the `.{{ package-format | downcase }}` file for your release and
|
||||
install it manually. You will need to download a new file each time you want to
|
||||
upgrade Docker EE.
|
||||
|
||||
{% if linux-dist == "rhel" %}
|
||||
1. Enable the `extras` RHEL repository. This ensures access to the
|
||||
`container-selinux` package which is required by `docker-ee`.
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhel-7-server-extras-rpms
|
||||
```
|
||||
|
||||
Alternately, obtain that package manually from Red Hat.
|
||||
There is no way to publicly browse this repository.
|
||||
{% endif %}
|
||||
|
||||
1. Go to the Docker EE repository URL associated with your
|
||||
trial or subscription in your browser. Go to
|
||||
`{{ linux-dist-url-slug }}/7/x86_64/stable-{{ minor-version }}/Packages` and
|
||||
download the `.{{ package-format | downcase }}` file for the Docker version
|
||||
you want to install.
|
||||
|
||||
{% if linux-dist == "rhel" %}
|
||||
|
||||
> **Note**: If you have trouble with `selinux` using the packages under the
|
||||
> `7` directory, try choosing the version-specific directory instead, such
|
||||
> as `7.3`.
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
2. Install Docker EE, changing the path below to the path where you downloaded
|
||||
the Docker package.
|
||||
|
||||
```bash
|
||||
$ sudo yum install /path/to/package.rpm
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it.
|
||||
Assuming that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
4. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**.
|
||||
|
||||
5. Start Docker.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
6. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker
|
||||
commands. Continue to [Post-installation steps for Linux](linux-postinstall.md)
|
||||
to allow non-privileged users to run Docker commands and for other optional
|
||||
configuration steps.
|
||||
|
||||
|
||||
{% elsif section == "upgrade-using-yum-package" %}
|
||||
|
||||
To upgrade Docker EE, download the newer package file and repeat the
|
||||
[installation procedure](#install-from-a-package), using `yum -y upgrade`
|
||||
instead of `yum -y install`, and pointing to the new file.
|
||||
|
||||
{% elsif section == "yum-uninstall" %}
|
||||
|
||||
1. Uninstall the Docker EE package:
|
||||
|
||||
```bash
|
||||
$ sudo yum -y remove docker-ee
|
||||
```
|
||||
|
||||
2. Images, containers, volumes, or customized configuration files on your host
|
||||
are not automatically removed. To delete all images, containers, and
|
||||
volumes:
|
||||
|
||||
```bash
|
||||
$ sudo rm -rf /var/lib/docker
|
||||
```
|
||||
|
||||
3. If desired, remove the `devicemapper` thin pool and reformat the block
|
||||
devices that were part of it.
|
||||
|
||||
You must delete any edited configuration files manually.
|
||||
|
||||
|
||||
{% elsif section == "linux-install-nextsteps" %}
|
||||
|
||||
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
|
||||
|
||||
- Continue with the [User Guide](/engine/userguide/index.md).
|
||||
|
||||
{% endif %}
|
|
@ -80,7 +80,9 @@ from the repository.
|
|||
`devicemapper` storage driver.
|
||||
|
||||
```bash
|
||||
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
|
||||
$ sudo yum install -y yum-utils \
|
||||
device-mapper-persistent-data \
|
||||
lvm2
|
||||
```
|
||||
|
||||
2. Use the following command to set up the **stable** repository. You always
|
||||
|
@ -120,19 +122,7 @@ from the repository.
|
|||
|
||||
#### Install Docker CE
|
||||
|
||||
1. Update the `yum` package index.
|
||||
|
||||
```bash
|
||||
$ sudo yum makecache fast
|
||||
```
|
||||
|
||||
If this is the first time you have refreshed the package index since adding
|
||||
the Docker repositories, you will be prompted to accept the GPG key, and
|
||||
the key's fingerprint will be 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`.
|
||||
|
||||
2. Install the latest version of Docker CE, or go to the next step to install a
|
||||
1. Install the latest version of Docker CE, or go to the next step to install a
|
||||
specific version.
|
||||
|
||||
```bash
|
||||
|
@ -145,10 +135,16 @@ from the repository.
|
|||
> which may not be appropriate for your stability needs.
|
||||
{:.warning}
|
||||
|
||||
If this is the first time you have refreshed the package index since adding
|
||||
the Docker repositories, you will be prompted to accept the GPG key, and
|
||||
the key's fingerprint will be 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.
|
||||
|
||||
3. On production systems, you should install a specific version of Docker CE
|
||||
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.
|
||||
|
@ -159,28 +155,33 @@ from the repository.
|
|||
```bash
|
||||
$ yum list docker-ce.x86_64 --showduplicates | sort -r
|
||||
|
||||
docker-ce.x86_64 {{ minor-version }}.0.el7 docker-ce-stable
|
||||
docker-ce.x86_64 {{ minor-version }}.ce-1.el7.centos docker-ce-stable
|
||||
```
|
||||
|
||||
The contents of the list depend upon which repositories are enabled, and
|
||||
will be 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. 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 (`-`):
|
||||
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 (`-`).
|
||||
|
||||
> **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-17.06.1.ce`.
|
||||
|
||||
```bash
|
||||
$ sudo yum install docker-ce-<VERSION>
|
||||
$ sudo yum install <FULLY-QUALIFIED-PACKAGE-NAME>
|
||||
```
|
||||
|
||||
4. Start Docker.
|
||||
3. Start Docker.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
5. Verify that `docker` is installed correctly by running the `hello-world`
|
||||
4. Verify that `docker` is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
|
|
|
@ -124,7 +124,9 @@ from the repository.
|
|||
$ curl -fsSL {{ download-url-base}}/gpg | sudo apt-key add -
|
||||
```
|
||||
|
||||
Verify that the key ID is `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`.
|
||||
Verify that you now have the key with the fingerprint
|
||||
`9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`, by searching for the
|
||||
last 8 characters of the fingerprint.
|
||||
|
||||
```bash
|
||||
$ sudo apt-key fingerprint 0EBFCD88
|
||||
|
|
|
@ -11,7 +11,7 @@ title: Get Docker CE for Fedora
|
|||
|
||||
To get started with Docker CE on Fedora, make sure you
|
||||
[meet the prerequisites](#prerequisites), then
|
||||
[install Docker](#install-docker-ce).
|
||||
[install Docker](#install-docker).
|
||||
|
||||
## Prerequisites
|
||||
|
||||
|
@ -27,11 +27,6 @@ To install Docker, you need the 64-bit version of one of these Fedora versions:
|
|||
|
||||
- 24
|
||||
- 25
|
||||
- 26
|
||||
|
||||
<!---TODO: Remove below note once 17.09.0 GA for Fedora 26--->
|
||||
> **Note**: Fedora 26 packages are currently only available in the **edge**
|
||||
> and **test** repositories.
|
||||
|
||||
### Uninstall old versions
|
||||
|
||||
|
@ -87,7 +82,7 @@ from the repository.
|
|||
|
||||
2. Use the following command to set up the **stable** repository. You always
|
||||
need the **stable** repository, even if you want to install builds from the
|
||||
**edge** or **test** repositories as well.
|
||||
**edge** or **testing** repositories as well.
|
||||
|
||||
```bash
|
||||
$ sudo dnf config-manager \
|
||||
|
@ -95,23 +90,19 @@ from the repository.
|
|||
{{ download-url-base }}/docker-ce.repo
|
||||
```
|
||||
|
||||
3. **Optional**: Enable the **edge** and **test** repositories. These
|
||||
3. **Optional**: Enable the **edge** and **testing** repositories. These
|
||||
repositories are included in the `docker.repo` file above but are disabled
|
||||
by default. You can enable them alongside the stable repository.
|
||||
|
||||
<!---TODO: Remove below note once 17.09.0 GA for Fedora 26--->
|
||||
> **Note**: Fedora 26 packages are currently only available in the **edge**
|
||||
> and **test** repositories.
|
||||
|
||||
```bash
|
||||
$ sudo dnf config-manager --set-enabled docker-ce-edge
|
||||
```
|
||||
|
||||
```bash
|
||||
$ sudo dnf config-manager --set-enabled docker-ce-test
|
||||
$ sudo dnf config-manager --set-enabled docker-ce-testing
|
||||
```
|
||||
|
||||
You can disable the **edge** or **test** repository by running the
|
||||
You can disable the **edge** or **testing** repository by running the
|
||||
`dnf config-manager` command with the `--disable` flag. To re-enable it, use
|
||||
the `--enable` flag. The following command disables the **edge** repository.
|
||||
|
||||
|
@ -120,7 +111,7 @@ from the repository.
|
|||
```
|
||||
|
||||
> **Note**: Starting with Docker 17.06, stable releases are also pushed to
|
||||
> the **edge** and **test** repositories.
|
||||
> the **edge** and **testing** repositories.
|
||||
|
||||
[Learn about **stable** and **edge** channels](/engine/installation/).
|
||||
|
||||
|
@ -151,7 +142,7 @@ from the repository.
|
|||
> or updating without specifying a version in the `dnf install` or
|
||||
> `dnf update` command will always install the highest possible version,
|
||||
> which may not be appropriate for your stability needs.
|
||||
{:.warning}
|
||||
{:.warning-vanilla}
|
||||
|
||||
3. On production systems, you should install a specific version of Docker CE
|
||||
instead of always using the latest. List the available versions. This
|
||||
|
|
|
@ -12,7 +12,7 @@ title: Get Docker CE for Ubuntu
|
|||
|
||||
To get started with Docker CE on Ubuntu, make sure you
|
||||
[meet the prerequisites](#prerequisites), then
|
||||
[install Docker](#install-docker-ce).
|
||||
[install Docker](#install-docker).
|
||||
|
||||
## Prerequisites
|
||||
|
||||
|
@ -34,9 +34,10 @@ versions:
|
|||
- Xenial 16.04 (LTS)
|
||||
- Trusty 14.04 (LTS)
|
||||
|
||||
Docker CE is supported on Ubuntu on `x86_64` (or `amd64`), `armhf`, and `s390x` (IBM Z) architectures.
|
||||
Docker CE is supported on Ubuntu on `x86_64`, `armhf`, and `s390x` (IBM z
|
||||
Systems) architectures.
|
||||
|
||||
> **`s390x` limitations**: IBM Z is only supported on Ubuntu Xenial and Zesty.
|
||||
> **`s390x` limitations**: System Z is only supported on Ubuntu Xenial and Zesty.
|
||||
|
||||
### Uninstall old versions
|
||||
|
||||
|
@ -118,7 +119,9 @@ the repository.
|
|||
$ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add -
|
||||
```
|
||||
|
||||
Verify that the key fingerprint is `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`.
|
||||
Verify that you now have the key with the fingerprint
|
||||
`9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`, by searching for the
|
||||
last 8 characters of the fingerprint.
|
||||
|
||||
```bash
|
||||
$ sudo apt-key fingerprint 0EBFCD88
|
||||
|
@ -131,8 +134,8 @@ the repository.
|
|||
|
||||
4. Use the following command to set up the **stable** repository. You always
|
||||
need the **stable** repository, even if you want to install builds from the
|
||||
**edge** or **test** repositories as well. To add the **edge** or
|
||||
**test** repository, add the word `edge` or `test` (or both) after the
|
||||
**edge** or **testing** repositories as well. To add the **edge** or
|
||||
**testing** repository, add the word `edge` or `testing` (or both) after the
|
||||
word `stable` in the commands below.
|
||||
|
||||
> **Note**: The `lsb_release -cs` sub-command below returns the name of your
|
||||
|
@ -141,7 +144,7 @@ the repository.
|
|||
> to your parent Ubuntu distribution. For example, if you are using
|
||||
> `Linux Mint Rafaela`, you could use `trusty`.
|
||||
|
||||
**x86_64**:
|
||||
**amd64**:
|
||||
|
||||
```bash
|
||||
$ sudo add-apt-repository \
|
||||
|
@ -169,7 +172,7 @@ the repository.
|
|||
```
|
||||
|
||||
> **Note**: Starting with Docker 17.06, stable releases are also pushed to
|
||||
> the **edge** and **test** repositories.
|
||||
> the **edge** and **testing** repositories.
|
||||
|
||||
[Learn about **stable** and **edge** channels](/engine/installation/).
|
||||
|
||||
|
@ -195,7 +198,7 @@ the repository.
|
|||
> or updating without specifying a version in the `apt-get install` or
|
||||
> `apt-get update` command will always install the highest possible version,
|
||||
> which may not be appropriate for your stability needs.
|
||||
{:.warning}
|
||||
{:.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
|
||||
|
@ -227,17 +230,11 @@ the repository.
|
|||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
or if you run on armhf:
|
||||
|
||||
```bash
|
||||
$ sudo docker run armhf/hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker CE is installed and running. You need to use `sudo` to run Docker
|
||||
commands. Continue to [Linux postinstall](../linux-postinstall.md) to allow
|
||||
Docker CE is installed and running. You need to use `sudo` to run Docker commands.
|
||||
Continue to [Linux postinstall](../linux-postinstall.md) to allow
|
||||
non-privileged users to run Docker commands and for other optional configuration
|
||||
steps.
|
||||
|
||||
|
|
|
@ -7,46 +7,37 @@ title: Get Docker EE for CentOS
|
|||
---
|
||||
|
||||
{% assign minor-version = "17.06" %}
|
||||
{% assign linux-dist = "centos" %}
|
||||
{% assign linux-dist-url-slug = "centos" %}
|
||||
{% assign linux-dist-long = "Centos" %}
|
||||
{% assign package-format = "RPM" %}
|
||||
{% assign gpg-fingerprint = "77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9" %}
|
||||
|
||||
To get started with Docker EE on CentOS, make sure you
|
||||
[meet the prerequisites](#prerequisites), then
|
||||
[install Docker EE](#install-docker-ee).
|
||||
{% include ee-linux-install-reuse.md section="ee-install-intro" %}
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Docker CE users should go to
|
||||
[Get docker CE for CentOS](/engine/installation/linux/docker-ce/centos.md)
|
||||
[Get docker CE for CentOS](https://docs.docker.com/engine/installation/linux/docker-ce/centos/)
|
||||
**instead of this topic**.
|
||||
|
||||
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
|
||||
repository URL associated with your trial or subscription. These instructions
|
||||
work for Docker EE for CentOS and for Docker EE for Linux, which includes access
|
||||
to Docker EE for all Linux distributions.To get this information:
|
||||
### Docker EE repository URL
|
||||
|
||||
- Go to [https://store.docker.com/my-content](https://store.docker.com/my-content).
|
||||
- Each subscription or trial you have access to is listed. Click the **Setup**
|
||||
button for **Docker Enterprise Edition for CentOS**.
|
||||
- Copy the URL from the field labeled
|
||||
**Copy and paste this URL to download your Edition**.
|
||||
|
||||
Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
|
||||
|
||||
To learn more about Docker EE, see
|
||||
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
|
||||
|
||||
In addition, you must use the `devicemapper` storage driver if you use Docker EE.
|
||||
On production systems, you must use `direct-lvm` mode, which requires one or
|
||||
more dedicated block devices. Fast storage such as solid-state media (SSD) is
|
||||
recommended.
|
||||
{% include ee-linux-install-reuse.md section="ee-url-intro" %}
|
||||
|
||||
### OS requirements
|
||||
|
||||
To install Docker EE, you need the 64-bit version of CentOS 7.
|
||||
To install Docker EE, you need the 64-bit version of {{ linux-dist-long}} 7.
|
||||
|
||||
The `centos-extras` repository must be enabled. This repository is enabled by
|
||||
default, but if you have disabled it, you need to
|
||||
[re-enable it](https://wiki.centos.org/AdditionalResources/Repositories){: target="_blank" class="_" }.
|
||||
|
||||
In addition, you must use the `devicemapper` storage driver if you use
|
||||
Docker EE. On production systems, you must use `direct-lvm` mode, which requires
|
||||
one or more dedicated block devices. Fast storage such as solid-state media
|
||||
(SSD) is recommended.
|
||||
|
||||
### Uninstall old versions
|
||||
|
||||
Older versions of Docker were called `docker` or `docker-engine`. In addition,
|
||||
|
@ -68,16 +59,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`.
|
|||
|
||||
## Install Docker EE
|
||||
|
||||
You can install Docker EE in different ways, depending on your needs:
|
||||
|
||||
- Most users
|
||||
[set up Docker's repositories](#install-using-the-repository) and install
|
||||
from them, for ease of installation and upgrade tasks. This is the
|
||||
recommended approach.
|
||||
|
||||
- Some users download the RPM package and install it manually and manage
|
||||
upgrades completely manually. This is useful in situations such as installing
|
||||
Docker on air-gapped systems with no access to the internet.
|
||||
{% include ee-linux-install-reuse.md section="ways-to-install" %}
|
||||
|
||||
### Install using the repository
|
||||
|
||||
|
@ -87,225 +69,28 @@ EE from the repository.
|
|||
|
||||
#### Set up the repository
|
||||
|
||||
1. Remove any existing Docker repositories from `/etc/yum.repos.d/`.
|
||||
|
||||
2. Store your Docker EE repository URL in a `yum` variable in `/etc/yum/vars/`.
|
||||
Replace `<DOCKER-EE-URL>` with the URL you noted down in the
|
||||
[prerequisites](#prerequisites).
|
||||
|
||||
```bash
|
||||
$ sudo sh -c 'echo "<DOCKER-EE-URL>/centos" > /etc/yum/vars/dockerurl'
|
||||
```
|
||||
|
||||
3. Install required packages. `yum-utils` provides the `yum-config-manager`
|
||||
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
|
||||
`devicemapper` storage driver.
|
||||
|
||||
```bash
|
||||
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
|
||||
```
|
||||
|
||||
4. Use the following command to add the **stable** repository:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager \
|
||||
--add-repo \
|
||||
<DOCKER-EE-URL>/centos/docker-ee.repo
|
||||
```
|
||||
{% include ee-linux-install-reuse.md section="set-up-yum-repo" %}
|
||||
|
||||
#### Install Docker EE
|
||||
|
||||
1. Update the `yum` package index.
|
||||
|
||||
```bash
|
||||
$ sudo yum makecache fast
|
||||
```
|
||||
|
||||
If this is the first time you have refreshed the package index since adding
|
||||
the Docker repositories, you will be prompted to accept the GPG key, and
|
||||
the key's fingerprint will be shown. Verify that the fingerprint is
|
||||
correct, and if so, accept the key. The fingerprint should match
|
||||
`DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`.
|
||||
|
||||
2. Install the latest version of Docker EE, or go to the next step to install a
|
||||
specific version.
|
||||
|
||||
```bash
|
||||
$ sudo yum install docker-ee
|
||||
```
|
||||
|
||||
> **Warning**: If you have multiple Docker repositories enabled, installing
|
||||
> or updating without specifying a version in the `yum install` or
|
||||
> `yum update` command will always install the highest possible version,
|
||||
> which may not be appropriate for your stability needs.
|
||||
{:.warning}
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
3. On production systems, you should install a specific version of Docker EE
|
||||
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.
|
||||
|
||||
> **Note**: This `yum list` command only shows binary packages. To show
|
||||
> source packages as well, omit the `.x86_64` from the package name.
|
||||
|
||||
```bash
|
||||
$ yum list docker-ee.x86_64 --showduplicates | sort -r
|
||||
|
||||
docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable
|
||||
```
|
||||
|
||||
The contents of the list depend upon which repositories are enabled, and
|
||||
will be 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. 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 (`-`):
|
||||
|
||||
```bash
|
||||
$ sudo yum install docker-ee-<VERSION>
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
|
||||
that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
5. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**. Do not skip this step.
|
||||
|
||||
6. Start Docker.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
7. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker commands.
|
||||
Continue to [Linux postinstall](/engine/installation/linux/linux-postinstall.md)
|
||||
to allow non-privileged users to run Docker commands and for other optional
|
||||
configuration steps.
|
||||
{% include ee-linux-install-reuse.md section="install-using-yum-repo" %}
|
||||
|
||||
#### Upgrade Docker EE
|
||||
|
||||
To upgrade Docker EE:
|
||||
|
||||
1. If upgrading to a new major Docker EE version (such as when going from
|
||||
Docker 17.03.x to Docker 17.06.x),
|
||||
[add the new repository](#set-up-the-repository){: target="_blank" class="_" }.
|
||||
|
||||
2. Run `sudo yum makecache fast`.
|
||||
|
||||
3. Follow the
|
||||
[installation instructions](#install-docker), choosing the new version you want
|
||||
to install.
|
||||
{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %}
|
||||
|
||||
### Install from a package
|
||||
|
||||
If you cannot use Docker's repository to install Docker EE, you can download the
|
||||
`.rpm` file for your release and install it manually. You will need to download
|
||||
a new file each time you want to upgrade Docker.
|
||||
|
||||
1. Go to the Docker EE repository URL associated with your trial or
|
||||
subscription in your browser. Go to
|
||||
`centos/7/x86_64/stable-{{ minor-version }}/Packages/` and download the
|
||||
`.rpm` file for the Docker version you want to install.
|
||||
|
||||
2. Install Docker EE, changing the path below to the path where you downloaded
|
||||
the Docker EE package.
|
||||
|
||||
```bash
|
||||
$ sudo yum install /path/to/package.rpm
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
|
||||
that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
4. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**. Do not skip this step.
|
||||
|
||||
5. Start Docker.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
6. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker commands.
|
||||
Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
|
||||
non-privileged users to run Docker commands and for other optional configuration
|
||||
steps.
|
||||
{% include ee-linux-install-reuse.md section="install-using-yum-package" %}
|
||||
|
||||
#### Upgrade Docker EE
|
||||
|
||||
To upgrade Docker EE, download the newer package file and repeat the
|
||||
[installation procedure](#install-from-a-package), using `yum -y upgrade`
|
||||
instead of `yum -y install`, and pointing to the new file.
|
||||
{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %}
|
||||
|
||||
## Uninstall Docker EE
|
||||
|
||||
1. Uninstall the Docker EE package:
|
||||
|
||||
```bash
|
||||
$ sudo yum remove docker-ee
|
||||
```
|
||||
|
||||
2. Images, containers, volumes, or customized configuration files on your host
|
||||
are not automatically removed. To delete all images, containers, and
|
||||
volumes:
|
||||
|
||||
```bash
|
||||
$ sudo rm -rf /var/lib/docker
|
||||
```
|
||||
|
||||
3. If desired, remove the `devicemapper` thin pool and reformat the block
|
||||
devices that were part of it.
|
||||
|
||||
You must delete any edited configuration files manually.
|
||||
{% include ee-linux-install-reuse.md section="yum-uninstall" %}
|
||||
|
||||
## Next steps
|
||||
|
||||
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
|
||||
|
||||
- Continue with the [User Guide](/engine/userguide/index.md).
|
||||
{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %}
|
||||
|
|
|
@ -8,45 +8,36 @@ title: Get Docker EE for Oracle Linux
|
|||
---
|
||||
|
||||
{% assign minor-version = "17.06" %}
|
||||
{% assign linux-dist = "oraclelinux" %}
|
||||
{% assign linux-dist-url-slug = "oraclelinux" %}
|
||||
{% assign linux-dist-long = "Oracle Linux" %}
|
||||
{% assign package-format = "RPM" %}
|
||||
{% assign gpg-fingerprint = "77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9" %}
|
||||
|
||||
To get started with Docker EE on Oracle Linux, make sure you
|
||||
To get started with Docker EE on {{ linux-dist-long }}, make sure you
|
||||
[meet the prerequisites](#prerequisites), then
|
||||
[install Docker](#install-docker-ee).
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Docker Community Edition (Docker CE) is not supported on Oracle Linux.
|
||||
Docker Community Edition (Docker CE) is not supported on {{ linux-dist-long }}.
|
||||
|
||||
### Docker EE repository URL
|
||||
|
||||
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
|
||||
repository URL associated with your trial or subscription. These instructions
|
||||
work for Docker EE for Oracle Linux and for Docker EE for Linux, which includes
|
||||
access to Docker EE for all Linux distributions.To get this information:
|
||||
|
||||
- Go to [https://store.docker.com/my-content](https://store.docker.com/my-content).
|
||||
- Each subscription or trial you have access to is listed. Click the **Setup**
|
||||
button for **Docker Enterprise Edition for Oracle Linux**.
|
||||
- Copy the URL from the field labeled
|
||||
**Copy and paste this URL to download your Edition**.
|
||||
|
||||
Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
|
||||
|
||||
To learn more about Docker EE, see
|
||||
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
|
||||
{% include ee-linux-install-reuse.md section="ee-url-intro" %}
|
||||
|
||||
### OS requirements
|
||||
|
||||
To install Docker EE, you need the 64-bit version of Oracle Linux 7.3 running the
|
||||
Red Hat Compatible kernel (RHCK) 3.10.0-514 or higher. Older versions of Oracle
|
||||
Linux are not supported.
|
||||
To install Docker EE, you need the 64-bit version of {{ linux-dist-long }} 7.3
|
||||
or higher, running the Red Hat Compatible kernel (RHCK) 3.10.0-514 or higher.
|
||||
Older versions of {{ linux-dist-long }} are not supported.
|
||||
|
||||
In addition, you must use the `devicemapper` storage driver if you use
|
||||
Docker EE. On production systems, you must use `direct-lvm` mode, which
|
||||
requires one or more dedicated block devices. Fast storage such as solid-state
|
||||
media (SSD) is recommended.
|
||||
|
||||
> **Docker EE will not install on Oracle Linux with `selinux` enabled!**
|
||||
> **Docker EE will not install on {{ linux-dist }} with `selinux` enabled!**
|
||||
>
|
||||
> If you have `selinux` enabled and you attempt to install Docker EE 17.06.1,
|
||||
> you will get an error that the `container-selinux` package cannot be found.
|
||||
|
@ -70,16 +61,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`.
|
|||
|
||||
## Install Docker EE
|
||||
|
||||
You can install Docker EE in different ways, depending on your needs:
|
||||
|
||||
- Most users
|
||||
[set up Docker's repositories](#install-using-the-repository) and install
|
||||
from them, for ease of installation and upgrade tasks. This is the
|
||||
recommended approach.
|
||||
|
||||
- Some users download the RPM package and install it manually and manage
|
||||
upgrades completely manually. This is useful in situations such as installing
|
||||
Docker on air-gapped systems with no access to the internet.
|
||||
{% include ee-linux-install-reuse.md section="ways-to-install" %}
|
||||
|
||||
### Install using the repository
|
||||
|
||||
|
@ -89,215 +71,28 @@ from the repository.
|
|||
|
||||
#### Set up the repository
|
||||
|
||||
1. Remove any existing Docker repositories from `/etc/yum.repos.d/`.
|
||||
|
||||
2. Store your EE repository URL in `/etc/yum/vars/dockerurl`. Replace
|
||||
`<DOCKER-EE-URL>` with the URL you noted down in the
|
||||
[prerequisites](#prerequisites).
|
||||
|
||||
```bash
|
||||
$ sudo sh -c 'echo "<DOCKER-EE-URL>/oraclelinux" > /etc/yum/vars/dockerurl'
|
||||
```
|
||||
|
||||
3. Install required packages. `yum-utils` provides the `yum-config-manager`
|
||||
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
|
||||
`devicemapper` storage driver.
|
||||
|
||||
```bash
|
||||
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2 container-selinux
|
||||
```
|
||||
|
||||
4. Use the following command to add the **stable** repository:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager \
|
||||
--add-repo \
|
||||
<DOCKER-EE-URL>/oraclelinux/docker-ee.repo
|
||||
```
|
||||
{% include ee-linux-install-reuse.md section="set-up-yum-repo" %}
|
||||
|
||||
#### Install Docker EE
|
||||
|
||||
1. Update the `yum` package index.
|
||||
|
||||
```bash
|
||||
$ sudo yum makecache fast
|
||||
```
|
||||
|
||||
If this is the first time you have refreshed the package index since adding
|
||||
the Docker repositories, you will be prompted to accept the GPG key, and
|
||||
the key's fingerprint will be shown. Verify that the fingerprint matches
|
||||
`77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9` and if so, accept the
|
||||
key.
|
||||
|
||||
2. Install the latest version of Docker EE, or go to the next step to install a
|
||||
specific version.
|
||||
|
||||
```bash
|
||||
$ sudo yum -y install docker-ee
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
3. On production systems, you should install a specific version of Docker
|
||||
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. The output is truncated.
|
||||
|
||||
> **Note**: This `yum list` command only shows binary packages. To show
|
||||
> source packages as well, omit the `.x86_64` from the package name.
|
||||
|
||||
```bash
|
||||
$ yum list docker-ee.x86_64 --showduplicates | sort -r
|
||||
|
||||
docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable
|
||||
```
|
||||
|
||||
The contents of the list depend upon which repositories you have 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 a hyphen (`-`):
|
||||
|
||||
```bash
|
||||
$ sudo yum -y install docker-ee-<VERSION_STRING>
|
||||
```
|
||||
|
||||
4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
|
||||
that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
5. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**.
|
||||
|
||||
6. Start the Docker daemon.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
7. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker
|
||||
commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
|
||||
non-privileged users to run Docker commands and for other optional configuration
|
||||
steps.
|
||||
{% include ee-linux-install-reuse.md section="install-using-yum-repo" %}
|
||||
|
||||
#### Upgrade Docker EE
|
||||
|
||||
To upgrade Docker EE:
|
||||
|
||||
1. If upgrading to a new major Docker EE version (such as when going from
|
||||
Docker 17.03.x to Docker 17.06.x),
|
||||
[add the new repository](#set-up-the-repository){: target="_blank" class="_" }.
|
||||
|
||||
2. Run `sudo yum makecache fast`.
|
||||
|
||||
3. Follow the
|
||||
[installation instructions](#install-docker), choosing the new version you want
|
||||
to install.
|
||||
{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %}
|
||||
|
||||
### Install from a package
|
||||
|
||||
If you cannot use the official Docker repository to install Docker EE, you can
|
||||
download the `.rpm` file for your release and install it manually. You will
|
||||
need to download a new file each time you want to upgrade Docker EE.
|
||||
|
||||
1. Go to the Docker EE repository URL associated with your
|
||||
trial or subscription in your browser. Browse to
|
||||
`oraclelinux/7/x86_64/stable-{{ minor-version }}/Packages` and download the
|
||||
`.rpm` file for the Docker version you want to install.
|
||||
|
||||
2. Install Docker EE, changing the path below to the path where you downloaded
|
||||
the Docker package.
|
||||
|
||||
```bash
|
||||
$ sudo yum install /path/to/package.rpm
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
|
||||
that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
4. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**.
|
||||
|
||||
5. Start the Docker daemon.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
6. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker
|
||||
commands. Continue to [Post-installation steps for Linux](linux-postinstall.md)
|
||||
to allow non-privileged users to run Docker commands and for other optional
|
||||
configuration steps.
|
||||
{% include ee-linux-install-reuse.md section="install-using-yum-package" %}
|
||||
|
||||
#### Upgrade Docker EE
|
||||
|
||||
To upgrade Docker EE, download the newer package file and repeat the
|
||||
[installation procedure](#install-from-a-package), using `yum -y upgrade`
|
||||
instead of `yum -y install`, and pointing to the new file.
|
||||
{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %}
|
||||
|
||||
## Uninstall Docker EE
|
||||
|
||||
1. Uninstall the Docker EE package:
|
||||
|
||||
```bash
|
||||
$ sudo yum remove docker-ee
|
||||
```
|
||||
|
||||
2. Images, containers, volumes, or customized configuration files on your host
|
||||
are not automatically removed. To delete all images, containers, and
|
||||
volumes:
|
||||
|
||||
```bash
|
||||
$ sudo rm -rf /var/lib/docker
|
||||
```
|
||||
|
||||
3. If desired, remove the `devicemapper` thin pool and reformat the block
|
||||
devices that were part of it.
|
||||
|
||||
You must delete any edited configuration files manually.
|
||||
{% include ee-linux-install-reuse.md section="yum-uninstall" %}
|
||||
|
||||
## Next steps
|
||||
|
||||
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
|
||||
|
||||
- Continue with the [User Guide](/engine/userguide/index.md).
|
||||
{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %}
|
||||
|
|
|
@ -9,37 +9,26 @@ title: Get Docker EE for Red Hat Enterprise Linux
|
|||
---
|
||||
|
||||
{% assign minor-version = "17.06" %}
|
||||
{% assign linux-dist = "rhel" %}
|
||||
{% assign linux-dist-url-slug = "rhel" %}
|
||||
{% assign linux-dist-long = "Red Hat Enterprise Linux" %}
|
||||
{% assign package-format = "RPM" %}
|
||||
{% assign gpg-fingerprint = "77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9" %}
|
||||
|
||||
To get started with Docker EE on Red Hat Enterprise Linux (RHEL), make sure you
|
||||
[meet the prerequisites](#prerequisites), then
|
||||
[install Docker](#install-docker-ee).
|
||||
{% include ee-linux-install-reuse.md section="ee-install-intro" %}
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Docker Community Edition (Docker CE) is not supported on RHEL.
|
||||
Docker Community Edition (Docker CE) is not supported on {{ linux-dist-long }}.
|
||||
|
||||
### Docker EE repository URL
|
||||
|
||||
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
|
||||
repository URL associated with your trial or subscription. These instructions
|
||||
work for Docker EE for RHEL and for Docker EE for Linux, which includes access
|
||||
to Docker EE for all Linux distributions. To get this information:
|
||||
|
||||
- Go to [https://store.docker.com/my-content](https://store.docker.com/my-content).
|
||||
- Each subscription or trial you have access to is listed. Click the **Setup**
|
||||
button for **Docker Enterprise Edition for Red Hat Enterprise Linux**.
|
||||
- Copy the URL from the field labeled
|
||||
**Copy and paste this URL to download your Edition**.
|
||||
|
||||
Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
|
||||
|
||||
To learn more about Docker EE, see
|
||||
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
|
||||
{% include ee-linux-install-reuse.md section="ee-url-intro" %}
|
||||
|
||||
### OS requirements
|
||||
|
||||
To install Docker EE, you need the 64-bit version of RHEL 7 running on an x86
|
||||
hardware platform, or `s390x` (IBM Z) architecture.
|
||||
To install Docker EE, you need the 64-bit version of {{ linux-dist-long }} 7
|
||||
running on an x86 hardware platform, or `s390x` (IBM Z) architecture.
|
||||
|
||||
In addition, you must use the `devicemapper` storage driver. On production
|
||||
systems, you must use `direct-lvm` mode, which requires one or more dedicated
|
||||
|
@ -65,16 +54,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`.
|
|||
|
||||
## Install Docker EE
|
||||
|
||||
You can install Docker EE in different ways, depending on your needs:
|
||||
|
||||
- Most users
|
||||
[set up Docker's repositories](#install-using-the-repository) and install
|
||||
from them, for ease of installation and upgrade tasks. This is the
|
||||
recommended approach.
|
||||
|
||||
- Some users download the RPM package and install it manually and manage
|
||||
upgrades completely manually. This is useful in situations such as installing
|
||||
Docker on air-gapped systems with no access to the internet.
|
||||
{% include ee-linux-install-reuse.md section="ways-to-install" %}
|
||||
|
||||
### Install using the repository
|
||||
|
||||
|
@ -84,271 +64,28 @@ from the repository.
|
|||
|
||||
#### Set up the repository
|
||||
|
||||
1. Remove any existing Docker repositories from `/etc/yum.repos.d/`.
|
||||
|
||||
2. Store two `yum` variables in `/etc/yum/vars/`.
|
||||
|
||||
- Store your EE repository URL in `/etc/yum/vars/dockerurl`. Replace
|
||||
`<DOCKER-EE-URL>` with the URL you noted down in the
|
||||
[prerequisites](#prerequisites).
|
||||
|
||||
```bash
|
||||
$ sudo sh -c 'echo "<DOCKER-EE-URL>/rhel" > /etc/yum/vars/dockerurl'
|
||||
```
|
||||
|
||||
- Store your RHEL version string in `/etc/yum/vars/dockerosversion`.
|
||||
Use the appropriate value from the following table. Most users should use
|
||||
`7`.
|
||||
|
||||
| Version string | Description |
|
||||
|----------------|-------------|
|
||||
| `7` | Unless you have specific requirements, you should use this version. Dependencies are not locked to specific versions but use the latest available version. |
|
||||
| `7.3` | Dependencies are locked to specific packages for RHEL 7.3. |
|
||||
| `7.2` | Dependencies are locked to specific packages for RHEL 7.2. |
|
||||
|
||||
```bash
|
||||
$ sudo sh -c 'echo "<VERSION-STRING>" > /etc/yum/vars/dockerosversion'
|
||||
```
|
||||
|
||||
3. Install required packages. `yum-utils` provides the `yum-config-manager`
|
||||
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
|
||||
`devicemapper` storage driver.
|
||||
|
||||
```bash
|
||||
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
|
||||
```
|
||||
|
||||
4. Enable the `extras` RHEL repository. This ensures access to the
|
||||
`container-selinux` package which is required by `docker-ee`.
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhel-7-server-extras-rpms
|
||||
```
|
||||
|
||||
Depending on cloud provider, you may also need to enable another repository.
|
||||
|
||||
For AWS:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhui-REGION-rhel-server-extras
|
||||
```
|
||||
|
||||
> **Note**: `REGION` here is literal, and does *not* represent the region
|
||||
> your machine is running in.
|
||||
|
||||
For Azure:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhui-rhel-7-server-rhui-extras-rpms
|
||||
```
|
||||
|
||||
5. Use the following command to add the **stable** repository:
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager \
|
||||
--add-repo \
|
||||
<DOCKER-EE-URL>/rhel/docker-ee.repo
|
||||
```
|
||||
{% include ee-linux-install-reuse.md section="set-up-yum-repo" %}
|
||||
|
||||
#### Install Docker EE
|
||||
|
||||
1. Update the `yum` package index.
|
||||
|
||||
```bash
|
||||
$ sudo yum makecache fast
|
||||
```
|
||||
|
||||
If this is the first time you have refreshed the package index since adding
|
||||
the Docker repositories, you will be prompted to accept the GPG key, and
|
||||
the key's fingerprint will be shown. Verify that the fingerprint matches
|
||||
`DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96` and if so, accept the
|
||||
key.
|
||||
|
||||
2. Install the latest version of Docker EE, or go to the next step to install a
|
||||
specific version.
|
||||
|
||||
```bash
|
||||
$ sudo yum -y install docker-ee
|
||||
```
|
||||
|
||||
3. On production systems, you should install a specific version of Docker EE
|
||||
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.
|
||||
|
||||
> **Note**: This `yum list` command only shows binary packages. To show
|
||||
> source packages as well, omit the `.x86_64` from the package name.
|
||||
|
||||
```bash
|
||||
$ yum list docker-ee.x86_64 --showduplicates | sort -r
|
||||
|
||||
docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable
|
||||
```
|
||||
|
||||
The contents of the list depend upon which repositories you have enabled,
|
||||
and will be specific to your version of RHEL (indicated by the `.el7` 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 (`-`):
|
||||
|
||||
```bash
|
||||
$ sudo yum -y install docker-ee-<VERSION_STRING>
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
|
||||
that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
5. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**.
|
||||
|
||||
6. Start Docker.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
7. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker
|
||||
commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
|
||||
non-privileged users to run Docker commands and for other optional configuration
|
||||
steps.
|
||||
{% include ee-linux-install-reuse.md section="install-using-yum-repo" %}
|
||||
|
||||
#### Upgrade Docker EE
|
||||
|
||||
To upgrade Docker EE:
|
||||
|
||||
1. If upgrading to a new major Docker EE version (such as when going from
|
||||
Docker 17.03.x to Docker 17.06.x),
|
||||
[add the new repository](#set-up-the-repository){: target="_blank" class="_" }.
|
||||
|
||||
2. Run `sudo yum makecache fast`.
|
||||
|
||||
3. Follow the
|
||||
[installation instructions](#install-docker), choosing the new version you want
|
||||
to install.
|
||||
{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %}
|
||||
|
||||
### Install from a package
|
||||
|
||||
If you cannot use the official Docker repository to install Docker EE, you can
|
||||
download the `.rpm` file for your release and install it manually. You will
|
||||
need to download a new file each time you want to upgrade Docker EE.
|
||||
|
||||
1. Enable the `extras` RHEL repository. This ensures access to the
|
||||
`container-selinux` package which is required by `docker-ee`.
|
||||
|
||||
```bash
|
||||
$ sudo yum-config-manager --enable rhel-7-server-extras-rpms
|
||||
```
|
||||
|
||||
Alternately, obtain that package manually from Red Hat.
|
||||
There is no way to publicly browse this repository.
|
||||
|
||||
1. Go to the Docker EE repository URL associated with your
|
||||
trial or subscription in your browser. Go to
|
||||
`rhel/7/x86_64/stable-{{ minor-version }}/Packages` and download the `.rpm`
|
||||
file for the Docker version you want to install.
|
||||
|
||||
> **Note**: If you have trouble with `selinux` using the packages under the
|
||||
> `7` directory, try choosing the version-specific directory instead, such
|
||||
> as `7.3`.
|
||||
|
||||
2. Install Docker EE, changing the path below to the path where you downloaded
|
||||
the Docker package.
|
||||
|
||||
```bash
|
||||
$ sudo yum install /path/to/package.rpm
|
||||
```
|
||||
|
||||
Docker is installed but not started. The `docker` group is created, but no
|
||||
users are added to the group.
|
||||
|
||||
3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
|
||||
that the file was empty, add the following contents.
|
||||
|
||||
```json
|
||||
{
|
||||
"storage-driver": "devicemapper"
|
||||
}
|
||||
```
|
||||
|
||||
4. For production systems, you must use `direct-lvm` mode, which requires you
|
||||
to prepare the block devices. Follow the procedure in the
|
||||
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
|
||||
**before starting Docker**.
|
||||
|
||||
5. Start Docker.
|
||||
|
||||
```bash
|
||||
$ sudo systemctl start docker
|
||||
```
|
||||
|
||||
6. Verify that Docker EE is installed correctly by running the `hello-world`
|
||||
image.
|
||||
|
||||
```bash
|
||||
$ sudo docker run hello-world
|
||||
```
|
||||
|
||||
This command downloads a test image and runs it in a container. When the
|
||||
container runs, it prints an informational message and exits.
|
||||
|
||||
Docker EE is installed and running. You need to use `sudo` to run Docker
|
||||
commands. Continue to [Post-installation steps for Linux](linux-postinstall.md)
|
||||
to allow non-privileged users to run Docker commands and for other optional
|
||||
configuration steps.
|
||||
{% include ee-linux-install-reuse.md section="install-using-yum-package" %}
|
||||
|
||||
#### Upgrade Docker EE
|
||||
|
||||
To upgrade Docker EE, download the newer package file and repeat the
|
||||
[installation procedure](#install-from-a-package), using `yum -y upgrade`
|
||||
instead of `yum -y install`, and pointing to the new file.
|
||||
|
||||
{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %}
|
||||
|
||||
## Uninstall Docker EE
|
||||
|
||||
1. Uninstall the Docker EE package:
|
||||
|
||||
```bash
|
||||
$ sudo yum -y remove docker-ee
|
||||
```
|
||||
|
||||
2. Images, containers, volumes, or customized configuration files on your host
|
||||
are not automatically removed. To delete all images, containers, and
|
||||
volumes:
|
||||
|
||||
```bash
|
||||
$ sudo rm -rf /var/lib/docker
|
||||
```
|
||||
|
||||
3. If desired, remove the `devicemapper` thin pool and reformat the block
|
||||
devices that were part of it.
|
||||
|
||||
You must delete any edited configuration files manually.
|
||||
{% include ee-linux-install-reuse.md section="yum-uninstall" %}
|
||||
|
||||
## Next steps
|
||||
|
||||
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
|
||||
|
||||
- Continue with the [User Guide](/engine/userguide/index.md).
|
||||
{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %}
|
||||
|
|
|
@ -118,15 +118,17 @@ from the repository.
|
|||
$ curl -fsSL <DOCKER-EE-URL>/ubuntu/gpg | sudo apt-key add -
|
||||
```
|
||||
|
||||
Verify that the key fingerprint is `DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`.
|
||||
Verify that you now have the key with the fingerprint
|
||||
`DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`, by searching for the
|
||||
last 8 characters of the fingerprint.
|
||||
|
||||
```bash
|
||||
$ apt-key fingerprint 6D085F96
|
||||
$ sudo apt-key fingerprint 6D085F96
|
||||
|
||||
pub 4096R/6D085F96 2017-02-22
|
||||
Key fingerprint = DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96
|
||||
uid [ultimate] Docker Release (EE deb) <docker@docker.com>
|
||||
sub 4096R/91A29FA3 2017-02-22
|
||||
pub 4096R/0EBFCD88 2017-02-22
|
||||
Key fingerprint = DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96
|
||||
uid Docker Release (CE deb) <docker@docker.com>
|
||||
sub 4096R/6D085F96 2017-02-22
|
||||
```
|
||||
|
||||
4. Use the following command to set up the **stable** repository, replacing
|
||||
|
|
Loading…
Reference in New Issue