mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
Merge pull request #26706 from thaJeztah/update-systemd-instructions
Cleanup / sync RHEL, CentOS, Fedora installation docs
This commit is contained in:
commit
920cb5834b
3 changed files with 365 additions and 217 deletions
|
@ -16,114 +16,151 @@ Docker runs on CentOS 7.X. An installation on other binary compatible EL7
|
||||||
distributions such as Scientific Linux might succeed, but Docker does not test
|
distributions such as Scientific Linux might succeed, but Docker does not test
|
||||||
or support Docker on these distributions.
|
or support Docker on these distributions.
|
||||||
|
|
||||||
This page instructs you to install using Docker-managed release packages and
|
These instructions install Docker using release packages and installation
|
||||||
installation mechanisms. Using these packages ensures you get the latest release
|
mechanisms managed by Docker, to be sure that you get the latest version
|
||||||
of Docker. If you wish to install using CentOS-managed packages, consult your
|
of Docker. If you wish to install using CentOS-managed packages, consult
|
||||||
CentOS documentation.
|
your CentOS release documentation.
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
Docker requires a 64-bit installation regardless of your CentOS version. Also,
|
Docker requires a 64-bit OS and version 3.10 or higher of the Linux kernel.
|
||||||
your kernel must be 3.10 at minimum, which CentOS 7 runs.
|
|
||||||
|
|
||||||
To check your current kernel version, open a terminal and use `uname -r` to
|
To check your current kernel version, open a terminal and use `uname -r` to
|
||||||
display your kernel version:
|
display your kernel version:
|
||||||
|
|
||||||
$ uname -r
|
```bash
|
||||||
3.10.0-229.el7.x86_64
|
$ uname -r
|
||||||
|
3.10.0-229.el7.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
Finally, it is recommended that you fully update your system. Please keep in
|
Finally, it is recommended that you fully update your system. Keep in mind
|
||||||
mind that your system should be fully patched to fix any potential kernel bugs.
|
that your system should be fully patched to fix any potential kernel bugs.
|
||||||
Any reported kernel bugs may have already been fixed on the latest kernel
|
Any reported kernel bugs may have already been fixed on the latest kernel
|
||||||
packages.
|
packages.
|
||||||
|
|
||||||
## Install
|
## Install Docker Engine
|
||||||
|
|
||||||
There are two ways to install Docker Engine. You can install using the `yum`
|
There are two ways to install Docker Engine. You can [install using the `yum`
|
||||||
package manager. Or you can use `curl` with the `get.docker.com` site. This
|
package manager](#install-with-yum). Or you can use `curl` with the [`get.docker.com`
|
||||||
second method runs an installation script which also installs via the `yum`
|
site](#install-with-the-script). This second method runs an installation script
|
||||||
package manager.
|
which also installs via the `yum` package manager.
|
||||||
|
|
||||||
### Install with yum
|
### Install with yum
|
||||||
|
|
||||||
1. Log into your machine as a user with `sudo` or `root` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Make sure your existing yum packages are up-to-date.
|
2. Make sure your existing packages are up-to-date.
|
||||||
|
|
||||||
$ sudo yum update
|
```bash
|
||||||
|
$ sudo yum update
|
||||||
|
```
|
||||||
|
|
||||||
3. Add the yum repo.
|
3. Add the `yum` repo.
|
||||||
|
|
||||||
$ sudo tee /etc/yum.repos.d/docker.repo <<-'EOF'
|
```bash
|
||||||
[dockerrepo]
|
$ sudo tee /etc/yum.repos.d/docker.repo <<-'EOF'
|
||||||
name=Docker Repository
|
[dockerrepo]
|
||||||
baseurl=https://yum.dockerproject.org/repo/main/centos/7/
|
name=Docker Repository
|
||||||
enabled=1
|
baseurl=https://yum.dockerproject.org/repo/main/centos/7/
|
||||||
gpgcheck=1
|
enabled=1
|
||||||
gpgkey=https://yum.dockerproject.org/gpg
|
gpgcheck=1
|
||||||
EOF
|
gpgkey=https://yum.dockerproject.org/gpg
|
||||||
|
EOF
|
||||||
|
```
|
||||||
|
|
||||||
4. Install the Docker package.
|
4. Install the Docker package.
|
||||||
|
|
||||||
$ sudo yum install docker-engine
|
```bash
|
||||||
|
$ sudo yum install docker-engine
|
||||||
|
```
|
||||||
|
|
||||||
5. Start the Docker daemon.
|
5. Enable the service.
|
||||||
|
|
||||||
$ sudo service docker start
|
```bash
|
||||||
|
$ sudo systemctl enable docker.service
|
||||||
|
```
|
||||||
|
|
||||||
6. Verify `docker` is installed correctly by running a test image in a container.
|
6. Start the Docker daemon.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ sudo systemctl start docker
|
||||||
|
```
|
||||||
|
|
||||||
|
7. Verify `docker` is installed correctly by running a test image in a container.
|
||||||
|
|
||||||
|
$ sudo docker run --rm hello-world
|
||||||
|
|
||||||
$ sudo docker run hello-world
|
|
||||||
Unable to find image 'hello-world:latest' locally
|
Unable to find image 'hello-world:latest' locally
|
||||||
latest: Pulling from hello-world
|
latest: Pulling from library/hello-world
|
||||||
a8219747be10: Pull complete
|
c04b14da8d14: Pull complete
|
||||||
91c95931e552: Already exists
|
Digest: sha256:0256e8a36e2070f7bf2d0b0763dbabdd67798512411de4cdcf9431a1feb60fd9
|
||||||
hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
|
Status: Downloaded newer image for hello-world:latest
|
||||||
Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d
|
|
||||||
Status: Downloaded newer image for hello-world:latest
|
|
||||||
Hello from Docker.
|
|
||||||
This message shows that your installation appears to be working correctly.
|
|
||||||
|
|
||||||
To generate this message, Docker took the following steps:
|
Hello from Docker!
|
||||||
1. The Docker client contacted the Docker daemon.
|
This message shows that your installation appears to be working correctly.
|
||||||
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
|
||||||
(Assuming it was not already locally available.)
|
|
||||||
3. The Docker daemon created a new container from that image which runs the
|
|
||||||
executable that produces the output you are currently reading.
|
|
||||||
4. The Docker daemon streamed that output to the Docker client, which sent it
|
|
||||||
to your terminal.
|
|
||||||
|
|
||||||
To try something more ambitious, you can run an Ubuntu container with:
|
To generate this message, Docker took the following steps:
|
||||||
$ docker run -it ubuntu bash
|
1. The Docker client contacted the Docker daemon.
|
||||||
|
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
||||||
|
3. The Docker daemon created a new container from that image which runs the
|
||||||
|
executable that produces the output you are currently reading.
|
||||||
|
4. The Docker daemon streamed that output to the Docker client, which sent it
|
||||||
|
to your terminal.
|
||||||
|
|
||||||
For more examples and ideas, visit:
|
To try something more ambitious, you can run an Ubuntu container with:
|
||||||
http://docs.docker.com/userguide/
|
$ docker run -it ubuntu bash
|
||||||
|
|
||||||
|
Share images, automate workflows, and more with a free Docker Hub account:
|
||||||
|
https://hub.docker.com
|
||||||
|
|
||||||
|
For more examples and ideas, visit:
|
||||||
|
https://docs.docker.com/engine/userguide/
|
||||||
|
|
||||||
|
If you need to add an HTTP Proxy, set a different directory or partition for the
|
||||||
|
Docker runtime files, or make other customizations, read our Systemd article to
|
||||||
|
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
||||||
|
|
||||||
### Install with the script
|
### Install with the script
|
||||||
|
|
||||||
|
|
||||||
1. Log into your machine as a user with `sudo` or `root` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Make sure your existing yum packages are up-to-date.
|
2. Make sure your existing packages are up-to-date.
|
||||||
|
|
||||||
$ sudo yum update
|
```bash
|
||||||
|
$ sudo yum update
|
||||||
|
```
|
||||||
|
|
||||||
3. Run the Docker installation script.
|
3. Run the Docker installation script.
|
||||||
|
|
||||||
$ curl -fsSL https://get.docker.com/ | sh
|
```bash
|
||||||
|
$ curl -fsSL https://get.docker.com/ | sh
|
||||||
|
```
|
||||||
|
|
||||||
This script adds the `docker.repo` repository and installs Docker.
|
This script adds the `docker.repo` repository and installs Docker.
|
||||||
|
|
||||||
4. Start the Docker daemon.
|
4. Enable the service.
|
||||||
|
|
||||||
$ sudo service docker start
|
```bash
|
||||||
|
$ sudo systemctl enable docker.service
|
||||||
|
```
|
||||||
|
|
||||||
5. Verify `docker` is installed correctly by running a test image in a container.
|
5. Start the Docker daemon.
|
||||||
|
|
||||||
$ sudo docker run hello-world
|
```bash
|
||||||
|
$ sudo systemctl start docker
|
||||||
|
```
|
||||||
|
|
||||||
|
6. Verify `docker` is installed correctly by running a test image in a container.
|
||||||
|
|
||||||
## Create a docker group
|
```bash
|
||||||
|
$ sudo docker run hello-world
|
||||||
|
```
|
||||||
|
|
||||||
|
If you need to add an HTTP Proxy, set a different directory or partition for the
|
||||||
|
Docker runtime files, or make other customizations, read our Systemd article to
|
||||||
|
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
||||||
|
|
||||||
|
## Create a docker group
|
||||||
|
|
||||||
The `docker` daemon binds to a Unix socket instead of a TCP port. By default
|
The `docker` daemon binds to a Unix socket instead of a TCP port. By default
|
||||||
that Unix socket is owned by the user `root` and other users can access it with
|
that Unix socket is owned by the user `root` and other users can access it with
|
||||||
|
@ -139,54 +176,63 @@ makes the ownership of the Unix socket read/writable by the `docker` group.
|
||||||
|
|
||||||
To create the `docker` group and add your user:
|
To create the `docker` group and add your user:
|
||||||
|
|
||||||
1. Log into Centos as a user with `sudo` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Create the `docker` group.
|
2. Create the `docker` group.
|
||||||
|
|
||||||
`sudo groupadd docker`
|
```bash
|
||||||
|
$ sudo groupadd docker
|
||||||
|
```
|
||||||
|
|
||||||
3. Add your user to `docker` group.
|
3. Add your user to `docker` group.
|
||||||
|
|
||||||
`sudo usermod -aG docker your_username`
|
```bash
|
||||||
|
$ sudo usermod -aG docker your_username`
|
||||||
|
```
|
||||||
|
|
||||||
4. Log out and log back in.
|
4. Log out and log back in.
|
||||||
|
|
||||||
This ensures your user is running with the correct permissions.
|
This ensures your user is running with the correct permissions.
|
||||||
|
|
||||||
5. Verify your work by running `docker` without `sudo`.
|
5. Verify that your user is in the docker group by running `docker` without `sudo`.
|
||||||
|
|
||||||
$ docker run hello-world
|
```bash
|
||||||
|
$ docker run hello-world
|
||||||
|
```
|
||||||
|
|
||||||
## Start the docker daemon at boot
|
## Start the docker daemon at boot
|
||||||
|
|
||||||
To ensure Docker starts when you boot your system, do the following:
|
Configure the Docker daemon to start automatically when the host starts:
|
||||||
|
|
||||||
$ sudo chkconfig docker on
|
|
||||||
|
|
||||||
If you need to add an HTTP Proxy, set a different directory or partition for the
|
|
||||||
Docker runtime files, or make other customizations, read our Systemd article to
|
|
||||||
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ sudo systemctl enable docker
|
||||||
|
```
|
||||||
|
|
||||||
## Uninstall
|
## Uninstall
|
||||||
|
|
||||||
You can uninstall the Docker software with `yum`.
|
You can uninstall the Docker software with `yum`.
|
||||||
|
|
||||||
1. List the package you have installed.
|
1. List the installed Docker packages.
|
||||||
|
|
||||||
$ yum list installed | grep docker
|
```bash
|
||||||
yum list installed | grep docker
|
$ yum list installed | grep docker
|
||||||
docker-engine.x86_64 1.7.1-1.el7 @/docker-engine-1.7.1-1.el7.x86_64.rpm
|
|
||||||
|
docker-engine.x86_64 1.7.1-0.1.el7@/docker-engine-1.7.1-0.1.el7.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
2. Remove the package.
|
2. Remove the package.
|
||||||
|
|
||||||
$ sudo yum -y remove docker-engine.x86_64
|
```bash
|
||||||
|
$ sudo yum -y remove docker-engine.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
This command does not remove images, containers, volumes, or user-created
|
This command does not remove images, containers, volumes, or user-created
|
||||||
configuration files on your host.
|
configuration files on your host.
|
||||||
|
|
||||||
3. To delete all images, containers, and volumes, run the following command:
|
3. To delete all images, containers, and volumes, run the following command:
|
||||||
|
|
||||||
$ rm -rf /var/lib/docker
|
```bash
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
```
|
||||||
|
|
||||||
4. Locate and delete any user-created configuration files.
|
4. Locate and delete any user-created configuration files.
|
||||||
|
|
|
@ -12,80 +12,94 @@ weight=-3
|
||||||
|
|
||||||
# Fedora
|
# Fedora
|
||||||
|
|
||||||
Docker is supported on Fedora version 22, 23, and 24. This page instructs you to install
|
Docker is supported on Fedora version 22, 23, and 24. These instructions install
|
||||||
using Docker-managed release packages and installation mechanisms. Using these
|
Docker using release packages and installation mechanisms managed by Docker, to
|
||||||
packages ensures you get the latest release of Docker. If you wish to install
|
be sure that you get the latest version of Docker. If you wish to install using
|
||||||
using Fedora-managed packages, consult your Fedora release documentation for
|
Fedora-managed packages, consult your Fedora release documentation.
|
||||||
information on Fedora's Docker support.
|
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
Docker requires a 64-bit installation regardless of your Fedora version. Also, your kernel must be 3.10 at minimum. To check your current kernel
|
Docker requires a 64-bit OS and version 3.10 or higher of the Linux kernel.
|
||||||
version, open a terminal and use `uname -r` to display your kernel version:
|
|
||||||
|
|
||||||
$ uname -r
|
To check your current kernel version, open a terminal and use `uname -r` to
|
||||||
3.19.5-100.fc21.x86_64
|
display your kernel version:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ uname -r
|
||||||
|
3.19.5-100.fc21.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
If your kernel is at an older version, you must update it.
|
If your kernel is at an older version, you must update it.
|
||||||
|
|
||||||
Finally, is it recommended that you fully update your system. Please keep in
|
Finally, it is recommended that you fully update your system. Keep in mind
|
||||||
mind that your system should be fully patched to fix any potential kernel bugs. Any
|
that your system should be fully patched to fix any potential kernel bugs.
|
||||||
reported kernel bugs may have already been fixed on the latest kernel packages
|
Any reported kernel bugs may have already been fixed on the latest kernel
|
||||||
|
packages.
|
||||||
|
|
||||||
|
## Install Docker Engine
|
||||||
|
|
||||||
## Install
|
There are two ways to install Docker Engine. You can [install using the `dnf`
|
||||||
|
package manager](#install-with-dnf). Or you can use `curl` [with the `get.docker.com`
|
||||||
There are two ways to install Docker Engine. You can install with the `dnf` package manager. Or you can use `curl` with the `get.docker.com` site. This second method runs an installation script which also installs via the `dnf` package manager.
|
site](#install-with-the-script). This second method runs an installation script
|
||||||
|
which also installs via the `dnf` package manager.
|
||||||
|
|
||||||
### Install with DNF
|
### Install with DNF
|
||||||
|
|
||||||
1. Log into your machine as a user with `sudo` or `root` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Make sure your existing dnf packages are up-to-date.
|
2. Make sure your existing packages are up-to-date.
|
||||||
|
|
||||||
$ sudo dnf update
|
```bash
|
||||||
|
$ sudo dnf update
|
||||||
|
```
|
||||||
|
|
||||||
3. Add the yum repo yourself.
|
3. Add the `yum` repo.
|
||||||
|
|
||||||
$ sudo tee /etc/yum.repos.d/docker.repo <<-'EOF'
|
```bash
|
||||||
[dockerrepo]
|
$ sudo tee /etc/yum.repos.d/docker.repo <<-'EOF'
|
||||||
name=Docker Repository
|
[dockerrepo]
|
||||||
baseurl=https://yum.dockerproject.org/repo/main/fedora/$releasever/
|
name=Docker Repository
|
||||||
enabled=1
|
baseurl=https://yum.dockerproject.org/repo/main/fedora/$releasever/
|
||||||
gpgcheck=1
|
enabled=1
|
||||||
gpgkey=https://yum.dockerproject.org/gpg
|
gpgcheck=1
|
||||||
EOF
|
gpgkey=https://yum.dockerproject.org/gpg
|
||||||
|
EOF
|
||||||
|
```
|
||||||
|
|
||||||
4. Install the Docker package.
|
4. Install the Docker package.
|
||||||
|
|
||||||
$ sudo dnf install docker-engine
|
```bash
|
||||||
|
$ sudo dnf install docker-engine
|
||||||
|
```
|
||||||
|
|
||||||
5. Enable the service.
|
5. Enable the service.
|
||||||
|
|
||||||
$ sudo systemctl enable docker.service
|
```bash
|
||||||
|
$ sudo systemctl enable docker.service
|
||||||
|
```
|
||||||
|
|
||||||
6. Start the Docker daemon.
|
6. Start the Docker daemon.
|
||||||
|
|
||||||
$ sudo systemctl start docker
|
```bash
|
||||||
|
$ sudo systemctl start docker
|
||||||
|
```
|
||||||
|
|
||||||
7. Verify `docker` is installed correctly by running a test image in a container.
|
7. Verify `docker` is installed correctly by running a test image in a container.
|
||||||
|
|
||||||
|
$ sudo docker run --rm hello-world
|
||||||
|
|
||||||
$ sudo docker run hello-world
|
|
||||||
Unable to find image 'hello-world:latest' locally
|
Unable to find image 'hello-world:latest' locally
|
||||||
latest: Pulling from hello-world
|
latest: Pulling from library/hello-world
|
||||||
a8219747be10: Pull complete
|
c04b14da8d14: Pull complete
|
||||||
91c95931e552: Already exists
|
Digest: sha256:0256e8a36e2070f7bf2d0b0763dbabdd67798512411de4cdcf9431a1feb60fd9
|
||||||
hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
|
|
||||||
Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d
|
|
||||||
Status: Downloaded newer image for hello-world:latest
|
Status: Downloaded newer image for hello-world:latest
|
||||||
Hello from Docker.
|
|
||||||
|
Hello from Docker!
|
||||||
This message shows that your installation appears to be working correctly.
|
This message shows that your installation appears to be working correctly.
|
||||||
|
|
||||||
To generate this message, Docker took the following steps:
|
To generate this message, Docker took the following steps:
|
||||||
1. The Docker client contacted the Docker daemon.
|
1. The Docker client contacted the Docker daemon.
|
||||||
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
||||||
(Assuming it was not already locally available.)
|
|
||||||
3. The Docker daemon created a new container from that image which runs the
|
3. The Docker daemon created a new container from that image which runs the
|
||||||
executable that produces the output you are currently reading.
|
executable that produces the output you are currently reading.
|
||||||
4. The Docker daemon streamed that output to the Docker client, which sent it
|
4. The Docker daemon streamed that output to the Docker client, which sent it
|
||||||
|
@ -94,36 +108,57 @@ There are two ways to install Docker Engine. You can install with the `dnf` pac
|
||||||
To try something more ambitious, you can run an Ubuntu container with:
|
To try something more ambitious, you can run an Ubuntu container with:
|
||||||
$ docker run -it ubuntu bash
|
$ docker run -it ubuntu bash
|
||||||
|
|
||||||
For more examples and ideas, visit:
|
Share images, automate workflows, and more with a free Docker Hub account:
|
||||||
http://docs.docker.com/userguide/
|
https://hub.docker.com
|
||||||
|
|
||||||
|
For more examples and ideas, visit:
|
||||||
|
https://docs.docker.com/engine/userguide/
|
||||||
|
|
||||||
|
If you need to add an HTTP Proxy, set a different directory or partition for the
|
||||||
|
Docker runtime files, or make other customizations, read our Systemd article to
|
||||||
|
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
||||||
|
|
||||||
### Install with the script
|
### Install with the script
|
||||||
|
|
||||||
|
You use the same installation procedure for all versions of Fedora.
|
||||||
|
|
||||||
1. Log into your machine as a user with `sudo` or `root` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Make sure your existing dnf packages are up-to-date.
|
2. Make sure your existing packages are up-to-date.
|
||||||
|
|
||||||
$ sudo dnf update
|
```bash
|
||||||
|
$ sudo dnf update
|
||||||
|
```
|
||||||
|
|
||||||
3. Run the Docker installation script.
|
3. Run the Docker installation script.
|
||||||
|
|
||||||
$ curl -fsSL https://get.docker.com/ | sh
|
```bash
|
||||||
|
$ curl -fsSL https://get.docker.com/ | sh
|
||||||
|
```
|
||||||
|
|
||||||
This script adds the `docker.repo` repository and installs Docker.
|
This script adds the `docker.repo` repository and installs Docker.
|
||||||
|
|
||||||
4. Enable the service.
|
4. Enable the service.
|
||||||
|
|
||||||
$ sudo systemctl enable docker.service
|
```bash
|
||||||
|
$ sudo systemctl enable docker.service
|
||||||
|
```
|
||||||
|
|
||||||
5. Start the Docker daemon.
|
5. Start the Docker daemon.
|
||||||
|
|
||||||
$ sudo systemctl start docker
|
```bash
|
||||||
|
$ sudo systemctl start docker
|
||||||
|
```
|
||||||
|
|
||||||
6. Verify `docker` is installed correctly by running a test image in a container.
|
6. Verify `docker` is installed correctly by running a test image in a container.
|
||||||
|
|
||||||
$ sudo docker run hello-world
|
```bash
|
||||||
|
$ sudo docker run hello-world
|
||||||
|
```
|
||||||
|
|
||||||
|
If you need to add an HTTP Proxy, set a different directory or partition for the
|
||||||
|
Docker runtime files, or make other customizations, read our Systemd article to
|
||||||
|
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
||||||
|
|
||||||
## Create a docker group
|
## Create a docker group
|
||||||
|
|
||||||
|
@ -141,27 +176,37 @@ makes the ownership of the Unix socket read/writable by the `docker` group.
|
||||||
|
|
||||||
To create the `docker` group and add your user:
|
To create the `docker` group and add your user:
|
||||||
|
|
||||||
1. Log into your system as a user with `sudo` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Create the `docker` group.
|
2. Create the `docker` group.
|
||||||
|
|
||||||
`sudo groupadd docker`
|
```bash
|
||||||
|
$ sudo groupadd docker
|
||||||
|
```
|
||||||
|
|
||||||
3. Add your user to `docker` group.
|
3. Add your user to `docker` group.
|
||||||
|
|
||||||
`sudo usermod -aG docker your_username`
|
```bash
|
||||||
|
$ sudo usermod -aG docker your_username`
|
||||||
|
```
|
||||||
|
|
||||||
4. Log out and log back in.
|
4. Log out and log back in.
|
||||||
|
|
||||||
This ensures your user is running with the correct permissions.
|
This ensures your user is running with the correct permissions.
|
||||||
|
|
||||||
5. Verify your work by running `docker` without `sudo`.
|
5. Verify that your user is in the docker group by running `docker` without `sudo`.
|
||||||
|
|
||||||
$ docker run hello-world
|
```bash
|
||||||
|
$ docker run hello-world
|
||||||
|
```
|
||||||
|
|
||||||
If you need to add an HTTP Proxy, set a different directory or partition for the
|
## Start the docker daemon at boot
|
||||||
Docker runtime files, or make other customizations, read our Systemd article to
|
|
||||||
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
Configure the Docker daemon to start automatically when the host starts:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ sudo systemctl enable docker
|
||||||
|
```
|
||||||
|
|
||||||
## Running Docker with a manually-defined network
|
## Running Docker with a manually-defined network
|
||||||
|
|
||||||
|
@ -186,20 +231,27 @@ This configuration allows IP forwarding from the container as expected.
|
||||||
|
|
||||||
You can uninstall the Docker software with `dnf`.
|
You can uninstall the Docker software with `dnf`.
|
||||||
|
|
||||||
1. List the package you have installed.
|
1. List the installed Docker packages.
|
||||||
|
|
||||||
$ dnf list installed | grep docker
|
```bash
|
||||||
docker-engine.x86_64 1.7.1-0.1.fc21 @/docker-engine-1.7.1-0.1.fc21.el7.x86_64
|
$ dnf list installed | grep docker
|
||||||
|
|
||||||
|
docker-engine.x86_64 1.7.1-0.1.fc21 @/docker-engine-1.7.1-0.1.fc21.el7.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
2. Remove the package.
|
2. Remove the package.
|
||||||
|
|
||||||
$ sudo dnf -y remove docker-engine.x86_64
|
```bash
|
||||||
|
$ sudo dnf -y remove docker-engine.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
This command does not remove images, containers, volumes, or user-created
|
This command does not remove images, containers, volumes, or user-created
|
||||||
configuration files on your host.
|
configuration files on your host.
|
||||||
|
|
||||||
3. To delete all images, containers, and volumes, run the following command:
|
3. To delete all images, containers, and volumes, run the following command:
|
||||||
|
|
||||||
$ rm -rf /var/lib/docker
|
```bash
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
```
|
||||||
|
|
||||||
4. Locate and delete any user-created configuration files.
|
4. Locate and delete any user-created configuration files.
|
||||||
|
|
|
@ -12,110 +12,151 @@ weight = -5
|
||||||
|
|
||||||
# Red Hat Enterprise Linux
|
# Red Hat Enterprise Linux
|
||||||
|
|
||||||
Docker is supported on Red Hat Enterprise Linux 7. This page instructs you to
|
Docker is supported on Red Hat Enterprise Linux 7. These instructions install
|
||||||
install using Docker-managed release packages and installation mechanisms. Using
|
Docker using release packages and installation mechanisms managed by Docker,
|
||||||
these packages ensures you get the latest release of Docker. If you wish to
|
to be sure that you get the latest version of Docker. If you wish to install
|
||||||
install using Red Hat-managed packages, consult your Red Hat release
|
using Red Hat-managed packages, consult your Red Hat release documentation.
|
||||||
documentation for information on Red Hat's Docker support.
|
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
Docker requires a 64-bit installation regardless of your Red Hat version. Docker
|
Docker requires a 64-bit OS and version 3.10 or higher of the Linux kernel.
|
||||||
requires that your kernel must be 3.10 at minimum, which Red Hat 7 runs.
|
|
||||||
|
|
||||||
To check your current kernel version, open a terminal and use `uname -r` to
|
To check your current kernel version, open a terminal and use `uname -r` to
|
||||||
display your kernel version:
|
display your kernel version:
|
||||||
|
|
||||||
$ uname -r
|
```bash
|
||||||
3.10.0-229.el7.x86_64
|
$ uname -r
|
||||||
|
3.10.0-229.el7.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
Finally, is it recommended that you fully update your system. Please keep in
|
Finally, it is recommended that you fully update your system. Keep in mind
|
||||||
mind that your system should be fully patched to fix any potential kernel bugs.
|
that your system should be fully patched to fix any potential kernel bugs.
|
||||||
Any reported kernel bugs may have already been fixed on the latest kernel
|
Any reported kernel bugs may have already been fixed on the latest kernel
|
||||||
packages.
|
packages.
|
||||||
|
|
||||||
## Install Docker Engine
|
## Install Docker Engine
|
||||||
|
|
||||||
There are two ways to install Docker Engine. You can install with the `yum` package manager directly yourself. Or you can use `curl` with the `get.docker.com` site. This second method runs an installation script which installs via the `yum` package manager.
|
There are two ways to install Docker Engine. You can [install using the `yum`
|
||||||
|
package manager](#install-with-yum). Or you can use `curl` with the [`get.docker.com`
|
||||||
|
site](#install-with-the-script). This second method runs an installation script
|
||||||
|
which also installs via the `yum` package manager.
|
||||||
|
|
||||||
### Install with yum
|
### Install with yum
|
||||||
|
|
||||||
1. Log into your machine as a user with `sudo` or `root` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Make sure your existing yum packages are up-to-date.
|
2. Make sure your existing packages are up-to-date.
|
||||||
|
|
||||||
$ sudo yum update
|
```bash
|
||||||
|
$ sudo yum update
|
||||||
|
```
|
||||||
|
|
||||||
3. Add the yum repo yourself.
|
3. Add the `yum` repo.
|
||||||
|
|
||||||
$ sudo tee /etc/yum.repos.d/docker.repo <<-EOF
|
```bash
|
||||||
[dockerrepo]
|
$ sudo tee /etc/yum.repos.d/docker.repo <<-'EOF'
|
||||||
name=Docker Repository
|
[dockerrepo]
|
||||||
baseurl=https://yum.dockerproject.org/repo/main/centos/7
|
name=Docker Repository
|
||||||
enabled=1
|
baseurl=https://yum.dockerproject.org/repo/main/centos/7/
|
||||||
gpgcheck=1
|
enabled=1
|
||||||
gpgkey=https://yum.dockerproject.org/gpg
|
gpgcheck=1
|
||||||
EOF
|
gpgkey=https://yum.dockerproject.org/gpg
|
||||||
|
EOF
|
||||||
|
```
|
||||||
|
|
||||||
4. Install the Docker package.
|
4. Install the Docker package.
|
||||||
|
|
||||||
$ sudo yum install docker-engine
|
```bash
|
||||||
|
$ sudo yum install docker-engine
|
||||||
|
```
|
||||||
|
|
||||||
5. Start the Docker daemon.
|
5. Enable the service.
|
||||||
|
|
||||||
$ sudo service docker start
|
```bash
|
||||||
|
$ sudo systemctl enable docker.service
|
||||||
|
```
|
||||||
|
|
||||||
6. Verify `docker` is installed correctly by running a test image in a container.
|
6. Start the Docker daemon.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ sudo systemctl start docker
|
||||||
|
```
|
||||||
|
|
||||||
|
7. Verify `docker` is installed correctly by running a test image in a container.
|
||||||
|
|
||||||
|
$ sudo docker run --rm hello-world
|
||||||
|
|
||||||
$ sudo docker run hello-world
|
|
||||||
Unable to find image 'hello-world:latest' locally
|
Unable to find image 'hello-world:latest' locally
|
||||||
latest: Pulling from hello-world
|
latest: Pulling from library/hello-world
|
||||||
a8219747be10: Pull complete
|
c04b14da8d14: Pull complete
|
||||||
91c95931e552: Already exists
|
Digest: sha256:0256e8a36e2070f7bf2d0b0763dbabdd67798512411de4cdcf9431a1feb60fd9
|
||||||
hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
|
Status: Downloaded newer image for hello-world:latest
|
||||||
Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d
|
|
||||||
Status: Downloaded newer image for hello-world:latest
|
|
||||||
Hello from Docker.
|
|
||||||
This message shows that your installation appears to be working correctly.
|
|
||||||
|
|
||||||
To generate this message, Docker took the following steps:
|
Hello from Docker!
|
||||||
1. The Docker client contacted the Docker daemon.
|
This message shows that your installation appears to be working correctly.
|
||||||
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
|
||||||
(Assuming it was not already locally available.)
|
|
||||||
3. The Docker daemon created a new container from that image which runs the
|
|
||||||
executable that produces the output you are currently reading.
|
|
||||||
4. The Docker daemon streamed that output to the Docker client, which sent it
|
|
||||||
to your terminal.
|
|
||||||
|
|
||||||
To try something more ambitious, you can run an Ubuntu container with:
|
To generate this message, Docker took the following steps:
|
||||||
$ docker run -it ubuntu bash
|
1. The Docker client contacted the Docker daemon.
|
||||||
|
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
||||||
|
3. The Docker daemon created a new container from that image which runs the
|
||||||
|
executable that produces the output you are currently reading.
|
||||||
|
4. The Docker daemon streamed that output to the Docker client, which sent it
|
||||||
|
to your terminal.
|
||||||
|
|
||||||
For more examples and ideas, visit:
|
To try something more ambitious, you can run an Ubuntu container with:
|
||||||
http://docs.docker.com/userguide/
|
$ docker run -it ubuntu bash
|
||||||
|
|
||||||
|
Share images, automate workflows, and more with a free Docker Hub account:
|
||||||
|
https://hub.docker.com
|
||||||
|
|
||||||
|
For more examples and ideas, visit:
|
||||||
|
https://docs.docker.com/engine/userguide/
|
||||||
|
|
||||||
|
If you need to add an HTTP Proxy, set a different directory or partition for the
|
||||||
|
Docker runtime files, or make other customizations, read our Systemd article to
|
||||||
|
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
||||||
|
|
||||||
### Install with the script
|
### Install with the script
|
||||||
|
|
||||||
You use the same installation procedure for all versions of CentOS.
|
|
||||||
|
|
||||||
1. Log into your machine as a user with `sudo` or `root` privileges.
|
1. Log into your machine as a user with `sudo` or `root` privileges.
|
||||||
|
|
||||||
2. Make sure your existing yum packages are up-to-date.
|
2. Make sure your existing packages are up-to-date.
|
||||||
|
|
||||||
$ sudo yum update
|
```bash
|
||||||
|
$ sudo yum update
|
||||||
|
```
|
||||||
|
|
||||||
3. Run the Docker installation script.
|
3. Run the Docker installation script.
|
||||||
|
|
||||||
$ curl -fsSL https://get.docker.com/ | sh
|
```bash
|
||||||
|
$ curl -fsSL https://get.docker.com/ | sh
|
||||||
|
```
|
||||||
|
|
||||||
4. Start the Docker daemon.
|
This script adds the `docker.repo` repository and installs Docker.
|
||||||
|
|
||||||
$ sudo service docker start
|
4. Enable the service.
|
||||||
|
|
||||||
5. Verify `docker` is installed correctly by running a test image in a container.
|
```bash
|
||||||
|
$ sudo systemctl enable docker.service
|
||||||
|
```
|
||||||
|
|
||||||
$ sudo docker run hello-world
|
5. Start the Docker daemon.
|
||||||
|
|
||||||
## Create a docker group
|
```bash
|
||||||
|
$ sudo systemctl start docker
|
||||||
|
```
|
||||||
|
|
||||||
|
6. Verify `docker` is installed correctly by running a test image in a container.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ sudo docker run hello-world
|
||||||
|
```
|
||||||
|
|
||||||
|
If you need to add an HTTP Proxy, set a different directory or partition for the
|
||||||
|
Docker runtime files, or make other customizations, read our Systemd article to
|
||||||
|
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
||||||
|
|
||||||
|
## Create a docker group
|
||||||
|
|
||||||
The `docker` daemon binds to a Unix socket instead of a TCP port. By default
|
The `docker` daemon binds to a Unix socket instead of a TCP port. By default
|
||||||
that Unix socket is owned by the user `root` and other users can access it with
|
that Unix socket is owned by the user `root` and other users can access it with
|
||||||
|
@ -135,50 +176,59 @@ To create the `docker` group and add your user:
|
||||||
|
|
||||||
2. Create the `docker` group.
|
2. Create the `docker` group.
|
||||||
|
|
||||||
`sudo groupadd docker`
|
```bash
|
||||||
|
$ sudo groupadd docker
|
||||||
|
```
|
||||||
|
|
||||||
3. Add your user to `docker` group.
|
3. Add your user to `docker` group.
|
||||||
|
|
||||||
`sudo usermod -aG docker your_username`
|
```bash
|
||||||
|
$ sudo usermod -aG docker your_username`
|
||||||
|
```
|
||||||
|
|
||||||
4. Log out and log back in.
|
4. Log out and log back in.
|
||||||
|
|
||||||
This ensures your user is running with the correct permissions.
|
This ensures your user is running with the correct permissions.
|
||||||
|
|
||||||
5. Verify your work by running `docker` without `sudo`.
|
5. Verify that your user is in the docker group by running `docker` without `sudo`.
|
||||||
|
|
||||||
$ docker run hello-world
|
```bash
|
||||||
|
$ docker run hello-world
|
||||||
|
```
|
||||||
|
|
||||||
## Start the docker daemon at boot
|
## Start the docker daemon at boot
|
||||||
|
|
||||||
To ensure Docker starts when you boot your system, do the following:
|
Configure the Docker daemon to start automatically when the host starts:
|
||||||
|
|
||||||
$ sudo chkconfig docker on
|
|
||||||
|
|
||||||
If you need to add an HTTP Proxy, set a different directory or partition for the
|
|
||||||
Docker runtime files, or make other customizations, read our Systemd article to
|
|
||||||
learn how to [customize your Systemd Docker daemon options](../../admin/systemd.md).
|
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ sudo systemctl enable docker
|
||||||
|
```
|
||||||
|
|
||||||
## Uninstall
|
## Uninstall
|
||||||
|
|
||||||
You can uninstall the Docker software with `yum`.
|
You can uninstall the Docker software with `yum`.
|
||||||
|
|
||||||
1. List the package you have installed.
|
1. List the installed Docker packages.
|
||||||
|
|
||||||
$ yum list installed | grep docker
|
```bash
|
||||||
yum list installed | grep docker
|
$ yum list installed | grep docker
|
||||||
docker-engine.x86_64 1.7.1-0.1.el7@/docker-engine-1.7.1-0.1.el7.x86_64
|
|
||||||
|
docker-engine.x86_64 1.7.1-0.1.el7@/docker-engine-1.7.1-0.1.el7.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
2. Remove the package.
|
2. Remove the package.
|
||||||
|
|
||||||
$ sudo yum -y remove docker-engine.x86_64
|
```bash
|
||||||
|
$ sudo yum -y remove docker-engine.x86_64
|
||||||
|
```
|
||||||
|
|
||||||
This command does not remove images, containers, volumes, or user created
|
This command does not remove images, containers, volumes, or user-created
|
||||||
configuration files on your host.
|
configuration files on your host.
|
||||||
|
|
||||||
3. To delete all images, containers, and volumes run the following command:
|
3. To delete all images, containers, and volumes, run the following command:
|
||||||
|
|
||||||
$ rm -rf /var/lib/docker
|
```bash
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
```
|
||||||
|
|
||||||
4. Locate and delete any user-created configuration files.
|
4. Locate and delete any user-created configuration files.
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue