kotovalexarian-likes-github/moby--moby
1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
Code Releases Activity

Do some major rearranging of the fedora/centos/rhel installation docs

Browse source 
Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au>
This commit is contained in:
Sven Dowideit 2015-02-05 13:42:11 +10:00
parent 66839cf3a6
commit eb814e4e70
3 changed files with 123 additions and 98 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

99
docs/sources/installation/centos.md
View file

@ -4,48 +4,34 @@ page_keywords: Docker, Docker documentation, requirements, linux, centos, epel,
# CentOS # CentOS
While the Docker package is provided by default as part of CentOS-7, Docker is supported on the following versions of CentOS:
it is provided by the EPEL repository for CentOS-6. Please note that
this changes the installation instructions slightly between versions. If you
need the latest version, you can always use the latest binary which works on
kernel 3.8 and above.
These instructions work for CentOS 6 and later. They will likely work for - [*CentOS 7 (64-bit)*](#installing-docker---centos-7)
other binary compatible EL6 distributions such as Scientific Linux, but - [*CentOS 6.5 (64-bit)*](#installing-docker---centos-6.5) or later
they haven't been tested.
These instructions are likely work for other binary compatible EL6/EL7 distributions
such as Scientific Linux, but they haven't been tested.
Please note that due to the current Docker limitations, Docker is able to Please note that due to the current Docker limitations, Docker is able to
run only on the **64 bit** architecture. run only on the **64 bit** architecture.
To run Docker, you will need [CentOS6](http://www.centos.org) or higher, ## Kernel support
with a kernel version 2.6.32-431 or higher as this has specific kernel
fixes to allow Docker to run. Currently the CentOS project will only support Docker when running on kernels
shipped by the distribution. There are kernel changes which will cause issues
if one decides to step outside that box and run non-distribution kernel packages.
To run Docker on [CentOS-6.5](http://www.centos.org) or later, you will need
kernel version 2.6.32-431 or higher as this has specific kernel fixes to allow
Docker to run.
## Installing Docker - CentOS-7 ## Installing Docker - CentOS-7
Docker is included by default in the CentOS-Extras repository. To install Docker is included by default in the CentOS-Extras repository. To install
simply run the following command. run the following command:
$ sudo yum install docker $ sudo yum install docker
## Kernel support Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
Currently the CentOS project will only support Docker via the EPEL package when
running on kernels shipped by the distribution. There are things like namespace
changes which will cause issues if one decides to step outside that box and run
non-distro kernel packages.
### Manual installation of latest version
While using a package is the recommended way of installing Docker,
the above package might not be the latest version. If you need the latest
version, [you can install the binary directly](
https://docs.docker.com/installation/binaries/).
When installing the binary without a package, you may want
to integrate Docker with systemd. For this, simply install the two unit files
(service and socket) from [the github
repository](https://github.com/docker/docker/tree/master/contrib/init/systemd)
to `/etc/systemd/system`.
### FirewallD ### FirewallD
@ -55,32 +41,49 @@ conflict with Docker.
When `firewalld` is started or restarted it will remove the `DOCKER` chain When `firewalld` is started or restarted it will remove the `DOCKER` chain
from iptables, preventing Docker from working properly. from iptables, preventing Docker from working properly.
When using systemd, `firewalld` is started before Docker, but if you When using Systemd, `firewalld` is started before Docker, but if you
start or restart `firewalld` after Docker, you will have to restart the Docker daemon. start or restart `firewalld` after Docker, you will have to restart the Docker daemon.
## Installing Docker - CentOS-6 ## Installing Docker - CentOS-6.5
Please note that this for CentOS-6, this package is part of [Extra Packages
for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort For Centos-6.5, the Docker package is part of [Extra Packages
to create and maintain additional packages for the RHEL distribution. for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL) repository,
a community effort to create and maintain additional packages for the RHEL distribution.
Firstly, you need to ensure you have the EPEL repository enabled. Please Firstly, you need to ensure you have the EPEL repository enabled. Please
follow the [EPEL installation instructions]( follow the [EPEL installation instructions](
https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
The `docker-io` package provides Docker on EPEL. For CentOS-6, there is a package name conflict with a system tray application
and its executable, so the Docker RPM package was called `docker-io`.
If you already have the (unrelated) `docker` package To proceed with `docker-io` installation on CentOS-6, you may need to remove the
installed, it will conflict with `docker-io`. `docker` package first.
There's a [bug report](
https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it.
To proceed with `docker-io` installation, please remove `docker` first.
Next, let's install the `docker-io` package which $ sudo yum -y remove docker
will install Docker on our host.
Next, let's install the `docker-io` package which will install Docker on our host.
$ sudo yum install docker-io $ sudo yum install docker-io
## Using Docker Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Manual installation of latest Docker release
While using a package is the recommended way of installing Docker,
the above package might not be the current release version. If you need the latest
version, [you can install the binary directly](
https://docs.docker.com/installation/binaries/).
When installing the binary without a package, you may want
to integrate Docker with Systemd. For this, install the two unit files
(service and socket) from [the GitHub
repository](https://github.com/docker/docker/tree/master/contrib/init/systemd)
to `/etc/systemd/system`.
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Starting the Docker daemon
Once Docker is installed, you will need to start the docker daemon. Once Docker is installed, you will need to start the docker daemon.
@ -115,13 +118,13 @@ If everything is working properly, you'll get a simple bash prompt. Type
## Custom daemon options ## Custom daemon options
If you need to add an HTTP Proxy, set a different directory or partition for the 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 Docker runtime files, or make other customizations, read our Systemd article to
learn how to [customize your systemd Docker daemon options](/articles/systemd/). learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
## Dockerfiles ## Dockerfiles
The CentOS Project provides a number of sample Dockerfiles which you may use The CentOS Project provides a number of sample Dockerfiles which you may use
either as templates or to familiarize yourself with docker. These templates either as templates or to familiarize yourself with docker. These templates
are available on github at [https://github.com/CentOS/CentOS-Dockerfiles]( are available on GitHub at [https://github.com/CentOS/CentOS-Dockerfiles](
https://github.com/CentOS/CentOS-Dockerfiles) https://github.com/CentOS/CentOS-Dockerfiles)
**Done!** You can either continue with the [Docker User **Done!** You can either continue with the [Docker User

49
docs/sources/installation/fedora.md
View file

@ -1,25 +1,19 @@
page_title: Installation on Fedora page_title: Installation on Fedora
page_description: Installation instructions for Docker on Fedora. page_description: Instructions for installing Docker on Fedora.
page_keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux page_keywords: Docker, Docker documentation, Fedora, requirements, linux
# Fedora # Fedora
Docker is supported only on Fedora 20 and later, Docker is supported on the following versions of Fedora:
on the **64 bit** architecture.
## Installation - [*Fedora 20 (64-bit)*](#fedora-20-installation)
- [*Fedora 21 and later (64-bit)*](#fedora-21-and-later-installation)
For `Fedora 20`, the `docker-io` package provides Docker. Currently the Fedora project will only support Docker when running on kernels
shipped by the distribution. There are kernel changes which will cause issues
if one decides to step outside that box and run non-distribution kernel packages.
If you have the (unrelated) `docker` package installed already, it will ## Fedora 21 and later installation
conflict with `docker-io`. To proceed with `docker-io` installation on
Fedora 20, please remove `docker` first.
$ sudo yum -y remove docker
$ sudo yum -y install docker-io
For `Fedora 21 and later`, there are no package conflicts as the system
tray application and its executable have been renamed `wmdocker`.
Install the `docker` package which will install Docker on our host. Install the `docker` package which will install Docker on our host.
@ -29,6 +23,27 @@ To update the `docker` package:
$ sudo yum -y update docker $ sudo yum -y update docker
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Fedora 20 installation
For `Fedora 20`, there is a package name conflict with a system tray application
and its executable, so the Docker RPM package was called `docker-io`.
To proceed with `docker-io` installation on Fedora 20, please remove the `docker`
package first.
$ sudo yum -y remove docker
$ sudo yum -y install docker-io
To update the `docker` package:
$ sudo yum -y update docker-io
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Starting the Docker daemon
Now that it's installed, let's start the Docker daemon. Now that it's installed, let's start the Docker daemon.
$ sudo systemctl start docker $ sudo systemctl start docker
@ -60,8 +75,8 @@ create a `docker` group, have it own `/var/run/docker.sock`, and add users to th
## Custom daemon options ## Custom daemon options
If you need to add an HTTP Proxy, set a different directory or partition for the 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 Docker runtime files, or make other customizations, read our Systemd article to
learn how to [customize your systemd Docker daemon options](/articles/systemd/). learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
## What next? ## What next?

73
docs/sources/installation/rhel.md
View file

@ -1,10 +1,24 @@
page_title: Installation on Red Hat Enterprise Linux page_title: Installation on Red Hat Enterprise Linux
page_description: Installation instructions for Docker on Red Hat Enterprise Linux. page_description: Instructions for installing Docker on Red Hat Enterprise Linux.
page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos page_keywords: Docker, Docker documentation, requirements, linux, rhel
# Red Hat Enterprise Linux 7 # Red Hat Enterprise Linux
**Red Hat Enterprise Linux 7** has [shipped with Docker is supported on the following versions of RHEL:
- [*Red Hat Enterprise Linux 7 (64-bit)*](#red-hat-enterprise-linux-7-installation)
- [*Red Hat Enterprise Linux 6.5 (64-bit)*](#red-hat-enterprise-linux-6.5-installation) or later
## Kernel support
RHEL will only support Docker via the *extras* channel or EPEL package when
running on kernels shipped by the distribution. There are kernel changes which
will cause issues if one decides to step outside that box and run
non-distribution kernel packages.
## Red Hat Enterprise Linux 7 Installation
**Red Hat Enterprise Linux 7 (64 bit)** has [shipped with
Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers). Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers).
An overview and some guidance can be found in the [Release An overview and some guidance can be found in the [Release
Notes](https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.0_Release_Notes/chap-Red_Hat_Enterprise_Linux-7.0_Release_Notes-Linux_Containers_with_Docker_Format.html). Notes](https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.0_Release_Notes/chap-Red_Hat_Enterprise_Linux-7.0_Release_Notes-Linux_Containers_with_Docker_Format.html).
@ -25,51 +39,44 @@ Enterprise Linux 7](https://access.redhat.com/site/articles/881893)
guide, can be found by Red Hat customers on the [Red Hat Customer guide, can be found by Red Hat customers on the [Red Hat Customer
Portal](https://access.redhat.com/). Portal](https://access.redhat.com/).
# Red Hat Enterprise Linux 6 Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
Docker is available for **RHEL** on EPEL. Please note that ## Red Hat Enterprise Linux 6.5 Installation
this package is part of [Extra Packages for Enterprise Linux
(EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to
create and maintain additional packages for the RHEL distribution.
Also note that due to the current Docker limitations, Docker is able to You will need **64 bit** [RHEL
run only on the **64 bit** architecture. 6.5](https://access.redhat.com/site/articles/3078#RHEL6) or later, with
You will need [RHEL
6.5](https://access.redhat.com/site/articles/3078#RHEL6) or higher, with
a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel
fixes to allow Docker to work. fixes to allow Docker to work.
## Kernel support Docker is available for **RHEL6.5** on EPEL. Please note that
this package is part of [Extra Packages for Enterprise Linux
RHEL will only support Docker via the *extras* channel or EPEL package when (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to
running on kernels shipped by the distribution. There are things like namespace create and maintain additional packages for the RHEL distribution.
changes which will cause issues if one decides to step outside that box and run
non-distro kernel packages.
## Installation
Firstly, you need to install the EPEL repository. Please follow the Firstly, you need to install the EPEL repository. Please follow the
[EPEL installation [EPEL installation
instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
The `docker-io` package provides Docker on EPEL. There is a package name conflict with a system tray application
and its executable, so the Docker RPM package was called `docker-io`.
If you already have the (unrelated) `docker` package To proceed with `docker-io` installation, you may need to remove the
installed, it will conflict with `docker-io`. `docker` package first.
There's a [bug report](
https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it.
To proceed with `docker-io` installation, please remove `docker` first.
Next, let's install the `docker-io` package which $ sudo yum -y remove docker
will install Docker on our host.
$ sudo yum -y install docker-io Next, let's install the `docker-io` package which will install Docker on our host.
$ sudo yum install docker-io
To update the `docker-io` package To update the `docker-io` package
$ sudo yum -y update docker-io $ sudo yum -y update docker-io
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Starting the Docker daemon
Now that it's installed, let's start the Docker daemon. Now that it's installed, let's start the Docker daemon.
$ sudo service docker start $ sudo service docker start
@ -93,8 +100,8 @@ Continue with the [User Guide](/userguide/).
## Custom daemon options ## Custom daemon options
If you need to add an HTTP Proxy, set a different directory or partition for the 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 Docker runtime files, or make other customizations, read our Systemd article to
learn how to [customize your systemd Docker daemon options](/articles/systemd/). learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
## Issues? ## Issues?