cookbook 'docker-ce', '~> 0.15.0'
docker-ce (15) Versions 0.15.0 Follow3
Installs Docker CE
cookbook 'docker-ce', '~> 0.15.0', :supermarket
knife supermarket install docker-ce
knife supermarket download docker-ce
Docker CE Cookbook
Installs the Docker engine Community Edition.
This cookbook has been built following the instructions from https://docs.docker.com/install/.
This cookbook takes care to lock the docker packages after install and upgrade in order to prevent any unexpected actions on the package. It also takes care to never restart Docker excepted when upgrading it.
Another Docker engine cookbook?
All the existing cookbooks I found on the Chef Supermarket wasn't covering my need, or wasn't working anymore, so I decided to make a new one, with tests, following the official documentation so that it should be more robust.
Supported Platforms
- Debian 8/9/10
- Ubuntu 18.04 (bionic), 20.04 (focal)
If you want to add more platforms, feel free to open a PR!
Attributes
Please note that all attributes are optional.
Key | Type | Description | Default |
---|---|---|---|
default[:docker_ce][:version] |
String | APT package version to be installed | latest |
node[:docker_ce][:daemon][:registry_mirrors] |
Array of strings | Docker registry mirrors | [] |
node[:docker_ce][:daemon][:cgroup_driver] |
String | Cgroup driver to be used by Docker | cgroupfs |
node[:docker_ce][:daemon][:live_restore] |
Boolean | Enables/Disables the Docker live restore feature | false |
node[:docker_ce][:daemon][:log_driver] |
String | Configures the Docker daemon logging driver | log_driver |
Usage
- If you use it from a Policyfile, a Role or an Environment, add it to the
run_list
:
{ "run_list": [ "recipe[docker-ce]" ] }
- If you want to use it within a cookbook :
ruby include_recipe 'docker-ce'
Tested Docker versions
Note: If you'd like to test another Docker serie, or another platform, please update the .kitchen.yml
file as the following:
- Duplicate an existing version from the
suites
section or add the new platform from theplatforms
section - Update the docker version to the version you'd like to test
- Run the tests (See [
TESTING.md
](TESTING.md)) - Update the
README.md
file with the tested version - When tests are passing, open a merge request
Debian
18.09 | 18.06 | |
---|---|---|
buster64 | ✅ | ✅ |
stretch64 | ✅ | ✅ |
jessie64 | ✅ | ✅ |
Ubuntu
18.09 | 18.06 | |
---|---|---|
ubuntu 18.04 | ✅ | ✅ |
Dependent cookbooks
apt >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
docker-ce-cookbook CHANGELOG
This file is used to list changes made in each version of this cookbook.
Unreleased
0.15.0 (2021-11-19)
Fixed
- unlocking/locking packages
0.14.0 (2021-11-10)
Fixed
- Prevent error when default['docker_ce']['version'] is
latest
on updating the docker packages
0.13.0 (2021-03-22)
Changed
- Defaults MTU to nil in order to prevent from setting it in the daemon.json file
0.12.0 (2021-03-05)
Added
- MTU support
0.11.0 (2020-05-06)
- Adds support for Ubuntu 18.04
- Shows cookbook name in log messages
0.10.0 (2020-03-09)
- Adds support for Debian 10 Buster
0.9.0 (2019-11-06)
- Allows changing the log-driver and setting of the live-restore option
0.8.0 (2019-08-12)
- Allows chaning the Docker native.cgroupdriver to systemd
0.7.0 (2019-08-09)
- Allows setting docker daemon 'registry-mirrors' setting
0.6.0 (2019-08-07)
- Implements Docker upgrade
- Optimise the recipe
- Lock the docker packages after install and upgrade
0.5.0 (2019-07-30)
- Adds the apt cookbook as dependency and removes useless apt-get update commands
0.4.0 (2019-07-27)
- Removes useless
apt-get update
commands
0.3.0 (2019-07-26)
- Adds Docker CE version attribute to define the APT package version to be installed.
0.2.0 (2019-05-27)
- Debian 8 support
- ChefSpecs
0.1.0 (2019-05-23)
Initial release.
Collaborator Number Metric
0.15.0 failed this metric
Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.15.0 passed this metric
No Binaries Metric
0.15.0 passed this metric
Testing File Metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.15.0 failed this metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.15.0 passed this metric
No Binaries Metric
0.15.0 passed this metric
Testing File Metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.15.0 passed this metric
0.15.0 passed this metric
Testing File Metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.15.0 failed this metric
0.15.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number