salt.runners.lxc¶

Control Linux Containers via Salt

salt.runners.lxc.find_guest(name, quiet=False)¶

Returns the host for a container.

salt-run lxc.find_guest name

salt.runners.lxc.freeze(name, quiet=False)¶

Freeze the named container

salt-run lxc.freeze name

salt.runners.lxc.info(name, quiet=False)¶

Returns information about a container.

salt-run lxc.info name

salt.runners.lxc.init(name, host=None, **kwargs)¶

Initialize a new container

salt-run lxc.init name host=minion_id [cpuset=cgroups_cpuset] \
        [cpushare=cgroups_cpushare] [memory=cgroups_memory] \
        [nic=nic_profile] [profile=lxc_profile] \
        [nic_opts=nic_opts] [start=(true|false)] \
        [seed=(true|false)] [install=(true|false)] \
        [config=minion_config]

name

Name of the container.

host

Minion to start the container on. Required.

cpuset

cgroups cpuset.

cpushare

cgroups cpu shares.

memory

cgroups memory limit, in MB.

nic

Network interfaces profile (defined in config or pillar).

profile

A LXC profile (defined in config or pillar).

nic_opts

Extra options for network interfaces. E.g: {"eth0": {"mac": "aa:bb:cc:dd:ee:ff", "ipv4": "10.1.1.1", "ipv6": "2001:db8::ff00:42:8329"}}

start

Start the newly created container.

seed

Seed the container with the minion config and autosign its key. Default: true

install

If salt-minion is not already installed, install it. Default: true

config

Optional config paramers. By default, the id is set to the name of the container.

salt.runners.lxc.list_(host=None, quiet=False)¶

List defined containers (running, stopped, and frozen) for the named (or all) host(s).

salt-run lxc.list [host=minion_id]

salt.runners.lxc.purge(name, delete_key=True, quiet=False)¶

Purge the named container and delete its minion key if present. WARNING: Destroys all data associated with the container.

salt-run lxc.purge name

salt.runners.lxc.start(name, quiet=False)¶

Start the named container.

salt-run lxc.start name

salt.runners.lxc.stop(name, quiet=False)¶

Stop the named container.

salt-run lxc.stop name

salt.runners.lxc.unfreeze(name, quiet=False)¶

Unfreeze the named container

salt-run lxc.unfreeze name