docker-engine

Custom resources for installing Docker Engine, managing /etc/docker/daemon.json, and controlling the docker service.

Breaking Change for Upgrades

Upgrading from older docker-engine cookbook releases is a breaking change. Legacy usage based on include_recipe 'docker-engine::...' and cookbook attributes under node['docker-engine'] is no longer supported. Update wrapper cookbooks, roles, and Policyfiles to declare the docker_engine_* resources directly before upgrading.

See migration.md for the required migration steps.

Resources

• docker_engine_repo
• docker_engine_install
• docker_engine_config
• docker_engine_service

Usage

Install Docker Engine from Docker's upstream repository

docker_engine_repo 'docker'

docker_engine_install 'docker'

docker_engine_config 'docker' do
  config(
    'log-driver' => 'json-file',
    'storage-driver' => 'overlay2'
  )
end

docker_engine_service 'docker'

Install from distro packages instead of Docker's upstream repository

docker_engine_install 'docker' do
  packages 'docker.io'
end

docker_engine_config 'docker' do
  config('storage-driver' => 'overlay2')
end

docker_engine_service 'docker'

Resource Documentation

• docker_engine_repo
• docker_engine_install
• docker_engine_config
• docker_engine_service

Supported Platforms

• CentOS Stream 9+
• Debian 12+
• Ubuntu 22.04+

See LIMITATIONS.md for the current upstream Docker package and repository constraints that shaped this migration.

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.