Class: R10K::Environment::Git

Inherits:
Base
  • Object
show all
Includes:
Logging
Defined in:
lib/r10k/environment/git.rb

Overview

This class implements an environment based on a Git branch.

Since:

  • 1.3.0

Constant Summary

Constants included from Logging

Logging::LOG_LEVELS

Instance Attribute Summary collapse

Attributes inherited from Base

#basedir, #dirname, #name

Instance Method Summary collapse

Methods included from Logging

formatter, included, level, level=, levels, #logger, #logger_name, outputter, parse_level

Constructor Details

#initialize(name, basedir, dirname, options = {}) ⇒ Git

Initialize the given SVN environment.

Parameters:

  • name (String) —

    The unique name describing this environment.

  • basedir (String) —

    The base directory where this environment will be created.

  • dirname (String) —

    The directory name for this environment.

  • options (Hash) (defaults to: {}) —

    An additional set of options for this environment.

  • options (String) (defaults to: {}) —

    :remote The URL to the remote git repository

  • options (String) (defaults to: {}) —

    :ref The git reference to use for this environment

Since:

  • 1.3.0



39
40
41
42
43
44
45
46
 
# File 'lib/r10k/environment/git.rb', line 39

def initialize(name, basedir, dirname, options = {})
  super
  @remote = options[:remote]
  @ref    = options[:ref]

  @working_dir = R10K::Git::WorkingDir.new(@ref, @remote, @basedir, @dirname)
  @puppetfile  = R10K::Puppetfile.new(@full_path)
end

Instance Attribute Details

#puppetfile ⇒ Object (readonly)

Since:

  • 1.3.0



28
29
30
 
# File 'lib/r10k/environment/git.rb', line 28

def puppetfile
  @puppetfile
end

#ref ⇒ Object (readonly)

Since:

  • 1.3.0



18
19
20
 
# File 'lib/r10k/environment/git.rb', line 18

def ref
  @ref
end

#remote ⇒ Object (readonly)

Since:

  • 1.3.0



14
15
16
 
# File 'lib/r10k/environment/git.rb', line 14

def remote
  @remote
end

#working_dir ⇒ Object (readonly)

Since:

  • 1.3.0



23
24
25
 
# File 'lib/r10k/environment/git.rb', line 23

def working_dir
  @working_dir
end

Instance Method Details

#modules ⇒ Array<R10K::Module::Base>

Returns All modules defined in the Puppetfile associated with this environment.

Returns:

  • (Array<R10K::Module::Base>) —

    All modules defined in the Puppetfile associated with this environment.

Since:

  • 1.3.0



75
76
77
78
 
# File 'lib/r10k/environment/git.rb', line 75

def modules
  @puppetfile.load
  @puppetfile.modules
end

#sync ⇒ void

This method returns an undefined value.

Clone or update the given Git environment.

If the environment is being created for the first time, it will automatically update all modules to ensure that the environment is complete.

Since:

  • 1.3.0



55
56
57
58
59
60
61
62
63
 
# File 'lib/r10k/environment/git.rb', line 55

def sync
  recursive_needed = !(@working_dir.cloned?)
  @working_dir.sync

  if recursive_needed
    logger.debug "Environment #{@full_path} is a fresh clone; automatically updating modules."
    sync_modules
  end
end

#sync_modules ⇒ 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.

Since:

  • 1.3.0



66
67
68
69
70
71
 
# File 'lib/r10k/environment/git.rb', line 66

def sync_modules
  modules.each do |mod|
    logger.debug "Deploying module #{mod.name}"
    mod.sync
  end
end