Jan Gehring > Rex-0.43.2 > Rex::Box::Base

Download:
Rex-0.43.2.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  5
Open  1
View/Report Bugs
Source   Latest Release: Rex-0.49.1

NAME ^

Rex::Box::Base - Rex/Boxes Base Module

DESCRIPTION ^

This is a Rex/Boxes base module.

METHODS ^

These methods are shared across all other Rex::Box modules.

info

Returns a hashRef of vm information.

name($vmname)

Sets the name of the virtual machine.

setup(@tasks)

Sets the tasks that should be executed as soon as the VM is available throu SSH.

import_vm()

This method must be overwriten by the implementing class.

stop()

Stops the VM.

start()

Starts the VM.

ip()

Return the ip:port to which rex will connect to.

status()

Returns the status of a VM.

Valid return values are "running" and "stopped".

provision_vm([@tasks])

Execute's the given tasks on the VM.

cpus($count)

Set the amount of CPUs for the VM.

memory($memory_size)

Sets the memory of a VM in megabyte.

network(%option)

Configure the network for a VM.

Currently it supports 2 modes. nat and bridged. Currently it supports only one network card.

 $box->network(
    1 => {
       type => "nat",
    },
 }
    
 $box->network(
    1 => {
       type => "bridged",
       bridge => "eth0",
    },
 );
url($url)

The URL where to download the Base VM Image. You can use self-made images or prebuild images from http://box.rexify.org/.

auth(%option)

Configure the authentication to the VM.

 $box->auth(
    user => $user,
    password => $password,
    private_key => $private_key,
    public_key => $public_key,
 );
syntax highlighting: