Current File : //lib/python2.7/site-packages/salt/modules/apache.pyo
�
���^c @� s~ d Z d d l m Z m Z m Z m Z m Z d d l Z d d l Z d d l m
Z
d d l m Z d d l
m Z d d l m Z m Z 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 m Z e j! e" � Z# d � Z$ d
� Z% d � Z& d � Z' d
� Z( d � Z) d � Z* d � Z+ d d � Z- d d � Z. d � Z/ d d � Z0 d d � Z1 e2 d � Z3 d S( u)
Support for Apache
.. note::
The functions in here are generic functions designed to work with
all implementations of Apache. Debian-specific functions have been moved into
deb_apache.py, but will still load under the ``apache`` namespace when a
Debian-based system is detected.
i ( t absolute_importt
generatorst print_functiont with_statementt unicode_literalsN( t six( t cStringIO( t URLError( t HTTPBasicAuthHandlert HTTPDigestAuthHandlert urlopent build_openert install_opener( t
SaltExceptionc C� s, t � } t j j j | � r" d St d f S( u5
Only load the module if apache is installed
u apacheuF The apache execution module cannot be loaded: apache is not installed.( t
_detect_ost saltt utilst patht whicht False( t cmd( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt __virtual__) s c C� s> t d } | d k r d S| d k s2 | d k r6 d Sd Sd S( uA
Apache commands and paths differ depending on packaging
u os_familyu RedHatu apachectlu Debianu Suseu
apache2ctlN( t
__grains__( t os_family( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyR 3 s
c C� sC d j t � � } t d | � j � } | d j d � } | d S( u
Return server version (``apachectl -v``)
CLI Example:
.. code-block:: bash
salt '*' apache.version
u {0} -vu cmd.runi u : i ( t formatR t __salt__t
splitlinest split( R t outt ret( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt versionA s
c C� s� d j t � � } i } g | d <t d | � j � } t j d � } x� | D]� } d | k r� | j d � } | s{ qN n | d j � | | d j � j � j d d � <qN d
| k rN | j
d | � } | d j | � qN qN W| S( u�
Return server version (``apachectl -V``)
CLI Example:
.. code-block:: bash
salt '*' apache.fullversion
u {0} -Vu
compiled_withu cmd.runu ^\s+-D\s+u : i i u u _u -Du ( R R R R t ret compileR t stript lowert replacet subt append( R R R t define_ret linet compst cwith( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt fullversionQ s
3 c C� s� d j t � � } i } g | d <g | d <t d | � j � } xn | D]f } | j � } | sg qI n d | k r� | d j | d � n d | k rI | d j | d � qI qI W| S( u�
Return list of static and shared modules (``apachectl -M``)
CLI Example:
.. code-block:: bash
salt '*' apache.modules
u {0} -Mu staticu sharedu cmd.runu (static)i u (shared)( R R R R R R% ( R R R R' R( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt modulesn s
c C� sq d j t � � } g } t d | � j � } x< | D]4 } | sG q5 n d | k r5 | j | j � � q5 q5 W| S( u�
Return list of modules compiled into the server (``apachectl -l``)
CLI Example:
.. code-block:: bash
salt '*' apache.servermods
u {0} -lu cmd.runu .c( R R R R R% R! ( R R R R' ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt
servermods� s
c C� s� d j t � � } i } t d | � } | j d d � } xP | j � D]B } | sY qG n | j d � } d j | d � } | | | d <qG W| S( u�
Return list of directives together with expected arguments
and places where the directive is valid (``apachectl -L``)
CLI Example:
.. code-block:: bash
salt '*' apache.directives
u {0} -Lu cmd.runu
u u
i i ( R R R R# R R t join( R R R R' R( t desc( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt
directives� s c C� sb d j t � � } i } d } t d | � } x-| j � D] } | sM q; n | j � } d | k r| | d } i | | <q; | d d k r� i | | d <| d | | d d <t j d d | d
� | | d d <n | d d k r; i | | | d
<| d
| | | d
d <t j d d | d
� | | | d
d <| d | | | d
d <q; q; W| S( uj
Show the settings as parsed from the config file (currently
only shows the virtualhost settings) (``apachectl -S``).
Because each additional virtual host adds to the execution
time, this command may require a long timeout be specified
by using ``-t 10``.
CLI Example:
.. code-block:: bash
salt -t 10 '*' apache.vhosts
u {0} -Su u cmd.runu is a NameVirtualHosti u defaulti u vhostu \(|\)i u confu porti i ( R R R R R R R$ ( R R t namevhostR R' R( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt vhosts� s6
!c C� s� d } d } | | k r( | | k r( d S| | k rF d
j | � } n d j | � } t � | } t d | � } | d
r� | d r� | d j � } nI | d r� | d j � } n, | d r� | d j � } n d j | � } | S( u�
Signals httpd to start, restart, or stop.
CLI Example:
.. code-block:: bash
salt '*' apache.signal restart
u
configtestu statusu
fullstatusu startu stopu restartu gracefulu
graceful-stopNu -k {0}u {0}u cmd.run_allu retcodeu stderru stdoutu& Command: "{0}" completed successfully!( u
configtestu statusu
fullstatus( u startu stopu restartu gracefulu
graceful-stop( R R R R! ( t signalt
no_extra_argst
valid_signalst argumentsR R R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyR2 � s"
u c C� s t d | | | | � S( u{
Add HTTP user using the ``htpasswd`` command. If the ``htpasswd`` file does not
exist, it will be created. Valid options that can be passed are:
.. code-block:: text
n Don't update file; display results on stdout.
m Force MD5 hashing of the password (default).
d Force CRYPT(3) hashing of the password.
p Do not hash the password (plaintext).
s Force SHA1 hashing of the password.
CLI Examples:
.. code-block:: bash
salt '*' apache.useradd /etc/httpd/htpasswd larry badpassword
salt '*' apache.useradd /etc/httpd/htpasswd larry badpass opts=ns
u webutil.useradd( R ( t pwfilet usert passwordt opts( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt useradd s c C� s t d | | � S( u�
Delete HTTP user from the specified ``htpasswd`` file.
CLI Example:
.. code-block:: bash
salt '*' apache.userdel /etc/httpd/htpasswd larry
u webutil.userdel( R ( R6 R7 ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt userdel s
u defaultc
C� sm i i d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d
6d d 6d d 6d
6} t d d j | � d � } t d d j | � d � } t d d j | � d � } t d d j | � d � } t d d j | � d � } | r^| r^t � } | j d | d | d | d | � t � } | j d | d | d | d | � t t | | � � n | d 7} y" t | d | �j � j � } Wn t
k
r�d SXx� | D]� }
|
j d d � } | d j � | d <| d j � | d <| d d
k r"xl | d D] } | d
| c d 7<qWq�| d j
� rMt | d � | | d <q�t | d � | | d <q�W| S( ur
Get Information from the Apache server-status handler
.. note::
The server-status handler is disabled by default.
In order for this function to work it needs to be enabled.
See http://httpd.apache.org/docs/2.2/mod/mod_status.html
The following configuration needs to exists in pillar/grains.
Each entry nested in ``apache.server-status`` is a profile of a vhost/server.
This would give support for multiple apache servers/vhosts.
.. code-block:: yaml
apache.server-status:
default:
url: http://localhost/server-status
user: someuser
pass: password
realm: 'authentication realm for digest passwords'
timeout: 5
CLI Examples:
.. code-block:: bash
salt '*' apache.server_status
salt '*' apache.server_status other-profile
i u _u Su Ru Wu Ku Du Cu Lu Gu Iu .u
Scoreboardu
config.getu apache.server-status:{0}:urlu http://localhost/server-statusu apache.server-status:{0}:useru u apache.server-status:{0}:passu apache.server-status:{0}:realmu apache.server-status:{0}:timeouti t realmt uriR7 t passwdu ?autot timeoutu erroru :i ( R R t _HTTPBasicAuthHandlert add_passwordt _HTTPDigestAuthHandlert _install_openert
_build_openert _urlopent readR R R R! t isdigitt intt float(
t profileR t urlR7 R> R< R? t basict digestt responseR' t spltt c( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt
server_status, sd " "
"
c C� s� t � } t | t j � rh | rF t d j | | � d | d d �q�t d j | � d | d d �nOt | t � r�t } x6 | D]. } d | k r� t } t j | d � } q� q� W| rSt d j | | � d | �x\ | D]T } xK | j
� D]= \ } } | d k r� t t | t j | � � d | �q� q� Wq� Wt d j | � d | �q�xa| D]( } t t | t j | � � d | �qZWn.t | t � r�y$ t d j | | d � d | �Wn& t
k
r�t d j | � � � n Xx� t j | � D]� \ } } | d k r�t | t j � r>t d j | | � d | �q�t | t � rit t | | � d | �q�t | t � r�t t | | � d | �q�q�q�Wt d j | � d | �n | j d
� | j � S( u�
Recursively goes through config structure and builds final Apache configuration
:param conf: defined config structure
:param slot: name of section container if needed
u {0} {1}t filet endu u {0}u thisu <{0} {1}>u </{0}>uP Apache section container "<{0}>" expects attribute. Specify it using key "this".i ( R t
isinstanceR t string_typest printR t listR t Truet text_typet itemst
_parse_configt dictt KeyErrorR
t iteritemst seekRF ( t conft slotR t
is_sectiont itemt slot_thist keyt valt value( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyR[ � sJ %"
-
)$
#
c C� s� g } x= | D]5 } t t j | � � } | j t | | | � � q
Wd j t j j j | � � } | r� t j j
j | d � �0 } | j d � | j t j j
j | � � Wd QXn | S( u�
Create VirtualHost configuration files
name
File for the virtual host
config
VirtualHost configurations
.. note::
This function is not meant to be used from the command line.
Config is meant to be an ordered dict of all of the apache configs.
CLI Example:
.. code-block:: bash
salt '*' apache.config /etc/httpd/conf.d/ports.conf config="[{'Listen': '22'}]"
u
u wu # This file is managed by Salt.
N( t nextR t iterkeysR% R[ R- R R t datat decodet filest fopent writet stringutilst to_str( t namet configt editt configst entryRe t configstextt
configfile( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyRr � s
%(4 t __doc__t
__future__R R R R R R t loggingt salt.extR t salt.ext.six.movesR t salt.ext.six.moves.urllib.errorR t! salt.ext.six.moves.urllib.requestR R@ R RB R
RE R RD R RC t salt.utils.dataR t salt.utils.filest salt.utils.patht salt.utils.stringutilst salt.exceptionsR
t getLoggert __name__t logR R R R* R+ R, R/ R1 t NoneR2 R: R; RQ R[ RX Rr ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/apache.pyt <module>
s6 ( (
. %
g 1
Mini Shell