48aea5637f
Kolla Ansible's bootstrap-servers command provides support for installing the Docker engine. This is currently done using the packages at https://apt.dockerproject.org and https://yum.dockerproject.org. These packages are outdated, with the most recent packages from May 2017 - docker-engine-17.05. The source for up to date docker packages is https://download.docker.com, which was introduced with the move to Docker Community Edition (CE) and Docker Enterprise Edition (EE). This change adds support to bootstrap-servers for Docker CE for CentOS and Ubuntu. It also adds a new variable, 'enable_docker_repo', which controls whether a package repository for Docker will be enabled. It also adds a new variable, 'docker_legacy_packages', which controls whether the legacy packages at dockerproject.org will be used or the newer packages at docker.com. The default value for this variable is 'false', meaning to use Docker CE. Upgrading from docker-engine to docker-ce has been tested on CentOS 7.5 and Ubuntu 16.04, by running 'kolla-ansible bootstrap-servers' with 'docker_legacy_packages' set to 'false'. The upgrades were successful, but result in all containers being stopped. For this reason, the bootstrap-servers command checks running containers prior to upgrading packages, and ensures they are running after the package upgrade is complete. As mentioned in the release note, care should be taken when upgrading Docker with clustered services, which could lose quorum. To avoid this, use --serial or --limit to apply the change in batches. Change-Id: I6dfd375c868870f8646ef1a8f02c70812e8f6271 Implements: blueprint docker-ce
24 lines
1.2 KiB
YAML
24 lines
1.2 KiB
YAML
---
|
|
features:
|
|
- |
|
|
Adds support for installing Docker Community Edition (CE) using the
|
|
``kolla-ansible bootstrap-servers`` command. Existing support uses the
|
|
legacy packages from https://dockerproject.org. New packages are
|
|
distributed via https://download.docker.com, and that location is now
|
|
supported and used by default. Use of the legacy packages is enabled by
|
|
setting the variable ``docker_legacy_packages`` to ``true``.
|
|
|
|
It is also now possible to skip configuration of the Docker repository, by
|
|
setting the variable ``enable_docker_repo`` to ``false``.
|
|
upgrade:
|
|
- |
|
|
The default value for ``docker_legacy_packages`` is ``false``, which means
|
|
that the Docker Community Edition (CE) should be installed. If the
|
|
``kolla-ansible bootstrap-servers`` command is used on a previously
|
|
deployed host that is running a legacy Docker engine, it would result in
|
|
the Docker engine being upgraded to use the Docker Community Edition
|
|
packages, which will result in a restart of the Docker engine and the
|
|
containers running on that host. Use the ``kolla-ansible`` ``--serial`` or
|
|
``--limit`` arguments to avoid losing quorum in clustered services such as
|
|
MariaDB by restarting all containers at once.
|