Puppet Class: profile::docker::engine

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

Overview

Profile docker::engine

Installs docker, along with setting up the volume group needed for the devicemapper storage driver to work. to work

Parameters:

  • settings (Hash) (defaults to: lookup('profile::docker::engine::settings'))
  • version (String) (defaults to: lookup('profile::docker::engine::version'))
  • packagename (String) (defaults to: lookup('profile::docker::engine::packagename'))
  • declare_service (Boolean) (defaults to: lookup('profile::docker::engine::declare_service')) 


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
50
51
52
53
54
55
56
57
58
59
60
61
 
# 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'),
    # Version to install; the default is not to pick one.
    String $version = lookup('profile::docker::engine::version'),
    String $packagename = lookup('profile::docker::engine::packagename'),
    # 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')
) {
    require ::profile::base::memory_cgroup
    # On Buster and later we use Docker from Debian
    if debian::codename::lt('buster') {
        apt::repository { 'thirdparty-k8s':
            uri        => 'http://apt.wikimedia.org/wikimedia',
            dist       => "${::lsbdistcodename}-wikimedia",
            components => 'thirdparty/k8s',
            before     => Class['docker'],
        }
    }

    # Docker config
    # Fetch the storage config from the related driver
    # I know this is horrible
    if defined(Class['profile::docker::storage']) {
        $docker_storage_options = $profile::docker::storage::options
    } else {
        # This will pick the storage setup that is default with docker, which
        # on servers >= buster means overlay2 if available, else the devicemapper-on-disk
        # driver that is highly discouraged
        if (defined(Class['profile::base']) and $profile::base::overlayfs == false) {
            warning('Using the default configuration of docker without enabling overlayfs, this is discouraged. Please ensure you declare profile::base::overlayfs: true in hiera.')
        }
        $docker_storage_options = {}
    }

    # We need to import one storage config
    class { 'docker::configuration':
        settings => merge($settings, $docker_storage_options),
    }

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

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