Class: Bolt::Project

Inherits:
Object
  • Object
show all
Defined in:
lib/bolt/project.rb

Constant Summary collapse

BOLTDIR_NAME = 
'Boltdir'
PROJECT_SETTINGS = 
{
  "name"  => "The name of the project",
  "plans" => "An array of plan names to show, if they exist in the project."\
             "These plans are included in `bolt plan show` output",
  "tasks" => "An array of task names to show, if they exist in the project."\
             "These tasks are included in `bolt task show` output"
}.freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(raw_data, path, type = 'option', logs = []) ⇒ Project

Returns a new instance of Project.



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
 
# File 'lib/bolt/project.rb', line 84

def initialize(raw_data, path, type = 'option', logs = [])
  @path = Pathname.new(path).expand_path

  @project_file = @path + 'bolt-project.yaml'

  @logs = logs
  @deprecations = []
  if (@path + 'bolt.yaml').file? && project_file?
    msg = "Project-level configuration in bolt.yaml is deprecated if using bolt-project.yaml. "\
      "Transport config should be set in inventory.yaml, all other config should be set in "\
      "bolt-project.yaml."
    @deprecations << { type: 'Using bolt.yaml for project configuration', msg: msg }
  end

  @inventory_file    = @path + 'inventory.yaml'
  @hiera_config      = @path + 'hiera.yaml'
  @puppetfile        = @path + 'Puppetfile'
  @rerunfile         = @path + '.rerun.json'
  @resource_types    = @path + '.resource_types'
  @type              = type
  @downloads         = @path + 'downloads'
  @plans_path        = @path + 'plans'
  @managed_moduledir = @path + '.modules'
  @backup_dir        = @path + '.bolt-bak'

  tc = Bolt::Config::INVENTORY_OPTIONS.keys & raw_data.keys
  if tc.any?
    msg = "Transport configuration isn't supported in bolt-project.yaml. Ignoring keys #{tc}"
    @logs << { warn: msg }
  end

  @data = raw_data.reject { |k, _| Bolt::Config::INVENTORY_OPTIONS.include?(k) }

  # If the 'modules' key is present in the project configuration file,
  # use the new, shorter modulepath.
  @modulepath = if @data.key?('modules')
                  [(@path + 'modules').to_s]
                else
                  [(@path + 'modules').to_s, (@path + 'site-modules').to_s, (@path + 'site').to_s]
                end

  # Once bolt.yaml deprecation is removed, this attribute should be removed
  # and replaced with .project_file in lib/bolt/config.rb
  @config_file = if (Bolt::Config::BOLT_OPTIONS & @data.keys).any?
                   if (@path + 'bolt.yaml').file?
                     msg = "bolt-project.yaml contains valid config keys, bolt.yaml will be ignored"
                     @logs << { warn: msg }
                   end
                   @project_file
                 else
                   @path + 'bolt.yaml'
                 end
  validate if project_file?
end

Instance Attribute Details

#backup_dir ⇒ Object (readonly)

Returns the value of attribute backup_dir.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def backup_dir
  @backup_dir
end

#config_file ⇒ Object (readonly)

Returns the value of attribute config_file.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def config_file
  @config_file
end

#data ⇒ Object (readonly)

Returns the value of attribute data.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def data
  @data
end

#deprecations ⇒ Object (readonly)

Returns the value of attribute deprecations.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def deprecations
  @deprecations
end

#downloads ⇒ Object (readonly)

Returns the value of attribute downloads.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def downloads
  @downloads
end

#hiera_config ⇒ Object (readonly)

Returns the value of attribute hiera_config.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def hiera_config
  @hiera_config
end

#inventory_file ⇒ Object (readonly)

Returns the value of attribute inventory_file.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def inventory_file
  @inventory_file
end

#logs ⇒ Object (readonly)

Returns the value of attribute logs.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def logs
  @logs
end

#managed_moduledir ⇒ Object (readonly)

Returns the value of attribute managed_moduledir.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def managed_moduledir
  @managed_moduledir
end

#modulepath ⇒ Object (readonly)

Returns the value of attribute modulepath.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def modulepath
  @modulepath
end

#path ⇒ Object (readonly)

Returns the value of attribute path.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def path
  @path
end

#plans_path ⇒ Object (readonly)

Returns the value of attribute plans_path.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def plans_path
  @plans_path
end

#project_file ⇒ Object (readonly)

Returns the value of attribute project_file.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def project_file
  @project_file
end

#puppetfile ⇒ Object (readonly)

Returns the value of attribute puppetfile.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def puppetfile
  @puppetfile
end

#rerunfile ⇒ Object (readonly)

Returns the value of attribute rerunfile.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def rerunfile
  @rerunfile
end

#resource_types ⇒ Object (readonly)

Returns the value of attribute resource_types.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def resource_types
  @resource_types
end

#type ⇒ Object (readonly)

Returns the value of attribute type.



19
20
21
 
# File 'lib/bolt/project.rb', line 19

def type
  @type
end

Class Method Details

.create_project(path, type = 'option', logs = []) ⇒ Object 



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
 
# File 'lib/bolt/project.rb', line 51

