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

Adds docs for CSE 1.13-rc1

This commit is contained in:
Joao Fernandes 2017-01-10 16:27:51 -08:00
parent 6bbca0d71a
commit ed842d659d
12 changed files with 500 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
_data/toc.yaml
View File

@ -863,16 +863,26 @@ toc:
title: Frequently Asked Questions
- sectiontitle: CS Docker Engine
section:
- path: /cs-engine/install/
title: Install CS Docker Engine
- path: /cs-engine/upgrade/
title: Upgrade
- sectiontitle: Release notes
- sectiontitle: 1.13 Beta
section:
- path: /cs-engine/release-notes/release-notes/
title: CS Engine release notes
- path: /cs-engine/release-notes/prior-release-notes/
title: Prior CS Engine release notes
- path: /cs-engine/1.13/
title: Install
- path: /cs-engine/1.13/upgrade/
title: Upgrade
- path: /cs-engine/1.13/release-notes/
title: Release notes
- sectiontitle: 1.12
section:
- path: /cs-engine/1.12/install/
title: Install CS Docker Engine
- path: /cs-engine/1.12/upgrade/
title: Upgrade
- sectiontitle: Release notes
section:
- path: /cs-engine/1.12/release-notes/release-notes/
title: CS Engine release notes
- path: /cs-engine/1.12/release-notes/prior-release-notes/
title: Prior CS Engine release notes
- sectiontitle: Docker Datacenter
section:
- path: /datacenter/install/aws/

3
cs-engine/index.md → cs-engine/1.12/index.md
View File

@ -3,6 +3,7 @@ description: Learn more about the Commercially Supported Docker Engine.
keywords: docker, engine, documentation
redirect_from:
- /docker-trusted-registry/cs-engine/
- /cs-engine/
title: Commercially Supported Docker Engine
---
@ -10,4 +11,4 @@ This section includes the following topics:
* [Install CS Docker Engine](install.md)
* [Upgrade](upgrade.md)
* [Release notes](release-notes/release-notes.md)
* [Release notes](release-notes/release-notes.md)

1
cs-engine/install.md → cs-engine/1.12/install.md
View File

@ -5,6 +5,7 @@ redirect_from:
- /docker-trusted-registry/install/engine-ami-launch/
- /docker-trusted-registry/install/install-csengine/
- /docker-trusted-registry/cs-engine/install/
- /cs-engine/install/
title: Install Commercially Supported Docker Engine
---

3
cs-engine/release-notes/index.md → cs-engine/1.12/release-notes/index.md
View File

@ -3,8 +3,9 @@ description: The release notes for CS Docker Engine.
keywords: docker, engine, release notes
redirect_from:
- /docker-trusted-registry/cs-engine/release-notes/
- /cs-engine/release-notes/
title: Commercially Supported Docker Engine release notes
---
* [Release notes](release-notes.md)
* [Prior release notes](prior-release-notes.md)
* [Prior release notes](prior-release-notes.md)

1
cs-engine/release-notes/prior-release-notes.md → cs-engine/1.12/release-notes/prior-release-notes.md
View File

@ -4,6 +4,7 @@ keywords: docker, documentation, about, technology, understanding, enterprise, h
redirect_from:
- /docker-trusted-registry/cse-prior-release-notes/
- /docker-trusted-registry/cs-engine/release-notes/prior-release-notes/
- - /cs-engine/release-notes/prior-release-notes/
title: Release notes archive for Commercially Supported Docker Engine.
---

1
cs-engine/release-notes/release-notes.md → cs-engine/1.12/release-notes/release-notes.md
View File

@ -4,6 +4,7 @@ keywords: docker, documentation, about, technology, understanding, enterprise, h
redirect_from:
- /docker-trusted-registry/cse-release-notes/
- /docker-trusted-registry/cs-engine/release-notes/release-notes/
- /cs-engine/release-notes/release-notes/
title: Commercially Supported Engine release notes
---

3
cs-engine/upgrade.md → cs-engine/1.12/upgrade.md
View File

