From 2a35e41a9c825b6891440015ae95633fb84b9604 Mon Sep 17 00:00:00 2001 From: Jim Perrin Date: Fri, 23 May 2014 08:53:11 -0500 Subject: [PATCH 1/3] Squashed for pull request Updated documentation to include CentOS installation instructions. Extraneous line removal, description change Docker-DCO-1.1-Signed-off-by: Jim Perrin (github: jimperrin) --- docs/mkdocs.yml | 1 + docs/sources/installation/centos.md | 89 +++++++++++++++++++++++++++++ 2 files changed, 90 insertions(+) create mode 100644 docs/sources/installation/centos.md diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index e3f9e28196..1e6b8b16d8 100755 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -35,6 +35,7 @@ pages: - ['installation/mac.md', 'Installation', 'Mac OS X'] - ['installation/ubuntulinux.md', 'Installation', 'Ubuntu'] - ['installation/rhel.md', 'Installation', 'Red Hat Enterprise Linux'] +- ['installation/centos.md', 'Installation', 'CentOS'] - ['installation/debian.md', 'Installation', 'Debian'] - ['installation/gentoolinux.md', 'Installation', 'Gentoo'] - ['installation/google.md', 'Installation', 'Google Cloud Platform'] diff --git a/docs/sources/installation/centos.md b/docs/sources/installation/centos.md new file mode 100644 index 0000000000..74d1ec858e --- /dev/null +++ b/docs/sources/installation/centos.md @@ -0,0 +1,89 @@ +page_title: Installation on CentOS +page_description: This page provides documentation for installing docker on CentOS +page_keywords: Docker, Docker documentation, requirements, linux, centos, epel, docker.io, docker-io + +# CentOS + +> **Note**: +> Docker is still under heavy development! We don't recommend using it in +> production yet, but we're getting closer with each release. Please see +> our blog post, [Getting to Docker 1.0]( +> http://blog.docker.io/2013/08/getting-to-docker-1-0/) + +> **Note**: +> This is a community contributed installation path. The only `official` +> installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +> installation path. This version may be out of date because it depends on +> some binaries to be updated and published + +The Docker package is available via the EPEL repository. These instructions work +for CentOS 6 and later. They will likely work for other binary compatible EL6 +distributions such as Scientific Linux, but they haven't been tested. + +Please note that 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 +run only on the **64 bit** architecture. + +To run Docker, you will need [CentOS6](http://www.centos.org) or higher, with +a kernel version 2.6.32-431 or higher as this has specific kernel fixes +to allow Docker to run. + +## Installation + +Firstly, you need to ensure you have the EPEL repository enabled. Please +follow the [EPEL installation instructions]( +https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). + +The `docker-io` package provides Docker on EPEL. + +If you already have the (unrelated) `docker` package +installed, it will conflict with `docker-io`. +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 +will install Docker on our host. + + sudo yum install docker-io + +Now that it's installed, let's start the Docker daemon. + + sudo service docker start + +If we want Docker to start at boot, we should also: + + sudo chkconfig docker on + +Now let's verify that Docker is working. First we'll need to get the latest +centos image. + + sudo docker pull centos:latest + +Next we'll make sure that we can see the image by running: + + sudo docker images centos + +This should generate some output similar to: + + [your-user@lappy ~]# sudo docker images centos + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + centos latest 0b443ba03958 2 hours ago 297.6 MB + +Run a simple bash shell to test the image: + sudo docker run -i -t centos /bin/bash + +If everything is working properly, you'll get a simple bash prompt. Type exit to continue. + +**Done!** +You can either continue with the [*Hello World*](/examples/hello_world/#hello-world) example, +or explore and build on the images yourself. + +## Issues? + +If you have any issues - please report them directly in the +[CentOS bug tracker]( +http://bugs.centos.org). From 1cb2570a276020749a0b87444b17f4e6ce78b92d Mon Sep 17 00:00:00 2001 From: Jim Perrin Date: Sat, 24 May 2014 08:33:41 -0500 Subject: [PATCH 2/3] Correct appearance of shell output Docker-DCO-1.1-Signed-off-by: Jim Perrin (github: jimperrin) --- docs/sources/installation/centos.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/sources/installation/centos.md b/docs/sources/installation/centos.md index 74d1ec858e..97c3402c78 100644 --- a/docs/sources/installation/centos.md +++ b/docs/sources/installation/centos.md @@ -48,33 +48,34 @@ To proceed with `docker-io` installation, please remove `docker` first. 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 Now that it's installed, let's start the Docker daemon. - sudo service docker start + $ sudo service docker start If we want Docker to start at boot, we should also: - sudo chkconfig docker on + $ sudo chkconfig docker on Now let's verify that Docker is working. First we'll need to get the latest centos image. - sudo docker pull centos:latest + $ sudo docker pull centos:latest Next we'll make sure that we can see the image by running: - sudo docker images centos + $ sudo docker images centos This should generate some output similar to: - [your-user@lappy ~]# sudo docker images centos + $ sudo docker images centos REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE centos latest 0b443ba03958 2 hours ago 297.6 MB Run a simple bash shell to test the image: - sudo docker run -i -t centos /bin/bash + + $ sudo docker run -i -t centos /bin/bash If everything is working properly, you'll get a simple bash prompt. Type exit to continue. From b7e88250f421d34d25f89737c65954150248ee28 Mon Sep 17 00:00:00 2001 From: Jim Perrin Date: Tue, 27 May 2014 08:59:30 -0500 Subject: [PATCH 3/3] Update documentation per suggestions from ostezer Docker-DCO-1.1-Signed-off-by: Jim Perrin (github: jimperrin) --- docs/sources/installation/centos.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/sources/installation/centos.md b/docs/sources/installation/centos.md index 97c3402c78..7d2a9ae5d7 100644 --- a/docs/sources/installation/centos.md +++ b/docs/sources/installation/centos.md @@ -1,5 +1,5 @@ page_title: Installation on CentOS -page_description: This page provides documentation for installing docker on CentOS +page_description: Instructions for installing Docker on CentOS page_keywords: Docker, Docker documentation, requirements, linux, centos, epel, docker.io, docker-io # CentOS @@ -14,7 +14,7 @@ page_keywords: Docker, Docker documentation, requirements, linux, centos, epel, > This is a community contributed installation path. The only `official` > installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) > installation path. This version may be out of date because it depends on -> some binaries to be updated and published +> some binaries to be updated and published. The Docker package is available via the EPEL repository. These instructions work for CentOS 6 and later. They will likely work for other binary compatible EL6 @@ -86,5 +86,4 @@ or explore and build on the images yourself. ## Issues? If you have any issues - please report them directly in the -[CentOS bug tracker]( -http://bugs.centos.org). +[CentOS bug tracker](http://bugs.centos.org).