Class: Puppet::Environments::Legacy Private

Inherits:
Object
  • Object
show all
Includes:
EnvironmentCreator
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.

Old-style environments that come either from explicit stanzas in puppet.conf or from dynamic environments created from use of ‘$environment` in puppet.conf.

Examples:

Explicit Stanza

[environment_name]
modulepath=/var/my_env/modules

Dynamic Environments

[master]
modulepath=/var/$environment/modules

Instance Method Summary collapse

Methods included from EnvironmentCreator

#for

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.

Note:

Because the Legacy system cannot list out all of its environments, get is able to return environments that are not returned by a call to #list.

Find a named environment

Parameters:

Returns:



135
136
137
 
# File 'lib/puppet/environments.rb', line 135

def get(name)
  Puppet::Node::Environment.new(name)
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.

Note:

we could return something here, but since legacy environments are deprecated, there is no point.

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



143
144
145
 
# File 'lib/puppet/environments.rb', line 143

def get_conf(name)
  nil
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.

Note:

The list of environments for the Legacy environments is always empty.

Returns All of the environments known to the loader.

Returns:



126
127
128
 
# File 'lib/puppet/environments.rb', line 126

def list
  []
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:



118
119
120
 
# File 'lib/puppet/environments.rb', line 118

def search_paths
  ["file://#{Puppet[:config]}"]
end