Class: Puppet::Environments::Directories Private

Inherits:
Object
  • Object
show all
Includes:
EnvironmentLoader
Defined in:
lib/puppet/environments.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Reads environments from a directory on disk. Each environment is represented as a sub-directory. The environment’s manifest setting is the manifest directory of the environment directory. The environment’s modulepath setting is the global modulepath (from the [server] section for the server) prepended with the modules directory of the environment directory.

Class Method Summary collapse

Instance Method Summary collapse

Methods included from EnvironmentLoader

#clear_all, #get!

Constructor Details

#initialize(environment_dir, global_module_path) ⇒ Directories

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Directories.



170
171
172
173
174
175
 
# File 'lib/puppet/environments.rb', line 170

def initialize(environment_dir, global_module_path)
  @environment_dir =  Puppet::FileSystem.expand_path(environment_dir)
  @global_module_path = global_module_path ?
    global_module_path.map { |p| Puppet::FileSystem.expand_path(p) } :
    nil
end

Class Method Details

.from_path(path, global_module_path) ⇒ Array<Puppet::Environments::Directories>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Generate an array of directory loaders from a path string.

Parameters:

  • path (String) —

    path to environment directories

  • global_module_path (Array<String>) —

    the global modulepath setting

Returns:



182
183
184
185
186
187
 
# File 'lib/puppet/environments.rb', line 182

def self.from_path(path, global_module_path)
  environments = path.split(File::PATH_SEPARATOR)
  environments.map do |dir|
    Puppet::Environments::Directories.new(dir, global_module_path)
  end
end

.real_path(dir) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



189
190
191
192
193
194
 
# File 'lib/puppet/environments.rb', line 189

def self.real_path(dir)
  if Puppet::FileSystem.symlink?(dir) && Puppet[:versioned_environment_dirs]
    dir = Puppet::FileSystem.expand_path(Puppet::FileSystem.readlink(dir))
  end
  return dir
end

Instance Method Details

#get(name) ⇒ Puppet::Node::Environment?

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Find a named environment

Parameters:

  • name (String, Symbol) —

    The name of environment to find

Returns:



209
210
211
212
213
 
# File 'lib/puppet/environments.rb', line 209

def get(name)
  if validated_directory(File.join(@environment_dir, name.to_s))
    create_environment(name)
  end
end

#get_conf(name) ⇒ Puppet::Setting::EnvironmentConf?

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Attempt to obtain the initial configuration for the environment. Not all loaders can provide this.

Parameters:

  • name (String, Symbol) —

    The name of the environment whose configuration we are looking up

Returns:

  • (Puppet::Setting::EnvironmentConf, nil) —

    the configuration for the requested environment, or nil if not found or no configuration is available



216
217
218
219
220
221
222
223
 
# File 'lib/puppet/environments.rb', line 216

def get_conf(name)
  envdir = validated_directory(File.join(@environment_dir, name.to_s))
  if envdir
    Puppet::Settings::EnvironmentConf.load_from(envdir, @global_module_path)
  else
    nil
  end
end

#list ⇒ Array<Puppet::Node::Environment>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns All of the environments known to the loader.

Returns:



202
203
204
205
206
 
# File 'lib/puppet/environments.rb', line 202

def list
  valid_environment_names.collect do |name|
    create_environment(name)
  end
end

#search_paths ⇒ Array<String>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

A list of indicators of where the loader is getting its environments from.

Returns:

  • (Array<String>) —

    The URIs of the load locations



197
198
199
 
# File 'lib/puppet/environments.rb', line 197

def search_paths
  ["file://#{@environment_dir}"]
end