docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2213 from joaofnfernandes/cs-1.11 

Updates install docs for CSE
This commit is contained in:
Joao Fernandes 2016-05-27 15:11:40 -07:00
parent bd7ebf8c50 067ed434c3
commit b1f95658fa
2 changed files with 64 additions and 101 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

93
cs-engine/install.md
View File

@ -15,34 +15,18 @@ weight=0
# Install CS Docker Engine # Install CS Docker Engine
This document describes the process of installing the commercially supported Follow these instructions to install CS Docker Engine, the commercially
Docker Engine (CS Engine). Installing the CS Engine is a prerequisite for supported version of Docker Engine.
installing Docker Trusted Registry and/or the Universal Control Plane (UCP).
Follow these instructions if you are installing the CS Engine on physical or CS Docker Engine can be installed on the following operating systems:
cloud infrastructures.
You first install the CS Engine before you install Docker Trusted Registry. * [CentOS 7.1/7.2 & RHEL 7.0/7.1 (YUM-based systems)](#install-on-centos-7-1-7-2-rhel-7-0-7-1-yum-based-systems)
However, if you are upgrading, you reverse that order and upgrade the Trusted
Registry first. To upgrade, see the [upgrade documentation](upgrade.md).
You will need to install the latest version of the CS Engine to run with the
latest version of the Trusted Registry. You will also want to install the
CS Engine on
any clients, especially in your production environment.
If your cloud provider is AWS, you have the option of installing the CS Engine
using an Amazon Machine Image (AMI). For more information, read
the [installation overview](index.md) to understand your options.
The CS Engine is supported on the following operating systems:
* [CentOS 7.1/7.2 & RHEL 7.0/7.1 (YUM-based systems)](#install-on-centos-7-1-rhel-7-0-7-1-yum-based-systems)
* [Ubuntu 14.04 LTS](#install-on-ubuntu-14-04-lts) * [Ubuntu 14.04 LTS](#install-on-ubuntu-14-04-lts)
* [SUSE Linux Enterprise 12](#install-on-suse-linux-enterprise-12-3) * [SUSE Linux Enterprise 12](#install-on-suse-linux-enterprise-12-3)
## Install CentOS 7.1/7.2 & RHEL 7.0/7.1 (YUM-based systems) ## Install on CentOS 7.1/7.2 & RHEL 7.0/7.1 (YUM-based systems)
This section explains how to install on CentOS 7.1/7.2 & RHEL 7.0/7.1. Only This section explains how to install on CentOS 7.1/7.2 & RHEL 7.0/7.1. Only
these versions are supported. CentOS 7.0 is **not** supported. On RHEL, these versions are supported. CentOS 7.0 is **not** supported. On RHEL,
@ -51,7 +35,7 @@ to update its RHEL kernel.
1. Log into the system as a user with root or sudo permissions. 1. Log into the system as a user with root or sudo permissions.
2. Add Docker's public key for CS packages: 2. Add the Docker public key for CS packages:
```bash ```bash
$ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e" $ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e"
@ -63,55 +47,35 @@ to update its RHEL kernel.
$ sudo yum install -y yum-utils $ sudo yum install -y yum-utils
``` ```
4. Add the repository. Notice in the following code that it gets the latest 4. Add the Docker repository:
version of the CS Engine. Each time you either install or upgrade, ensure that
you are requesting the version and the OS that you want.
```bash ```bash
$ sudo yum-config-manager --add-repo https://packages.docker.com/1.10/yum/repo/main/centos/7 $ sudo yum-config-manager --add-repo https://packages.docker.com/1.11/yum/repo/main/centos/7
``` ```
5. Install the CS Engine with the following command: This adds the repository of the latest version of CS Docker Engine. You can
customize the URL to install an older version.
5. Install Docker CS Engine:
```bash ```bash
$ sudo yum install docker-engine $ sudo yum install docker-engine
``` ```
6. Enable the Docker daemon as a service and then start it. 6. Enable the Docker daemon as a service and start it.
```bash ```bash
$ sudo systemctl enable docker.service $ sudo systemctl enable docker.service
$ sudo systemctl start docker.service $ sudo systemctl start docker.service
``` ```
7. Verify the installation was successful by running a simple container. 7. Confirm the Docker daemon is running:
$ sudo docker run hello-world ```bash
Unable to find image 'hello-world:latest' locally $ sudo docker info
latest: Pulling from hello-world ```
b901d36b6f2fd75: Pull complete
0a6ba66e537a53a: Pull complete
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:517f03be3f8169d84711c9ffb2b3235a4d27c1eb4ad147f6248c8040adb93113
Status: Downloaded newer image for hello-world:latest
Hello from Docker. 8. Optionally, add non-sudo access to the Docker socket by adding your user
This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
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.
To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash
8. (Optional) Add non-sudo access to the Docker socket by adding your user
to the `docker` group. to the `docker` group.
```bash ```bash
@ -148,11 +112,12 @@ to the `docker` group.
5. Add the repository for the new version: 5. Add the repository for the new version:
```bash ```bash
$ echo "deb https://packages.docker.com/1.10/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list $ echo "deb https://packages.docker.com/1.11/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list
``` ```
You must modify the "ubuntu-trusty" string for your flavor of ubuntu or This adds the repository of the latest version of CS Docker Engine for the
debian as seen in the following options: Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the
distribution you're using:
* debian-jessie (Debian 8) * debian-jessie (Debian 8)
* debian-stretch (future release) * debian-stretch (future release)
@ -191,22 +156,22 @@ user to the `docker` group.
1. Log into the system as a user with root or sudo permissions. 1. Log into the system as a user with root or sudo permissions.
2. Refresh your repository so that curl commands and CA certificates 2. Refresh your repository so that curl commands and CA certificates
are available. are available:
```bash ```bash
$ sudo zypper ref $ sudo zypper ref
``` ```
3. Add the repository and the signing key. Notice in the following code 3. Add the Docker repository and public key:
that it gets the latest version of the CS Engine. Each time you either
install or upgrade, ensure that the you are requesting the version and the
OS that you want.
```bash ```bash
$ sudo zypper ar -t YUM https://packages.docker.com/1.10/yum/repo/main/opensuse/12.3 docker-1.10 $ sudo zypper ar -t YUM https://packages.docker.com/1.11/yum/repo/main/opensuse/12.3 docker-1.11
$ sudo rpm --import 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' $ sudo rpm --import 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e'
``` ```
This adds the repository of the latest version of CS Docker Engine. You can
customize the URL to install an older version.
4. Install the Docker daemon package: 4. Install the Docker daemon package:
```bash ```bash

72
cs-engine/upgrade.md
View File

@ -12,25 +12,23 @@ weight=10
# Upgrade CS Docker Engine # Upgrade CS Docker Engine
This article explains how to upgrade your CS Docker Engine installation. This article explains how to upgrade your CS Docker Engine.
Before starting the upgrade, make sure all containers running on that CS
Docker Engine are stopped.
The way you upgrade your CS Docker Engine, depends on the version that is The upgrade process depends on the version that is currently installed and the
currently installed and the version that you want to upgrade to: version that you want to upgrade to:
* [Upgrade from the same minor version](#upgrade-from-the-same-minor-version), if * [Upgrade from the same minor version](#upgrade-from-the-same-minor-version)
you're upgrading from 1.10 to 1.10.x, * [Upgrade from the same major version](#upgrade-from-the-same-major-version)
* [Upgrade from the same major version](#upgrade-from-the-same-major-version), if * [Upgrade from a legacy version](#upgrade-from-a-legacy-version)
you're upgrading from 1.9 to 1.10,
* [Upgrade from a legacy version](#upgrade-from-a-legacy-version), if you're
upgrading from a version prior to 1.9.
Before starting the upgrade, make sure you stop all containers running on the
host. This ensures your containers have time for cleaning up before exiting,
thus avoiding data loss or corruption.
## Upgrade from the same minor version ## Upgrade from the same minor version
Use these instructions if you're upgrading your CS Docker Engine within the Use these instructions if you're upgrading your CS Docker Engine within the
same minor version. As an example, from 1.10.0 to 1.10.1. same minor version. As an example, from 1.1.0 to 1.1.1.
### CentOS 7.1 & RHEL 7.0/7.1 ### CentOS 7.1 & RHEL 7.0/7.1
Use these instructions to upgrade YUM-based systems. Use these instructions to upgrade YUM-based systems.
@ -41,7 +39,7 @@ Use these instructions to upgrade YUM-based systems.
$ sudo yum upgrade docker-engine $ sudo yum upgrade docker-engine
``` ```
2. Check that the CS Engine is running: 2. Check that the CS Docker Engine is running:
```bash ```bash
$ sudo docker info $ sudo docker info
@ -56,7 +54,7 @@ Use these instructions to upgrade APT-based systems.
$ sudo apt-get update && sudo apt-get upgrade docker-engine $ sudo apt-get update && sudo apt-get upgrade docker-engine
``` ```
2. Check that the CS Engine is running: 2. Check that the CS Docker Engine is running:
```bash ```bash
$ sudo docker info $ sudo docker info
@ -70,7 +68,7 @@ Use these instructions to upgrade APT-based systems.
$ sudo zypper upgrade docker-engine $ sudo zypper upgrade docker-engine
``` ```
2. Check that the CS Engine is running: 2. Check that the CS Docker Engine is running:
```bash ```bash
$ sudo docker info $ sudo docker info
@ -80,20 +78,20 @@ Use these instructions to upgrade APT-based systems.
## Upgrade from the same major version ## Upgrade from the same major version
Use these instructions if you're upgrading your CS Docker Engine within the Use these instructions if you're upgrading your CS Docker Engine within the
same major version. As an example, from 1.9 to 1.10. same major version. As an example, from 1.1.x to 1.2.x.
### CentOS 7.1 & RHEL 7.0/7.1 ### CentOS 7.1 & RHEL 7.0/7.1
Use these instructions to upgrade YUM-based systems. Use these instructions to upgrade YUM-based systems.
1. Add the docker engine repository. 1. Add the Docker Engine repository.
```bash ```bash
$ sudo yum-config-manager --add-repo https://packages.docker.com/1.10/yum/repo/main/centos/7 $ sudo yum-config-manager --add-repo https://packages.docker.com/1.11/yum/repo/main/centos/7
``` ```
In this example we are adding the docker engine 1.10 repository. But sure This adds the repository of the latest version of CS Docker Engine. You can
to add the repository of the version you want to install. customize the URL to install other versions.
2. Install the new package: 2. Install the new package:
@ -114,12 +112,12 @@ Use these instructions to update APT-based systems.
1. Add the docker engine repository. 1. Add the docker engine repository.
```bash ```bash
$ echo "deb https://packages.docker.com/1.10/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list $ echo "deb https://packages.docker.com/1.11/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list
``` ```
In this example we are adding the docker engine ubuntu-trusty 1.10 This adds the repository of the latest version of CS Docker Engine for the
repository. Be sure to use the Docker Engine version you want to upgrade to, Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the
and your linux distribution. The following distributions are available: distribution you're using:
* debian-jessie (Debian 8) * debian-jessie (Debian 8)
* debian-stretch (future release) * debian-stretch (future release)
@ -147,11 +145,11 @@ Use these instructions to update APT-based systems.
1. Add the docker engine repository. 1. Add the docker engine repository.
```bash ```bash
$ sudo zypper ar -t YUM https://packages.docker.com/1.10/yum/repo/main/opensuse/12.3 docker-1.10 $ sudo zypper ar -t YUM https://packages.docker.com/1.11/yum/repo/main/opensuse/12.3 docker-1.11
``` ```
In this example we are adding the CS Docker Engine 1.0 repository. This adds the repository of the latest version of CS Docker Engine. You
Be sure to use the Docker Engine version you want to upgrade to. can customize the URL to install other versions.
2. Install the new package: 2. Install the new package:
@ -181,7 +179,7 @@ Use these instructions to upgrade YUM-based systems.
$ sudo yum remove docker-engine-cs $ sudo yum remove docker-engine-cs
``` ```
2. Add Docker's public key for CS packages: 2. Add the Docker public key for CS packages:
```bash ```bash
$ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e" $ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e"
@ -196,12 +194,12 @@ Use these instructions to upgrade YUM-based systems.
4. Add the repository for the new version and disable the old one. 4. Add the repository for the new version and disable the old one.
```bash ```bash
$ sudo yum-config-manager --add-repo https://packages.docker.com/1.10/yum/repo/main/centos/7 $ sudo yum-config-manager --add-repo https://packages.docker.com/1.11/yum/repo/main/centos/7
$ sudo yum-config-manager --disable 'Docker_cs*' $ sudo yum-config-manager --disable 'Docker_cs*'
``` ```
In this example we are adding the CS Docker Engine 1.0 repository. This adds the repository of the latest version of CS Docker Engine. You
Be sure to use the Docker Engine version you want to upgrade to. can customize the URL to install other versions.
5. Install the new package: 5. Install the new package:
@ -211,7 +209,7 @@ Use these instructions to upgrade YUM-based systems.
6. Enable the Docker daemon as a service and start it. 6. Enable the Docker daemon as a service and start it.
``` ```bash
$ sudo systemctl enable docker.service $ sudo systemctl enable docker.service
$ sudo systemctl start docker.service $ sudo systemctl start docker.service
``` ```
@ -226,7 +224,7 @@ Use these instructions to update APT-based systems.
$ sudo apt-get remove docker-engine-cs $ sudo apt-get remove docker-engine-cs
``` ```
2. Add Docker's public key for CS packages: 2. Add the Docker public key for CS packages:
```bash ```bash
$ curl -s 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' | sudo apt-key add --import $ curl -s 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' | sudo apt-key add --import
@ -249,12 +247,12 @@ Use these instructions to update APT-based systems.
5. Add the repository for the new version: 5. Add the repository for the new version:
```bash ```bash
$ echo "deb https://packages.docker.com/1.10/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list $ echo "deb https://packages.docker.com/1.11/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list
``` ```
In this example we are adding the docker engine ubuntu-trusty 1.10 This adds the repository of the latest version of CS Docker Engine for the
repository. Be sure to use the Docker Engine version you want to upgrade to, Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the
and your linux distribution. The following distributions are available: distribution you're using:
* debian-jessie (Debian 8) * debian-jessie (Debian 8)
* debian-stretch (future release) * debian-stretch (future release)