Puppet Class: profile::docker::engine

Defined in:
modules/profile/manifests/docker/engine.pp

Overview

Parameters:

  • settings (Hash) (defaults to: lookup('profile::docker::engine::settings', { 'default_value' => {} }))
  • packagename (Optional[String]) (defaults to: lookup('profile::docker::engine::packagename', { 'default_value' => 'docker.io' }))
  • declare_service (Boolean) (defaults to: lookup('profile::docker::engine::declare_service', { 'default_value' => true }))


6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# File 'modules/profile/manifests/docker/engine.pp', line 6

class profile::docker::engine (
    # We want to get settings across the hierarchy, some per host, some fleet
    # wide. So use hash merge behavior to merge keys across the hierarchy
    Hash $settings = lookup('profile::docker::engine::settings', { 'default_value' => {} }),
    # Override the default docker engine package name, defaults to the current name for the docker package.
    Optional[String] $packagename = lookup('profile::docker::engine::packagename', { 'default_value' => 'docker.io' }),
    # Set to false if we don't want to declare the docker service here
    # We want this to be on if we want to use a different docker systemd service (with flannel support, for eg.)
    Boolean $declare_service = lookup('profile::docker::engine::declare_service', { 'default_value' => true }),
) {
    if debian::codename::le('buster') {
        # See https://docs.docker.com/engine/install/linux-postinstall/#your-kernel-does-not-support-cgroup-swap-limit-capabilities
        # This seems not needed on Bullseye since Docker is provided.
        require profile::base::memory_cgroup
    }

    # Docker config
    # We enforce overlay2 storage driver as default and ensure docker does not fall back
    # to devicemapper in case of problems (e.g. unable to load the overlay module).
    $storage_driver = 'storage-driver' in $settings ? {
        true  => $settings['storage-driver'],
        false => 'overlay2',
    }
    if ( $storage_driver == 'overlay2' and defined(Class['profile::base']) and $profile::base::overlayfs == false) {
        fail('Please ensure you declare profile::base::overlayfs: true in hiera.')
    }

    class { 'docker::configuration':
        settings => merge($settings, { 'storage-driver' => $storage_driver }),
    }

    # Install docker, we should remove the "version" parameter when everything
    # is using Buster/Docker as packaged by Debian.
    class { 'docker':
        package_name => $packagename,
    }

    if $declare_service {
        # Service declaration
        service { 'docker':
            ensure => 'running',
        }
    }
}