Control Linux Containers via Salt
lxc execution module
Wrapper for using lxc.init in saltcloud compatibility mode
Name of the containers, supports a single name or a comma delimited list of names.
Minion to start the container on. Required.
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
init the container with the saltcloud opts format instead
Returns the host for a container.
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.find_guest name
Return a dict of hosts and named guests
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
Freeze the named container
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.freeze name
Returns information about a container.
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.info name
Initialize a new container
salt-run lxc.init name host=minion_id [cpuset=cgroups_cpuset] \
[cpushare=cgroups_cpushare] [memory=cgroups_memory] \
[template=lxc_template_name] [clone=original name] \
[profile=lxc_profile] [network_proflile=network_profile] \
[nic=network_profile] [nic_opts=nic_opts] \
[start=(true|false)] [seed=(true|false)] \
[install=(true|false)] [config=minion_config] \
[snapshot=(true|false)]
Name of the containers, supports a single name or a comma delimited list of names.
Minion on which to initialize the container (required)
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
init the container with the saltcloud opts format instead See lxc.init_interface module documentation
cgroups cpuset.
cgroups cpu shares.
cgroups memory limit, in MB
Changed in version 2015.5.0: If no value is passed, no limit is set. In earlier Salt versions,
not passing this value causes a 1024MB memory limit to be set, and
it was necessary to pass memory=0
to set no limit.
Name of LXC template on which to base this container
Clone this container from an existing container
A LXC profile (defined in config or pillar).
Network profile to use for the container
New in version 2015.5.2.
Deprecated since version 2015.5.0: Use network_profile
instead
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 the newly created container.
Seed the container with the minion config and autosign its key. Default: true
If salt-minion is not already installed, install it. Default: true
Optional config parameters. By default, the id is set to the name of the container.
List defined containers (running, stopped, and frozen) for the named (or all) host(s).
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.list [host=minion_id]
Purge the named container and delete its minion key if present. WARNING: Destroys all data associated with the container.
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.purge name
Start the named container.
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.start name
Stop the named container.
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.stop name
Unfreeze the named container
path to the container parent default: /var/lib/lxc (system default)
New in version 2015.8.0.
salt-run lxc.unfreeze name