Puppet Class: docker::install

Defined in:
manifests/install.pp

Summary

Module to install an up-to-date version of Docker from a package repository. Only for Debian, Red Hat and Windows

Overview

Parameters:

  • version (Optional[String]) (defaults to: $docker::version)

    The package version to install, used to set the package name.

  • nuget_package_provider_version (Optional[String]) (defaults to: $docker::nuget_package_provider_version)

    The version of the NuGet Package provider

  • docker_msft_provider_version (Optional[String]) (defaults to: $docker::docker_msft_provider_version)

    The version of the Microsoft Docker Provider Module

  • docker_ee_package_name (Optional[String]) (defaults to: $docker::docker_ee_package_name)

    The name of the Docker Enterprise Edition package

  • docker_download_url (Optional[String]) (defaults to: $docker::package_location)
  • dependent_packages (Array) (defaults to: $docker::dependent_packages)


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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
# File 'manifests/install.pp', line 21

class docker::install (
  Optional[String] $version                        = $docker::version,
  Optional[String] $nuget_package_provider_version = $docker::nuget_package_provider_version,
  Optional[String] $docker_msft_provider_version   = $docker::docker_msft_provider_version,
  Optional[String] $docker_ee_package_name         = $docker::docker_ee_package_name,
  Optional[String] $docker_download_url            = $docker::package_location,
  Array            $dependent_packages             = $docker::dependent_packages,
) {
  $docker_start_command = $docker::docker_start_command

  if $facts['os']['family'] and ! $docker::acknowledge_unsupported_os {
    assert_type(Pattern[/^(Debian|RedHat|windows)$/], $facts['os']['family']) |$a, $b| {
      fail('This module only works on Debian, RedHat or Windows.')
    }
  }
  if $docker::version and $docker::ensure != 'absent' {
    $ensure = $docker::version
  } else {
    $ensure = $docker::ensure
  }

  if $docker::manage_package {
    if empty($docker::repo_opt) {
      $docker_hash = {}
    } else {
      $docker_hash = { 'install_options' => $docker::repo_opt }
    }

    if $docker::package_source {
      if $facts['os']['family'] == 'windows' {
        fail('Custom package source is currently not implemented on windows.')
      }
      case $docker::package_source {
        /docker-engine/ : {
          ensure_resource('package', 'docker', stdlib::merge($docker_hash, {
                ensure => $ensure,
                source => $docker::package_source,
                name   => $docker::docker_engine_package_name,
          }))
        }
        /docker-ce/ : {
          ensure_resource('package', 'docker', stdlib::merge($docker_hash, {
                ensure => $ensure,
                source => $docker::package_source,
                name   => $docker::docker_ce_package_name,
          }))
          ensure_resource('package', 'docker-ce-cli', stdlib::merge($docker_hash, {
                ensure => $ensure,
                source => $docker::package_source,
                name   => $docker::docker_ce_cli_package_name,
          }))
        }
        default : {
          # Empty
        }
      }
    } else {
      if $facts['os']['family'] != 'windows' {
        ensure_resource('package', 'docker', stdlib::merge($docker_hash, {
              ensure => $ensure,
              name   => $docker::docker_package_name,
        }))

        if $ensure == 'absent' {
          ensure_resource('package', $dependent_packages, {
              ensure => $ensure,
          })
        }
      } else {
        if $ensure == 'absent' {
          $remove_docker_parameters = {
            'docker_ee_package_name' => $docker_ee_package_name,
            'version'                => $version,
          }
          $check_docker_parameters = {
            'docker_ee_package_name' => $docker_ee_package_name,
          }
          exec { 'remove-docker-package':
            command   => epp('docker/windows/remove_docker.ps1.epp', $remove_docker_parameters),
            provider  => powershell,
            unless    => epp('docker/windows/check_docker.ps1.epp', $check_docker_parameters),
            logoutput => true,
          }
        } else {
          if $docker::package_location {
            $download_docker_parameters = {
              'docker_download_url' => $docker_download_url,
            }
            $check_docker_url_parameters = {
              'docker_download_url' => $docker_download_url,
            }
            exec { 'install-docker-package':
              command   => epp('docker/windows/download_docker.ps1.epp', $download_docker_parameters),
              provider  => powershell,
              unless    => epp('docker/windows/check_docker_url.ps1.epp', $check_docker_url_parameters),
              logoutput => true,
              notify    => Exec['service-restart-on-failure'],
            }
          } else {
            $install_powershell_provider_parameters = {
              'nuget_package_provider_version' => $nuget_package_provider_version,
              'docker_msft_provider_version'   => $docker_msft_provider_version,
              'version'                        => $version,
            }

            $check_powershell_provider_parameters = {
              'nuget_package_provider_version' => $nuget_package_provider_version,
              'docker_msft_provider_version'   => $docker_msft_provider_version,
              'docker_ee_package_name'         => $docker_ee_package_name,
              'version'                        => $version,
            }

            exec { 'install-docker-package':
              command   => epp('docker/windows/install_powershell_provider.ps1.epp', $install_powershell_provider_parameters),
              provider  => powershell,
              unless    => epp('docker/windows/check_powershell_provider.ps1.epp', $check_powershell_provider_parameters),
              logoutput => true,
              timeout   => 1800,
              notify    => Exec['service-restart-on-failure'],
            }
          }

          exec { 'service-restart-on-failure':
            command     => 'SC.exe failure Docker reset= 432000 actions= restart/30000/restart/60000/restart/60000',
            refreshonly => true,
            logoutput   => true,
            provider    => powershell,
          }
        }
      }
    }
  }
}