Class: LXC::Container

Inherits:
Object
  • Object
show all
Defined in:
lib/lxc/container.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name) ⇒ LXC::Container

Initialize a new LXC::Container instance

Parameters:

  • name (String) —

    container name



10
11
12
 
# File 'lib/lxc/container.rb', line 10

def initialize(name)
  @name = name
end

Instance Attribute Details

#name ⇒ Object

Returns the value of attribute name.



3
4
5
 
# File 'lib/lxc/container.rb', line 3

def name
  @name
end

#pid ⇒ Object (readonly)

Returns the value of attribute pid.



5
6
7
 
# File 'lib/lxc/container.rb', line 5

def pid
  @pid
end

#state ⇒ Object (readonly)

Returns the value of attribute state.



4
5
6
 
# File 'lib/lxc/container.rb', line 4

def state
  @state
end

Instance Method Details

#clone_from(source) ⇒ Boolean

Create a new container from an existing container

Parameters:

  • source (String) —

    name of existing container

Returns:

  • (Boolean)

Raises:



170
171
172
173
174
175
176
177
178
 
# File 'lib/lxc/container.rb', line 170

def clone_from(source)
  raise ContainerError, "Container already exists." if exists?
  unless self.class.new(source).exists?
    raise ContainerError, "Source container does not exist."
  end

  LXC.run('clone', '-o', source, '-n', name)
  exists?
end

#clone_to(target) ⇒ LXC::Container

Clone to a new container from self

Parameters:

  • target (String) —

    name of new container

Returns:

Raises:



157
158
159
160
161
162
163
164
165
 
# File 'lib/lxc/container.rb', line 157

def clone_to(target)
  raise ContainerError, "Container does not exist." unless exists?
  if self.class.new(target).exists?
    raise ContainerError, "New container already exists."
  end

  LXC.run('clone', '-o', name, '-n', target)
  self.class.new target
end

#create(path) ⇒ Boolean

Create a new container

Parameters:

  • path (String) —

    path to container config file or [Hash] options

Returns:

  • (Boolean)

Raises:



122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
 
# File 'lib/lxc/container.rb', line 122

def create(path)
  raise ContainerError, "Container already exists." if exists?
  if path.is_a?(Hash)
    args = "-n #{name}"

    if !!path[:config_file]
      unless File.exists?(path[:config_file])
        raise ArgumentError, "File #{path[:config_file]} does not exist."
      end
      args += " -f #{path[:config_file]}"
    end

    if !!path[:template]
      template_path = "/usr/lib/lxc/templates/lxc-#{path[:template]}"
      unless File.exists?(template_path)
        raise ArgumentError, "Template #{path[:template]} does not exist."
      end
      args += " -t #{path[:template]} "
    end

    args += " -B #{path[:backingstore]}" if !!path[:backingstore]
    args += " -- #{path[:template_options].join(' ')}".strip if !!path[:template_options]

    LXC.run('create', args)
    exists?
  else
    raise ArgumentError, "File #{path} does not exist." unless File.exists?(path)
    LXC.run('create', '-n', name, '-f', path)
    exists?
  end
end

#destroy(force = false) ⇒ Boolean

Destroy the container If container is running and force parameter is true it will be stopped first. Otherwise it will raise exception.

Parameters:

  • force (Boolean) (defaults to: false) —

    force destruction

Returns:

  • (Boolean) —

    true if container was destroyed

Raises:



187
188
189
190
191
192
193
194
195
196
197
198
199
200
 
# File 'lib/lxc/container.rb', line 187

def destroy(force=false)
  raise ContainerError, "Container does not exist." unless exists?
  if running?
    if force
      # This will force stop and destroy container automatically
      LXC.run('destroy', '-n', '-f', name)
    else
      raise ContainerError, "Container is running. Stop it first or use force=true"
    end
  else
    LXC.run('destroy', '-n', name)
  end  
  !exists?
end

#exists? ⇒ Boolean

Check if container exists

Returns:

  • (Boolean) 


32
33
34
 
# File 'lib/lxc/container.rb', line 32

def exists?
  LXC.run('ls').split("\n").uniq.include?(name)
