Current File : //usr/lib/python2.7/site-packages/salt/states/augeas.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
Z d d l Z d d l
Z d d l m Z d d l m Z e j e � Z d � Z d � Z d � Z d d d d d � Z d S(
ut
Configuration management using Augeas
.. versionadded:: 0.17.0
This state requires the ``augeas`` Python module.
.. _Augeas: http://augeas.net/
Augeas_ can be used to manage configuration files.
.. warning::
Minimal installations of Debian and Ubuntu have been seen to have packaging
bugs with python-augeas, causing the augeas module to fail to import. If
the minion has the augeas module installed, and the state fails with a
comment saying that the state is unavailable, first restart the salt-minion
service. If the problem persists past that, the following command can be
run from the master to determine what is causing the import to fail:
.. code-block:: bash
salt minion-id cmd.run 'python -c "from augeas import Augeas"'
For affected Debian/Ubuntu hosts, installing ``libpython2.7`` has been
known to resolve the issue.
i ( t absolute_importt print_functiont unicode_literalsN( t six( t
METHOD_MAPc C@ s d t k r d St S( Nu augeas.executeu augeas( t __salt__t False( ( ( s6 /usr/lib/python2.7/site-packages/salt/states/augeas.pyt __virtual__1 s c C@ sQ t j j | � s | d k r7 | d k r3 d } n | St t j j | � � Sd S( uA
Recursively workout the file name from an augeas change
u /N( t ost patht isfilet Nonet _workout_filenamet dirname( t filename( ( s6 /usr/lib/python2.7/site-packages/salt/states/augeas.pyR 5 s
c C@ s� d } x�| D]|} y| j d d � \ } } | t k rX d j | � } t | � � n t | } t j j j | � } | d k r� | d } n | \ } } } | j d � s� d
j | � } t | � � n t
j d d | � } | d k r | | k r d
j | | � } t | � � q n | } Wq
t t f k
r�}
t
j |
� d t � k rjd j | � } n t j |
� } t | � � q
Xq
Wt | � } | S( u�
Ensure all changes are fully qualified and affect only one file.
This ensures that the diff output works and a state change is not
incorrectly reported.
u i u" Command {0} is not supported (yet)u setu setmu moveu removei u /filesuM Changes should be prefixed with /files if no context is provided, change: {0}u
^/files|/$u uM Changes should be made to one file at a time, detected changes to {0} and {1}u erroru9 Invalid formatted command, see debug log for details: {0}N( u setu setmu moveu remove( R t splitR t formatt
ValueErrort saltt utilst argst shlex_splitt
startswitht ret subt
IndexErrort logt errort localsR t text_typeR ( t changesR t change_t cmdt argR t methodt partst filename_t _t err( ( s6 /usr/lib/python2.7/site-packages/salt/states/augeas.pyt _check_filepathA s@
c K@ s� i | d 6t d 6d d 6i d 6} | s9 t | t � rG d | d <| S| d k r� t | t � sp d | d <| Sd j | � } n d } | d k r� y t | � } Wq� t k
r� } d j | � | d <| SXn t j d
d | � } t
d rCt | d <d | d <| r&| d c d
j | � 7<n | d c d j | � 7<| Sg } | d k r�t j
j | � r�t j j j | d � �5 }
g |
j � D] } t j j j | � ^ q�} Wd QXn t d d | d | d | d | � } | d | d <| d t k rd j | d � | d <| S| d k r�t j
j | � r�t j j j | d � �V }
g |
j � D] } t j j j | � ^ q]}
d j t j | |
d d �� } Wd QX| r�d | d <i | d 6| d <q�d | d <n d | d <i | d 6| d <| S( uS
.. versionadded:: 2014.7.0
This state replaces :py:func:`~salt.states.augeas.setvalue`.
Issue changes to Augeas, optionally for a specific context, with a
specific lens.
name
State name
context
A file path, prefixed by ``/files``. Should resolve to an actual file
(not an arbitrary augeas path). This is used to avoid duplicating the
file name for each item in the changes list (for example, ``set bind 0.0.0.0``
in the example below operates on the file specified by ``context``). If
``context`` is not specified, a file path prefixed by ``/files`` should be
included with the ``set`` command.
The file path is examined to determine if the
specified changes are already present.
.. code-block:: yaml
redis-conf:
augeas.change:
- context: /files/etc/redis/redis.conf
- changes:
- set bind 0.0.0.0
- set maxmemory 1G
changes
List of changes that are issued to Augeas. Available commands are
``set``, ``setm``, ``mv``/``move``, ``ins``/``insert``, and
``rm``/``remove``.
lens
The lens to use, needs to be suffixed with `.lns`, e.g.: `Nginx.lns`.
See the `list of stock lenses <http://augeas.net/stock_lenses.html>`_
shipped with Augeas.
.. versionadded:: 2016.3.0
load_path
A list of directories that modules should be searched in. This is in
addition to the standard load path and the directories in
AUGEAS_LENS_LIB.
Usage examples:
Set the ``bind`` parameter in ``/etc/redis/redis.conf``:
.. code-block:: yaml
redis-conf:
augeas.change:
- changes:
- set /files/etc/redis/redis.conf/bind 0.0.0.0
.. note::
Use the ``context`` parameter to specify the file you want to
manipulate. This way you don't have to include this in the changes
every time:
.. code-block:: yaml
redis-conf:
augeas.change:
- context: /files/etc/redis/redis.conf
- changes:
- set bind 0.0.0.0
- set databases 4
- set maxmemory 1G
Augeas is aware of a lot of common configuration files and their syntax.
It knows the difference between for example ini and yaml files, but also
files with very specific syntax, like the hosts file. This is done with
*lenses*, which provide mappings between the Augeas tree and the file.
There are many `preconfigured lenses`_ that come with Augeas by default,
and they specify the common locations for configuration files. So most
of the time Augeas will know how to manipulate a file. In the event that
you need to manipulate a file that Augeas doesn't know about, you can
specify the lens to use like this:
.. code-block:: yaml
redis-conf:
augeas.change:
- lens: redis.lns
- context: /files/etc/redis/redis.conf
- changes:
- set bind 0.0.0.0
.. note::
Even though Augeas knows that ``/etc/redis/redis.conf`` is a Redis
configuration file and knows how to parse it, it is recommended to
specify the lens anyway. This is because by default, Augeas loads all
known lenses and their associated file paths. All these files are
parsed when Augeas is loaded, which can take some time. When specifying
a lens, Augeas is loaded with only that lens, which speeds things up
quite a bit.
.. _preconfigured lenses: http://augeas.net/stock_lenses.html
A more complex example, this adds an entry to the services file for Zabbix,
and removes an obsolete service:
.. code-block:: yaml
zabbix-service:
augeas.change:
- lens: services.lns
- context: /files/etc/services
- changes:
- ins service-name after service-name[last()]
- set service-name[last()] "zabbix-agent"
- set "service-name[. = 'zabbix-agent']/port" 10050
- set "service-name[. = 'zabbix-agent']/protocol" tcp
- set "service-name[. = 'zabbix-agent']/#comment" "Zabbix Agent service"
- rm "service-name[. = 'im-obsolete']"
- unless: grep "zabbix-agent" /etc/services
.. warning::
Don't forget the ``unless`` here, otherwise it will fail on next runs
because the service is already defined. Additionally you have to quote
lines containing ``service-name[. = 'zabbix-agent']`` otherwise
:mod:`augeas_cfg <salt.modules.augeas_cfg>` execute will fail because
it will receive more parameters than expected.
.. note::
Order is important when defining a service with Augeas, in this case
it's ``port``, ``protocol`` and ``#comment``. For more info about
the lens check `services lens documentation`_.
.. _services lens documentation:
http://augeas.net/docs/references/lenses/files/services-aug.html#Services.record
u nameu resultu u commentu changesu% 'changes' must be specified as a listu' 'load_path' must be specified as a listu :u
Error: {0}u
^/files|/$u testu Executing commandsu in file "{0}":
u
u rNu augeas.executet contextt lenst commandst load_pathu retvalu errort ni u Changes have been savedu diffu No changes madeu updates( R t
isinstancet listR t joinR' R R R R t __opts__t TrueR R R
R R t filest fopent readlinest stringutilst
to_unicodeR t difflibt unified_diff( t nameR( R R) R+ t kwargst retR R& t old_filet file_t xt resultt new_filet diff( ( s6 /usr/lib/python2.7/site-packages/salt/states/augeas.pyt changeq sb �"
4
+!
( t __doc__t
__future__R R R R t os.pathR t loggingR7 t salt.utils.argsR t salt.utils.filest salt.utils.stringutilst salt.extR t salt.modules.augeas_cfgR t getLoggert __name__R R R R' R RB ( ( ( s6 /usr/lib/python2.7/site-packages/salt/states/augeas.pyt <module> s 0
Mini Shell