class Chef::ChefFS::FileSystem::Repository::ChefRepositoryFileSystemRootDir

Represents the root of a local Chef repository, with directories for nodes, cookbooks, roles, etc. under it.

Constants

CHILDREN

Attributes

child_paths[R]
root_paths[R]
versioned_cookbooks[R]
write_pretty_json[RW]

Public Class Methods

new(child_paths, root_paths = [], chef_config = Chef::Config) click to toggle source

Create a new Chef Repository File System root.

Parameters

child_paths

A hash of child paths, e.g.:

"nodes" => [ '/var/nodes', '/home/jkeiser/nodes' ],
"roles" => [ '/var/roles' ],
...
root_paths

An array of paths representing the top level, where org.json, members.json, and invites.json will be stored.

chef_config
  • a hash of options that looks suspiciously like the ones

stored in Chef::Config, containing at least these keys:
:versioned_cookbooks:: whether to include versions in cookbook names
# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 74
def initialize(child_paths, root_paths = [], chef_config = Chef::Config)
  super("", nil)
  @child_paths = child_paths
  @root_paths = root_paths
  @versioned_cookbooks = chef_config[:versioned_cookbooks]
end

Public Instance Methods

can_have_child?(name, is_dir) click to toggle source
# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 97
def can_have_child?(name, is_dir)
  if is_dir
    child_paths.key?(name)
  elsif root_dir
    CHILDREN.include?(name)
  else
    false
  end
end
children() click to toggle source
# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 89
def children
  @children ||= begin
                  result = child_paths.keys.sort.map { |name| make_child_entry(name) }
                  result += CHILDREN.map { |name| make_child_entry(name) }
                  result.select { |c| c && c.exists? }.sort_by(&:name)
                end
end
create_child(name, file_contents = nil) click to toggle source
# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 107
def create_child(name, file_contents = nil)
  if file_contents
    child = root_dir.create_child(name, file_contents)
  else
    child_paths[name].each do |path|

      ::FileUtils.mkdir_p(path)
      ::FileUtils.chmod(0700, path)
      if ChefUtils.windows?
        all_mask = Chef::ReservedNames::Win32::API::Security::GENERIC_ALL
        administrators = Chef::ReservedNames::Win32::Security::SID.Administrators
        owner = Chef::ReservedNames::Win32::Security::SID.default_security_object_owner
        dacl = Chef::ReservedNames::Win32::Security::ACL.create([
          Chef::ReservedNames::Win32::Security::ACE.access_allowed(owner, all_mask),
          Chef::ReservedNames::Win32::Security::ACE.access_allowed(administrators, all_mask),
        ])
        so = Chef::ReservedNames::Win32::Security::SecurableObject.new(path)
        so.owner = owner
        so.set_dacl(dacl, false)
      end
    rescue Errno::EEXIST

    end
    child = make_child_entry(name)
  end
  @children = nil
  child
end
fs_description() click to toggle source

Used to print out a human-readable file system description

# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 141
def fs_description
  repo_paths = root_paths || [ File.dirname(child_paths["cookbooks"][0]) ]
  result = "repository at #{repo_paths.join(", ")}"
  if versioned_cookbooks
    result << " (Multiple versions per cookbook)"
  else
    result << " (One version per cookbook)"
  end
  child_paths.each_pair do |name, paths|
    if paths.any? { |path| !repo_paths.include?(File.dirname(path)) }
      result << "  #{name} at #{paths.join(", ")}\n"
    end
  end
  result
end
json_class() click to toggle source
# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 136
def json_class
  nil
end

Private Instance Methods

make_child_entry(name) click to toggle source

Create a child entry of the appropriate type: cookbooks, data_bags, acls, etc. All will be multiplexed (i.e. if you have multiple paths for cookbooks, the multiplexed dir will grab cookbooks from all of them when you list or grab them).

# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 180
def make_child_entry(name)
  if CHILDREN.include?(name)
    return nil unless root_dir

    return root_dir.child(name)
  end

  paths = (child_paths[name] || []).select { |path| File.exist?(path) }
  if paths.size == 0
    return NonexistentFSObject.new(name, self)
  end

  case name
  when "acls"
    dirs = paths.map { |path| AclsDir.new(name, self, path) }
  when "client_keys"
    dirs = paths.map { |path| ClientKeysDir.new(name, self, path) }
  when "clients"
    dirs = paths.map { |path| ClientsDir.new(name, self, path) }
  when "containers"
    dirs = paths.map { |path| ContainersDir.new(name, self, path) }
  when "cookbooks"
    if versioned_cookbooks
      dirs = paths.map { |path| VersionedCookbooksDir.new(name, self, path) }
    else
      dirs = paths.map { |path| CookbooksDir.new(name, self, path) }
    end
  when "cookbook_artifacts"
    dirs = paths.map { |path| CookbookArtifactsDir.new(name, self, path) }
  when "data_bags"
    dirs = paths.map { |path| DataBagsDir.new(name, self, path) }
  when "environments"
    dirs = paths.map { |path| EnvironmentsDir.new(name, self, path) }
  when "groups"
    dirs = paths.map { |path| GroupsDir.new(name, self, path) }
  when "nodes"
    dirs = paths.map { |path| NodesDir.new(name, self, path) }
  when "policy_groups"
    dirs = paths.map { |path| PolicyGroupsDir.new(name, self, path) }
  when "policies"
    dirs = paths.map { |path| PoliciesDir.new(name, self, path) }
  when "roles"
    dirs = paths.map { |path| RolesDir.new(name, self, path) }
  when "users"
    dirs = paths.map { |path| UsersDir.new(name, self, path) }
  else
    raise "Unknown top level path #{name}"
  end
  MultiplexedDir.new(dirs)
end
root_dir() click to toggle source

A FileSystemEntry representing the root path where invites.json, members.json and org.json may be found.

# File lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb, line 163
def root_dir
  existing_paths = root_paths.select { |path| File.exist?(path) }
  if existing_paths.size > 0
    MultiplexedDir.new(existing_paths.map do |path|
      dir = FileSystemEntry.new(name, parent, path)
      dir.write_pretty_json = !!write_pretty_json
      dir
    end)
  end
end