end

#freeze ⇒ Hash

Freeze container

Returns:

  • (Hash) —

    container status hash



77
78
79
80
 
# File 'lib/lxc/container.rb', line 77

def freeze
  LXC.run('freeze', '-n', name)
  status
end

#frozen? ⇒ Boolean

Check if container is frozen

Returns:

  • (Boolean) 


44
45
46
 
# File 'lib/lxc/container.rb', line 44

def frozen?
  status[:state] == 'FROZEN'
end

#memory_limit ⇒ Integer

Get container memory limit in bytes

Returns:

  • (Integer) 


106
107
108
 
# File 'lib/lxc/container.rb', line 106

def memory_limit
  LXC.run('cgroup', '-n', name, 'memory.limit_in_bytes').strip.to_i
end

#memory_usage ⇒ Integer

Get container memory usage in bytes

Returns:

  • (Integer) 


100
101
102
 
# File 'lib/lxc/container.rb', line 100

def memory_usage
  LXC.run('cgroup', '-n', name, 'memory.usage_in_bytes').strip.to_i
end

#processes ⇒ Array

Get container processes

Returns:

  • (Array) —

    list of all processes

Raises:



112
113
114
115
116
117
 
# File 'lib/lxc/container.rb', line 112

def processes
  raise ContainerError, "Container is not running" if !running?
  str = LXC.run('ps', '-n', name, '--', '-eo pid,user,%cpu,%mem,args').strip
  lines = str.split("\n") ; lines.delete_at(0)
  lines.map { |l| parse_process_line(l) }
end

#restart ⇒ Hash

Restart container

Returns:

  • (Hash) —

    container status hash



70
71
72
73
 
# File 'lib/lxc/container.rb', line 70

def restart
  stop
  start
end

#running? ⇒ Boolean

Check if container is running

Returns:

  • (Boolean) 


38
39
40
 
# File 'lib/lxc/container.rb', line 38

def running?
  status[:state] == 'RUNNING'
end

#start ⇒ Hash

Start container

Returns:

  • (Hash) —

    container status hash



56
57
58
59
 
# File 'lib/lxc/container.rb', line 56

def start
  LXC.run('start', '-d', '-n', name)
  status
end

#status ⇒ Hash

Get current status of container

Returns:

  • (Hash) —

    hash with :state and :pid attributes



23
24
25
26
27
28
 
# File 'lib/lxc/container.rb', line 23

def status
  str    = LXC.run('info', '-n', name)
  @state = str.scan(/^state:\s+([\w]+)$/).flatten.first
  @pid   = str.scan(/^pid:\s+(-?[\d]+)$/).flatten.first
  {:state => @state, :pid => @pid}
end

#stop ⇒ Hash

Stop container

Returns:

  • (Hash) —

    container status hash



63
64
65
66
 
# File 'lib/lxc/container.rb', line 63

def stop
  LXC.run('stop', '-n', name)
  status
end

#stopped? ⇒ Boolean

Check if container is stopped?

Returns:

  • (Boolean) 


50
51
52
 
# File 'lib/lxc/container.rb', line 50

def stopped?
  exists? && status[:state] == 'STOPPED'
end

#to_hash ⇒ Hash

Get container attributes hash

Returns:

  • (Hash) 


16
17
18
19
 
# File 'lib/lxc/container.rb', line 16

def to_hash
  status
  {'name' => name, 'state' => state, 'pid' => pid}
end

#unfreeze ⇒ Hash

Unfreeze container

Returns:

  • (Hash) —

    container status hash



84
85
86
87
 
# File 'lib/lxc/container.rb', line 84

def unfreeze
  LXC.run('unfreeze', '-n', name)
  status
end

#wait(state) ⇒ Object

Wait for container to change status

Parameters:

  • state (String) —

    state name



91
92
93
94
95
96
 
# File 'lib/lxc/container.rb', line 91

def wait(state)
  if !LXC::Shell.valid_state?(state)
    raise ArgumentError, "Invalid container state: #{state}"
  end
  LXC.run('wait', '-n', name, '-s', state)
end