Current File : //lib/python2.7/site-packages/salt/states/lxc.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d Z d d l m Z m Z e e e
e e e e e e e e e e e e e d � Z e
e d � Z e
e d � Z
e e d � Z e
e d � Z d
� Z e e d � Z d S(
u1
Manage Linux Containers
=======================
i ( t absolute_importt print_functiont unicode_literalsu restructuredtext en( t CommandExecutionErrort SaltInvocationErrorc C@ s0 i | d 6t d 6d j | � d 6i d 6} t | | | f � s� t d | � } t d � | D� � s} t | d <d | d <q� y | d } Wq� t k
r� q� Xn | r� t d
| d | � r� t | d <d j | � | d <n | d s� | S| rd
j | � n d } i t d | d | �d 6} t d r7| d d9 k rxd j | | r]d
j | � n d � | d <d9 | d <| S| d9 k r�| S| r�| d d: k r�d j | | d d k r�d n d � | d <d9 | d <| S| d c d 7<| Sq7| d d; k r d j | � | d <d9 | d <| S| d c d 7<| Sn | d d9 k rcy� | r�t d | | d | d | d | d | d | d! | �} n^ t d" | d | d | d# | d$ | d% | d& | d' |
d | d! | d( |
d | d) | d* | �
} Wn0 t t f k
r} t | d <| j
| d <qcX| r;d+ j | | � | d <n d, j | � | d <| d- d. | d. <n | d t k r�| d9 k r�q�| r�t d | d | �} | d k r�| d c d 7<q�d/ } yk | d k r�d0 n d1 } t | | d | �d- d. | d. <| d. d k r-t | d <| d c | 7<n Wn? t t f k
ro} t | d <| d c d2 j | | � 7<q�X| d d9 k r�| d c d3 7<q�d4 j | | d d k r�d n d � | d <q�t d | d | �} | d k r
| d d9 k r�| d c d 7<q�q�d5 } yS t d6 | d | �d- d. | d. <| d. d k rbt | d <| d c | 7<n Wn? t t f k
r�} t | d <| d c d2 j | | � 7<q�X| d d9 k r�| d c d7 7<q�d8 j | � | d <n d. | k rt d | d | �| d. <n | d | d. k r,| | d d- <n | S(< u9
.. versionchanged:: 2015.8.0
The :mod:`lxc.created <salt.states.lxc.created>` state has been renamed
to ``lxc.present``, and the :mod:`lxc.cloned <salt.states.lxc.cloned>`
state has been merged into this state.
Create the named container if it does not exist
name
The name of the container to be created
path
path to the container parent
default: /var/lib/lxc (system default)
.. versionadded:: 2015.8.0
running : False
* If ``True``, ensure that the container is running
* If ``False``, ensure that the container is stopped
* If ``None``, do nothing with regards to the running state of the
container
.. versionadded:: 2015.8.0
clone_from
Create named container as a clone of the specified container
snapshot : False
Use Copy On Write snapshots (LVM). Only supported with ``clone_from``.
profile
Profile to use in container creation (see the :ref:`LXC Tutorial
<tutorial-lxc-profiles-container>` for more information). Values in a
profile will be overridden by the parameters listed below.
network_profile
Network Profile to use in container creation
(see the :ref:`LXC Tutorial <tutorial-lxc-profiles-container>`
for more information). Values in a profile will be overridden by
the parameters listed below.
.. versionadded:: 2015.5.2
**Container Creation Arguments**
template
The template to use. For example, ``ubuntu`` or ``fedora``.
For a full list of available templates, check out
the :mod:`lxc.templates <salt.modules.lxc.templates>` function.
Conflicts with the ``image`` argument.
.. note::
The ``download`` template requires the following three parameters
to be defined in ``options``:
* **dist** - The name of the distribution
* **release** - Release name/version
* **arch** - Architecture of the container
The available images can be listed using the :mod:`lxc.images
<salt.modules.lxc.images>` function.
options
.. versionadded:: 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:
.. code-block:: yaml
web01:
lxc.present:
- template: download
- options:
dist: centos
release: 6
arch: amd64
Remember to double-indent the options, due to :ref:`how PyYAML works
<nested-dict-indentation>`.
For available template options, refer to the lxc template scripts
which are ususally located under ``/usr/share/lxc/templates``,
or run ``lxc-create -t <template> -h``.
image
A tar archive to use as the rootfs for the container. Conflicts with
the ``template`` argument.
backing
The type of storage to use. Set to ``lvm`` to use an LVM group.
Defaults to filesystem within /var/lib/lxc.
fstype
Filesystem type to use on LVM logical volume
size
Size of the volume to create. Only applicable if ``backing`` is set to
``lvm``.
vgname : lxc
Name of the LVM volume group in which to create the volume for this
container. Only applicable if ``backing`` is set to ``lvm``.
lvname
Name of the LVM logical volume in which to create the volume for this
container. Only applicable if ``backing`` is set to ``lvm``.
thinpool
Name of a pool volume that will be used for thin-provisioning this
container. Only applicable if ``backing`` is set to ``lvm``.
u nameu resultu Container '{0}' already existsu commentu changesu lxc.get_container_profilec s@ s! | ] } | d k r | Vq d S( u templateu imageu
clone_fromN( u templateu imageu
clone_from( ( t .0t x( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pys <genexpr>� s uh No template, image, or clone_from parameter was found in either the state's arguments or the LXC profileu
clone_fromu
lxc.existst pathu! Clone source '{0}' does not existu cloned from {0}u createdu lxc.stateu oldu testu Container '{0}' will be {1}u frozenu stoppedu Container '{0}' would be {1}u unfrozenu startedu and is runningu runningu Container '{0}' would be stoppedu and is stoppedu lxc.clonet profilet network_profilet snapshott sizet backingu
lxc.createt templatet optionst imaget configt fstypet vgnamet lvnamet thinpoolu Cloned container '{0}' as '{1}'u Created container '{0}'u stateu newu , but it could not be startedu lxc.unfreezeu lxc.startu {0}: {1}u , and the container was startedu Container '{0}' was {1}u , but it could not be stoppedu lxc.stopu , and the container was stoppedu Container '{0}' was stoppedN( u frozenu stopped( u frozenu running( t Truet formatt anyt __salt__t Falset KeyErrort __opts__t NoneR R t strerror( t namet runningt
clone_fromR
R R R
R R R R R R R R R R t rett c_profilet actiont statet resultt exct c_statet errort
start_func( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyt present s �
c C@ s� i | d 6i d 6t d 6d j | � d 6} t d | d | �sE | St d rp d | d <d j | � | d <| Sy t d
| d | d | �} Wn6 t t f k
r� } t | d <d j | � | d <n& X| d
| d d
<d j | � | d <| S( u�
Ensure a container is not present, destroying it if present
name
Name of the container to destroy
stop
stop before destroying
default: false
.. versionadded:: 2015.5.2
path
path to the container parent
default: /var/lib/lxc (system default)
.. versionadded:: 2015.8.0
.. code-block:: yaml
web01:
lxc.absent
u nameu changesu resultu Container '{0}' does not existu commentu
lxc.existsR u testu" Container '{0}' would be destroyedu lxc.destroyt stopu Failed to destroy container: {0}u stateu Container '{0}' was destroyedN( R R R R R R R R ( R R+ R R! R% R& ( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyt absentM s$
c C@ s� i | d 6t d 6d j | � d 6i d 6} i t d | d | �d 6} | d d k ry t | d <d j | � | d <| S| d d
k r� | r� | S| d d k r� | r� t } n | r� | d d k r� d } q� d } n | d d k r� d! } n d" } t d r,d | d <d j | | d � | d <| Syi | d d k r_| r_t d | d | �} n5 | r~t d | d | �} n t d | d | �} WnJ t t f k
r�} t | d <| j | d <t d | d | �| d <n� X| d d | d <| d d
k r+t | d <d j | d | � | d <n d j | | d � | d <y | d
| d d
<Wn t k
rnn X| d | d k r�| | d d <n | S(# u4
.. versionchanged:: 2015.5.0
The :mod:`lxc.started <salt.states.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 :mod:`lxc.present
<salt.states.lxc.present>`.
name
The name of the container
path
path to the container parent
default: /var/lib/lxc (system default)
.. versionadded:: 2015.8.0
restart : False
Restart container if it is already running
.. code-block:: yaml
web01:
lxc.running
web02:
lxc.running:
- restart: True
u nameu resultu" Container '{0}' is already runningu commentu changesu lxc.stateR u oldu Container '{0}' does not existu runningu stoppedu restartu restartedu startu startedu frozenu unfreezeu unfrozenu testu Container '{0}' would be {1}i u lxc.unfreezeu lxc.restartu lxc.startu newu stateu Unable to {0} container '{1}'i u$ Container '{0}' was successfully {1}N( u restartu restarted( u startu started( u unfreezeu unfrozen( u startu started(
R R R R R R R R R R ( R t restartR R! R$ R# R% R& ( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyR sb $
c C@ sG i | d 6t d 6d j | � d 6i d 6} i t d | d | �d 6} | d d k rx t | d <d j | � | d <n7 | d d
k r� | r� t | d <d j | � | d <n | d t k s� | d d k r� | S| d d
k r� d } n d } t d r$d | d <d j | | d � | d <| Sy t d | d | d | �} WnJ t t f k
r�} t | d <| j | d <t d | d | �| d <n� X| d d | d <| d d k r�t | d <d j | d | � | d <n d j | | d � | d <y | d | d d <Wn t k
r n X| d | d k rC| | d d <n | S( u
.. versionadded:: 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 :mod:`lxc.present <salt.states.lxc.present>`.
name
The name of the container
path
path to the container parent
default: /var/lib/lxc (system default)
.. versionadded:: 2015.8.0
start : True
Start container first, if necessary. If ``False``, then this state will
fail if the container is not running.
.. code-block:: yaml
web01:
lxc.frozen
web02:
lxc.frozen:
- start: False
u nameu resultu! Container '{0}' is already frozenu commentu changesu lxc.stateR u oldu Container '{0}' does not existu stoppedu Container '{0}' is stoppedu frozenu start and freezeu started and frozenu freezeu testu Container '{0}' would be {1}i u
lxc.freezet startu newu stateu Unable to {0} container '{1}'i u$ Container '{0}' was successfully {1}u startedN( u start and freezeu started and frozen( u freezeu frozen(
R R R R R R R R R R ( R R. R R! R$ R# R% R& ( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyt frozen� sR #
c C@ s� i | d 6t d 6d j | � d 6i d 6} i t d | d | �d 6} | d d k ry t | d <d j | � | d <| S| d d
k r� | S| r� d } n d } t d r� d | d <d j | | d � | d <| Sy t d | d | d | �} WnJ t t f k
r@} t | d <| j | d <t d | d | �| d <nd X| d d | d <| d d
k r�t | d <d j | d | � | d <n d j | | d � | d <| d | d k r�| | d d <n | S( u~
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 :mod:`lxc.present
<salt.states.lxc.present>`, or use the :mod:`lxc.absent
<salt.states.lxc.absent>` state to ensure that the container does not
exist.
name
The name of the container
path
path to the container parent
default: /var/lib/lxc (system default)
.. versionadded:: 2015.8.0
kill : False
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.
.. versionadded:: 2015.5.0
.. code-block:: yaml
web01:
lxc.stopped
u nameu resultu" Container '{0}' is already stoppedu commentu changesu lxc.stateR u oldu Container '{0}' does not existu stoppedu
force-stopu
force-stoppedu stopu testu Container '{0}' would be {1}i u lxc.stopt killu newu stateu Unable to {0} container '{1}'i u$ Container '{0}' was successfully {1}N( u
force-stopu
force-stopped( u stopu stopped( R R R R R R R R R ( R R0 R R! R$ R# R% R& ( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyt stopped: sF "
c K@ s i | d 6d d 6t d 6i d 6S( un
.. deprecated:: 2015.5.0
This state function has been disabled, as it did not conform to design
guidelines. Specifically, due to the fact that :mod:`lxc.set_password
<salt.modules.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:
.. code-block:: yaml
setpass:
module.run:
- name: set_pass
- m_name: root
- password: secret
u nameuo The lxc.set_pass state is no longer supported. Please see the LXC states documentation for further information.u commentu resultu changes( R ( R t kwargs( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyt set_pass� s
c C@ s{ t d r3 i | d 6d j | � d 6t d 6i d 6S| sB i } n | sQ i } n t d | d | d | �} | | d <| S(
u\
.. 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).
`Issue #35523`_ was opened to track the addition of a suitable replacement
or fix.
Edit LXC configuration options
.. deprecated:: 2015.5.0
path
path to the container parent
default: /var/lib/lxc (system default)
.. versionadded:: 2015.8.0
.. code-block:: bash
setconf:
lxc.edited_conf:
- name: ubuntu
- lxc_conf:
- network.ipv4.ip: 10.0.3.6
- lxc_conf_unset:
- lxc.utsname
.. _`Issue #35523`: https://github.com/saltstack/salt/issues/35523
u testu nameu {0} lxc.conf will be editedu commentu resultu changesu lxc.update_lxc_conft lxc_conft lxc_conf_unset( R R R R ( R R4 R5 t cret( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyt edited_conf� s $
N( t __doc__t
__future__R R R t
__docformat__t salt.exceptionsR R R R R* R, R R R/ R1 R3 R7 ( ( ( s3 /usr/lib/python2.7/site-packages/salt/states/lxc.pyt <module> s4 � /2dWO
Mini Shell