def self.create_project(path, type = 'option', logs = [])
  fullpath = Pathname.new(path).expand_path

  if type == 'user'
    begin
      # This is already expanded if the type is user
      FileUtils.mkdir_p(path)
    rescue StandardError
      logs << { warn: "Could not create default project at #{path}. Continuing without a writeable project. "\
                "Log and rerun files will not be written." }
    end
  end

  if type == 'option' && !File.directory?(path)
    raise Bolt::Error.new("Could not find project at #{path}", "bolt/project-error")
  end

  if !Bolt::Util.windows? && type != 'environment' && fullpath.world_writable?
    raise Bolt::Error.new(
      "Project directory '#{fullpath}' is world-writable which poses a security risk. Set "\
      "BOLT_PROJECT='#{fullpath}' to force the use of this project directory.",
      "bolt/world-writable-error"
    )
  end

  project_file = File.join(fullpath, 'bolt-project.yaml')
  data = Bolt::Util.read_optional_yaml_hash(File.expand_path(project_file), 'project')
  default = type =~ /user|system/ ? 'default ' : ''
  exist = File.exist?(File.expand_path(project_file))
  logs << { info: "Loaded #{default}project from '#{fullpath}'" } if exist
  new(data, path, type, logs)
end

.default_project(logs = []) ⇒ Object 



24
25
26
27
28
29
 
# File 'lib/bolt/project.rb', line 24

def self.default_project(logs = [])
  create_project(File.expand_path(File.join('~', '.puppetlabs', 'bolt')), 'user', logs)
# If homedir isn't defined use the system config path
rescue ArgumentError
  create_project(Bolt::Config.system_path, 'system', logs)
end

.find_boltdir(dir, logs = []) ⇒ Object

Search recursively up the directory hierarchy for the Project. Look for a directory called Boltdir or a file called bolt.yaml (for a control repo type Project). Otherwise, repeat the check on each directory up the hierarchy, falling back to the default if we reach the root.



35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/bolt/project.rb', line 35

def self.find_boltdir(dir, logs = [])
  dir = Pathname.new(dir)

  if (dir + BOLTDIR_NAME).directory?
    create_project(dir + BOLTDIR_NAME, 'embedded', logs)
  elsif (dir + 'bolt.yaml').file? || (dir + 'bolt-project.yaml').file?
    create_project(dir, 'local', logs)
  elsif dir.root?
    default_project(logs)
  else
    logs << { debug: "Did not detect Boltdir, bolt.yaml, or bolt-project.yaml at '#{dir}'. "\
              "This directory won't be loaded as a project." }
    find_boltdir(dir.parent, logs)
  end
end

Instance Method Details

#check_deprecated_file ⇒ Object 



220
221
222
223
224
225
 
# File 'lib/bolt/project.rb', line 220

def check_deprecated_file
  if (@path + 'project.yaml').file?
    msg = "Project configuration file 'project.yaml' is deprecated; use 'bolt-project.yaml' instead."
    Bolt::Logger.deprecation_warning('Using project.yaml instead of bolt-project.yaml', msg)
  end
end

#eql?(other) ⇒ Boolean Also known as: ==

Returns:

  • (Boolean) 


151
152
153
 
# File 'lib/bolt/project.rb', line 151

def eql?(other)
  path == other.path
end

#load_as_module? ⇒ Boolean

Returns:

  • (Boolean) 


160
161
162
 
# File 'lib/bolt/project.rb', line 160

def load_as_module?
  !name.nil?
end

#modules ⇒ Object 



176
177
178
179
180
181
182
183
184
 
# File 'lib/bolt/project.rb', line 176

def modules
  @modules ||= @data['modules']&.map do |mod|
    if mod.is_a?(String)
      { 'name' => mod }
    else
      mod
    end
  end
end

#name ⇒ Object 



164
165
166
 
# File 'lib/bolt/project.rb', line 164

def name
  @data['name']
end

#plans ⇒ Object 



172
173
174
 
# File 'lib/bolt/project.rb', line 172

def plans
  @data['plans']
end

#project_file? ⇒ Boolean

Returns:

  • (Boolean) 


156
157
158
 
# File 'lib/bolt/project.rb', line 156

def project_file?
  @project_file.file?
end

#tasks ⇒ Object 



168
169
170
 
# File 'lib/bolt/project.rb', line 168

def tasks
  @data['tasks']
end

#to_h ⇒ Object

This API is used to prepend the project as a module to Puppet’s internal module_references list. CHANGE AT YOUR OWN RISK



145
146
147
148
149
 
# File 'lib/bolt/project.rb', line 145

def to_h
  { path: @path.to_s,
    name: name,
    load_as_module?: load_as_module? }
end

#to_s ⇒ Object 



139
140
141
 
# File 'lib/bolt/project.rb', line 139

def to_s
  @path.to_s
end

#validate ⇒ Object 



186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
 
# File 'lib/bolt/project.rb', line 186

def validate
  if name
    if name !~ Bolt::Module::MODULE_NAME_REGEX
      raise Bolt::ValidationError, "      Invalid project name '\#{name}' in bolt-project.yaml; project name must begin with a lowercase letter\n      and can include lowercase letters, numbers, and underscores.\n      ERROR_STRING\n    elsif Dir.children(Bolt::Config::Modulepath::BOLTLIB_PATH).include?(name)\n      raise Bolt::ValidationError, \"The project '\#{name}' will not be loaded. The project name conflicts \"\\\n        \"with a built-in Bolt module of the same name.\"\n    end\n  else\n    message = \"No project name is specified in bolt-project.yaml. Project-level content will not be available.\"\n    @logs << { warn: message }\n  end\n\n  %w[tasks plans].each do |conf|\n    unless @data.fetch(conf, []).is_a?(Array)\n      raise Bolt::ValidationError, \"'\#{conf}' in bolt-project.yaml must be an array\"\n    end\n  end\n\n  if @data['modules']\n    unless @data['modules'].is_a?(Array)\n      raise Bolt::ValidationError, \"'modules' in bolt-project.yaml must be an array\"\n    end\n\n    @data['modules'].each do |spec|\n      next if spec.is_a?(Hash) || spec.is_a?(String)\n      raise Bolt::ValidationError, \"Module specification \#{spec.inspect} must be a hash or string\"\n    end\n  end\nend\n"