@ -3,6 +3,7 @@ description: Learn how to install the commercially supported version of Docker E
keywords: docker, engine, dtr, upgrade
redirect_from:
- /docker-trusted-registry/cs-engine/upgrade/
- /cs-engine/upgrade/
title: Upgrade Commercially Supported Docker Engine
---
@ -262,4 +263,4 @@ Use these instructions to update APT-based systems.
```bash
$ sudo apt-get upgrade docker-engine
```
```

178
cs-engine/1.13/index.md Normal file
View File

@ -0,0 +1,178 @@
---
title: Install CS Docker Engine 1.13
description: Learn how to install the commercially supported version of Docker Engine.
keywords: docker, engine, install
---
Follow these instructions to install CS Docker Engine, the commercially
supported version of Docker Engine.
CS Docker Engine can be installed on the following operating systems:
* CentOS 7.1/7.2 & RHEL 7.0/7.1/7.2 (YUM-based systems)
* Ubuntu 14.04 LTS or 16.04 LTS
* SUSE Linux Enterprise 12
## Install on CentOS 7.1/7.2 & RHEL 7.0/7.1/7.2 (YUM-based systems)
This section explains how to install on CentOS 7.1/7.2 & RHEL 7.0/7.1/7.2. Only
these versions are supported. CentOS 7.0 is **not** supported. On RHEL,
depending on your current level of updates, you may need to reboot your server
to update its RHEL kernel.
1. Log into the system as a user with root or sudo permissions.
2. Add the Docker public key for CS packages:
```bash
$ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e"
```
3. Install yum-utils if necessary:
```bash
$ sudo yum install -y yum-utils
```
4. Add the Docker repository:
```bash
$ sudo yum-config-manager --add-repo https://packages.docker.com/1.13/yum/repo/testing/centos/7
```
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
$ sudo yum install docker-engine
```
6. Configure devicemapper:
By default, the `devicemapper` graph driver does not come pre-configured in a production ready state. Follow the documented step by step instructions to [configure devicemapper with direct-lvm for production](../../engine/userguide/storagedriver/device-mapper-driver/#/for-a-direct-lvm-mode-configuration) in order to achieve the best performance and reliability for your environment.
7. Enable the Docker daemon as a service and start it.
```bash
$ sudo systemctl enable docker.service
$ sudo systemctl start docker.service
```
8. Confirm the Docker daemon is running:
```bash
$ sudo docker info
```
9. Optionally, add non-sudo access to the Docker socket by adding your user
to the `docker` group.
```bash
$ sudo usermod -a -G docker $USER
```
10. Log out and log back in to have your new permissions take effect.
## Install on Ubuntu 14.04 LTS or 16.04 LTS
1. Log into the system as a user with root or sudo permissions.
2. Add Docker's public key for CS packages:
```bash
$ curl -s 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' | sudo apt-key add --import
```
3. Install the HTTPS helper for apt (your system may already have it):
```bash
$ sudo apt-get update && sudo apt-get install apt-transport-https
```
4. Install additional kernel modules to add AUFS support.
```bash
$ sudo apt-get install -y linux-image-extra-$(uname -r) linux-image-extra-virtual
```
5. Add the repository for the new version:
```bash
$ echo "deb https://packages.docker.com/1.13/apt/repo ubuntu-trusty testing" | sudo tee /etc/apt/sources.list.d/docker.list
```
6. Run the following to install commercially supported Docker Engine and its
dependencies:
```bash
$ sudo apt-get update && sudo apt-get install docker-engine
```
7. Confirm the Docker daemon is running:
```bash
$ sudo docker info
```
8. Optionally, add non-sudo access to the Docker socket by adding your
user to the `docker` group.
```bash
$ sudo usermod -a -G docker $USER
```
Log out and log back in to have your new permissions take effect.
## Install on SUSE Linux Enterprise 12.3
1. Log into the system as a user with root or sudo permissions.
2. Refresh your repository so that curl commands and CA certificates
are available:
```bash
$ sudo zypper ref
```
3. Add the Docker repository and public key:
```bash
$ sudo zypper ar -t YUM https://packages.docker.com/1.13/yum/repo/testing/opensuse/12.3 docker-1.13
$ 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:
```bash
$ sudo zypper install docker-engine
```
5. Enable the Docker daemon as a service and then start it:
```bash
$ sudo systemctl enable docker.service
$ sudo systemctl start docker.service
```
6. Confirm the Docker daemon is running:
```bash
$ sudo docker info
```
7. Optionally, add non-sudo access to the Docker socket by adding your user
to the `docker` group.
```bash
$ sudo usermod -a -G docker $USER
```
8. Log out and log back in to have your new permissions take effect.

22
cs-engine/1.13/release-notes.md Normal file
View File

@ -0,0 +1,22 @@
---
title: CS Docker Engine 1.13 release notes
description: Commercially supported Docker Engine release notes
keywords: docker, engine, install, release notes
---
This document describes the latest changes, additions, known issues, and fixes
for the commercially supported Docker Engine (CS Engine).
The CS Engine is functionally equivalent to the corresponding Docker Engine that
it references. However, a commercially supported release also includes
back-ported fixes (security-related and priority defects) from the open source.
It incorporates defect fixes that you can use in environments where new features
cannot be adopted as quickly for consistency and compatibility reasons.
## CS Engine 1.13.0-cs1
(10 Jan 2017)
Refer to the [detailed list](https://github.com/docker/docker/releases/tag/v1.13.0-rc5) of all
changes since the release of CS Engine 1.12.5-cs5.

260
cs-engine/1.13/upgrade.md Normal file
View File

@ -0,0 +1,260 @@
---
title: Upgrade Commercially Supported Docker Engine
description: Learn how to upgrade the commercially supported version of Docker Engine.
keywords: docker, engine, upgrade
---
This article explains how to upgrade your CS Docker Engine.
The upgrade process depends on the version that is currently installed and the
version that you want to upgrade to:
* [Upgrade from the same minor version](upgrade.md#upgrade-from-the-same-minor-version)
* [Upgrade from the same major version](upgrade.md#upgrade-from-the-same-major-version)
* [Upgrade from a legacy version](upgrade.md#upgrade-from-a-legacy-version)
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
Use these instructions if you're upgrading your CS Docker Engine within the
same minor version. As an example, from 1.1.0 to 1.1.1.
### CentOS 7.1 & RHEL 7.0/7.1/7.2
Use these instructions to upgrade YUM-based systems.
1. Update your docker-engine package:
```bash
$ sudo yum upgrade docker-engine
```
2. Check that the CS Docker Engine is running:
```bash
$ sudo docker info
```
### Ubuntu 14.04 LTS or 16.04 LTS
Use these instructions to upgrade APT-based systems.
1. Update your docker-engine package:
```bash
$ sudo apt-get update && sudo apt-get upgrade docker-engine
```
2. Check that the CS Docker Engine is running:
```bash
$ sudo docker info
```
### SUSE Enterprise 12.3
1. Update your docker-engine package:
```bash
$ sudo zypper upgrade docker-engine
```
2. Check that the CS Docker Engine is running:
```bash
$ sudo docker info
```
## Upgrade from the same major version
Use these instructions if you're upgrading your CS Docker Engine within the
same major version. As an example, from 1.1.x to 1.2.x.
### CentOS 7.1 & RHEL 7.0/7.1/7.2
Use these instructions to upgrade YUM-based systems.
1. Add the Docker Engine repository.
```bash
$ sudo yum-config-manager --add-repo https://packages.docker.com/1.13/yum/repo/testing/centos/7
```
This adds the repository of the latest version of CS Docker Engine. You can
customize the URL to install other versions.
2. Install the new package:
```bash
$ sudo yum update docker-engine
```
3. Check that the CS Engine is running:
```bash
$ sudo docker info
```
### Ubuntu 14.04 LTS or 16.04 LTS
Use these instructions to update APT-based systems.
1. Add the docker engine repository.
```bash
$ echo "deb https://packages.docker.com/1.13/apt/repo ubuntu-trusty testing" | sudo tee /etc/apt/sources.list.d/docker.list
```
This adds the repository of the latest version of CS Docker Engine for the
Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the
distribution you're using:
* debian-jessie (Debian 8)
* debian-stretch (future release)
* debian-wheezy (Debian 7)
* ubuntu-precise (Ubuntu 12.04)
* ubuntu-trusty (Ubuntu 14.04)
* ubuntu-xenial (Ubuntu 16.04)
2. Update your docker-engine package.
```bash
$ sudo apt-get update && sudo apt-get upgrade docker-engine
```
3. Check that the CS Engine is running:
```bash
$ sudo docker info
```
#### SUSE Enterprise 12.3
1. Add the docker engine repository.
```bash
$ sudo zypper ar -t YUM https://packages.docker.com/1.13/yum/repo/testing/opensuse/12.3 docker-1.13
```
This adds the repository of the latest version of CS Docker Engine. You
can customize the URL to install other versions.
2. Install the new package:
```bash
$ sudo zypper update docker-engine
```
3. Check that the CS Engine is running:
```bash
$ sudo docker info
```
## Upgrade from a legacy version
Use these instructions if you're upgrading your CS Docker Engine from a version
prior to 1.9. In this case you'll have to first uninstall CS Docker Engine, and
then install the latest version.
### CentOS 7.1 & RHEL 7.0/7.1
Use these instructions to upgrade YUM-based systems.
1. Remove the current CS Engine:
```bash
$ sudo yum remove docker-engine-cs
```
2. Add the Docker public key for CS packages:
```bash
$ sudo rpm --import "https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e"
```
3. Install yum-utils if necessary:
```bash
$ sudo yum install -y yum-utils
```
4. Add the repository for the new version and disable the old one.
```bash
$ sudo yum-config-manager --add-repo https://packages.docker.com/1.13/yum/repo/testing/centos/7
$ sudo yum-config-manager --disable 'Docker_cs*'
```
This adds the repository of the latest version of CS Docker Engine. You
can customize the URL to install other versions.
5. Install the new package:
```bash
$ sudo yum install docker-engine
```
6. Enable the Docker daemon as a service and start it.
```bash
$ sudo systemctl enable docker.service
$ sudo systemctl start docker.service
```
### Ubuntu 14.04 LTS
Use these instructions to update APT-based systems.
1. Remove the current Engine:
```bash
$ sudo apt-get remove docker-engine-cs
```
2. Add the Docker public key for CS packages:
```bash
$ curl -s 'https://sks-keyservers.net/pks/lookup?op=get&search=0xee6d536cf7dc86e2d7d56f59a178ac6c6238f52e' | sudo apt-key add --import
```
3. Install the HTTPS helper for apt (your system may already have it):
```bash
$ sudo apt-get update && sudo apt-get install apt-transport-https
```
4. Install additional virtual drivers not in the base image.
```bash
$ sudo apt-get install -y linux-image-extra-virtual
```
You may need to reboot your server after updating the LTS kernel.
5. Add the repository for the new version:
```bash
$ echo "deb https://packages.docker.com/1.13/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list
```
This adds the repository of the latest version of CS Docker Engine for the
Ubuntu Trusty distribution. Change the "ubuntu-trusty" string to the
distribution you're using:
* debian-jessie (Debian 8)
* debian-stretch (future release)
* debian-wheezy (Debian 7)
* ubuntu-precise (Ubuntu 12.04)
* ubuntu-trusty (Ubuntu 14.04)
* ubuntu-xenial (Ubuntu 16.04)
6. Install the upgraded package:
```bash
$ sudo apt-get upgrade docker-engine
```

19
datacenter/install/linux.md
View File

@ -14,18 +14,18 @@ Linux servers. Make sure all the hosts you want to manage in with Docker
Datacenter have a minimum of:
* Linux kernel version 3.10 or higher
* CS Docker Engine version 1.12.1 or higher
* Docker Engine version 1.13.0 or higher
* 2.00 GB of RAM
* 3.00 GB of available disk space
Also make sure the hosts are running one of these operating systems:
* CentOS 7.1 or 7.2
* Red Hat Enterprise Linux 7.0, 7.1, or 7.2
* Ubuntu 14.04 LTS
* Red Hat Enterprise Linux 7.0, 7.1, 7.2, or 7.3
* Ubuntu 14.04 LTS or 16.04 LTS
* SUSE Linux Enterprise 12
[Learn more about the Docker Datacenter system requirements](../ucp/2.0/guides/installation/system-requirements.md)
[Learn more about the Docker Datacenter system requirements](../ucp/2.1/guides/install/system-requirements.md)
### Step 2: Install CS Docker Engine
@ -36,10 +36,10 @@ with Docker Datacenter.
Log in into each host using ssh, and install CS Docker Engine:
```bash
curl -SLf https://packages.docker.com/1.12/install.sh | sh
curl -SLf https://packages.docker.com/1.13/install.sh | repo=testing sh
```
[You can also install CS Docker Engine using a package manager](../../cs-engine/install.md)
[You can also install CS Docker Engine using a package manager](/cs-engine/1.13/index.md)
### Step 3: Install Universal Control Plane
@ -59,7 +59,8 @@ docker run --rm -it --name ucp \
This runs the install command in interactive mode, so that you're prompted
for any necessary configuration values.
[Learn more about the UCP installation](../ucp/2.0/guides/installation/index.md)
[Learn more about the UCP installation](../ucp/2.1/guides/admin/install/index.md)
### Step 4: License your installation
@ -113,5 +114,5 @@ by UCP.
## Where to go next
* [Deploy an application](../ucp/2.0/guides/applications/index.md)
* [Considerations for high availability](../ucp/2.0/guides/high-availability/index.md)
* [Deploy an application](../ucp/2.1/guides/applications/index.md)
* [Considerations for high availability](../ucp/2.1/guides/configure/high-availability.md)

4
datacenter/ucp/2.1/guides/install/index.md
View File

@ -24,10 +24,10 @@ For each host that you plan to manage with UCP:
2. Install Docker Engine 1.13:
```bash
curl -fsSL https://test.docker.com/ | sh
curl -SLf https://packages.docker.com/1.13/install.sh | repo=testing sh
```
[You can also install Docker Engine using a package manager](/engine/installation.md)
[You can also install Docker Engine using a package manager](/cs-engine/1.13/index.md)
Make sure you install the same Docker Engine version on all the nodes. Also,
if you're creating virtual machine templates with Docker Engine already