Ensure a container is not present, destroying it if present
web01:
lxc.absent
Deprecated since version 2015.5.0.
Use lxc.present
Deprecated since version 2015.5.0.
Use lxc.present
Warning
This state is unsuitable for setting parameters that appear more than once in an LXC config file, or parameters which must appear in a certain order (such as when configuring more than one network interface). It is slated to be replaced, and as of version 2015.5.0 it is deprecated.
Edit LXC configuration options
setconf:
lxc.edited_conf:
- name: ubuntu
- lxc_conf:
- network.ipv4.ip: 10.0.3.6
- lxc_conf_unset:
- lxc.utsname
New in version 2015.5.0.
Ensure that a container is frozen
Note
This state does not enforce the existence of the named container, it just freezes the container if it is running. To ensure that the named container exists, use lxc.present.
web01:
lxc.frozen
web02:
lxc.frozen:
- start: False
Changed in version 2015.5.0: The lxc.created state has been renamed to lxc.present, and the lxc.cloned state has been merged into this state.
Create the named container if it does not exist
New in version 2015.5.0.
Container Creation Arguments
The template to use. E.g., 'ubuntu' or 'fedora'. Conflicts with the image argument.
Note
The download template requires the following three parameters to be defined in options:
The available images can be listed using the lxc.images function.
New in version 2015.5.0.
Template-specific options to pass to the lxc-create command. These correspond to the long options (ones beginning with two dashes) that the template script accepts. For example:
web01:
lxc.present:
- template: download
- options:
dist: centos
release: 6
arch: amd64
Remember to double-indent the options, due to how PyYAML works.
Changed in version 2015.5.0: The lxc.started state has been renamed to lxc.running
Ensure that a container is running
Note
This state does not enforce the existence of the named container, it just starts the container if it is not running. To ensure that the named container exists, use lxc.present.
web01:
lxc.running
web02:
lxc.running:
- restart: True
Deprecated since version 2015.5.0.
This state function has been disabled, as it did not conform to design guidelines. Specifically, due to the fact that lxc.set_password uses chpasswd(8) to set the password, there was no method to make this action idempotent (in other words, the password would be changed every time). This makes this state redundant, since the following state will do the same thing:
setpass:
module.run:
- name: set_pass
- m_name: root
- password: secret
Deprecated since version 2015.5.0.
Use lxc.running
Ensure that a container is stopped
Note
This state does not enforce the existence of the named container, it just stops the container if it running or frozen. To ensure that the named container exists, use lxc.present, or use the lxc.absent state to ensure that the container does not exist.
Do not wait for the container to stop, kill all tasks in the container. Older LXC versions will stop containers like this irrespective of this argument.
New in version 2015.5.0.
web01:
lxc.stopped
Docs for previous releases are available on readthedocs.org.
Latest Salt release: 2014.7.2
22.27.66. salt.states.lvs_service