Current File : //usr/lib/python2.7/site-packages/salt/states/netntp.pyo
�
���^c @@ sU d Z d d l m Z m Z m Z d d l Z d d l m Z d d l Z y* d d l
m Z d d l m
Z
e Z Wn e k
r� e Z n Xy d d l Z e Z Wn e k
r� e Z n Xd Z e j e � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z! d � Z" d � Z# d d � Z$ d d d � Z& d S( uI
Network NTP
===========
.. versionadded: 2016.11.0
Manage the configuration of NTP peers and servers on the network devices through the NAPALM proxy.
:codeauthor: Mircea Ulinic <mircea@cloudflare.com> & Jerome Fleury <jf@cloudflare.com>
:maturity: new
:depends: napalm
:platform: unix
Dependencies
------------
- Requires netaddr_ to be installed: `pip install netaddr` to check if IP
Addresses are correctly specified
- Requires dnspython_ to be installed: `pip install dnspython` to resolve the
nameserver entities (in case the user does not configure the peers/servers
using their IP addresses)
- :mod:`NAPALM proxy minion <salt.proxy.napalm>`
- :mod:`NTP operational and configuration management module <salt.modules.napalm_ntp>`
.. _netaddr: https://pythonhosted.org/netaddr/
.. _dnspython: http://www.dnspython.org/
i ( t absolute_importt print_functiont unicode_literalsN( t six( t IPAddress( t AddrFormatErroru netntpc C@ s t j j j t t t � S( u_
NAPALM library must be installed for this module to work and run in a (proxy) minion.
( t saltt utilst napalmt virtualt __opts__t __virtualname__t __file__( ( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt __virtual__E s c C@ s& i | d 6i d 6t d 6d d 6} | S( Nu nameu changesu resultu u comment( t False( t namet ret( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _default_retP s
c C@ s t d � S( u Retrieves configured NTP peersu ntp.peers( t __salt__( ( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _retrieve_ntp_peers[ s c C@ s t d � S( u Retrieves configured NTP serversu ntp.servers( R ( ( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _retrieve_ntp_serversb s c C@ s t | t � s t Sx$ | D] } t | t j � s t Sq Wt sD t Sg } x� | D]� } y | j t j t | � � � WqQ t
k
r� t s� qQ n g } y t j
j | � } Wn t j
j k
r� t SXx( | D] } | j t j | � � q� WqQ XqQ W| } t S( u_ Checks whether the input is a valid list of peers and transforms domain names into IP Addresses( t
isinstancet listR R t string_typest HAS_NETADDRt Truet appendt text_typeR R t HAS_DNSRESOLVERt dnst resolvert queryt NoAnswer( t peerst peert
ip_only_peerst dns_replyt dns_ip( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _checki s.
"c C@ s g | D] } | r | ^ q S( N( ( t lstt elem( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _clean� s c C@ s t d d t | � S( u Calls ntp.set_peers.u
ntp.set_peerst commit( R R ( R! ( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _set_ntp_peers� s c C@ s t d d t | � S( u Calls ntp.set_servers.u ntp.set_serversR* ( R R ( t servers( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _set_ntp_servers� s c C@ s t d d t | � S( u Calls ntp.delete_peers.u ntp.delete_peersR* ( R R ( R! ( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _delete_ntp_peers� s c C@ s t d d t | � S( u Calls ntp.delete_servers.u ntp.delete_serversR* ( R R ( R, ( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _delete_ntp_servers� s c G@ s5 | t t � j � � k r1 t � j | � | � Sd S( N( R t globalst keyst gett None( R t kargs( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _exec_fun� s u peersc C@ s� t | � } d d g } | | k r( | Sd j d | � } t | � } | j d t � t k r� d j d | d | j d � � | d <| St | j d i � � } t | � } | | k r� | j i d
j d | � d 6t d 6� | St | | � } t | | � }
t | � } t |
� }
i } | r3| | d <n |
rF|
| d <n | j i | d
6� t
d t k r�| j i d d 6d d 6� | St } t }
d } | rd j d | � } t | | � } | j d � r�t } qt }
| d j d | d | j d � � 7} n |
rud j d | � } t | |
� } | j d � rGt } qut }
| d j d | d | j d � � 7} n | j i |
d 6| d 6| d 6� | S( Nu peersu serversu _retrieve_ntp_{what}t whatu resultu4 Cannot retrieve NTP {what} from the device: {reason}t reasonu commentu outu( NTP {what} already configured as needed.u addedu removedu changesu testu, Testing mode: configuration was not changed!u u _set_ntp_{what}u Cannot set NTP {what}: {reason}u _delete_ntp_{what}u" Cannot remove NTP {what}: {reason}u successfully_changedu expected_config_change( R t formatR5 R2 R t sett updateR R R) R
R3 ( t fun_namet
peers_serversR t _rett _optionst
_retrieve_funt ntp_list_outputt configured_ntp_listt desired_ntp_listt list_to_sett list_to_deletet changest expected_config_changet successfully_changedt commentt _set_funt _sett _delete_funt _removed( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt _check_diff_and_configure� sz
c
C@ s� t | � } | j d t � } | j d d � } | j d i � } t | t � p] t | t � sd | St | t � r� t | � r� d | d <| St | t � r� t | � r� d | d <| St } t } t | t � rft | | d d �} | j d t � } | j d
t � } | o!| j d t � } | d | j d d � 7} | j d i � }
|
rf|
| d <qfn t | t � rt | | d d �} | p�| j d t � } | o�| j d
t � } | o�| j d t � } | d | j d d � 7} | j d i � } | r| | d <qn | j i | d 6� | p1| sS| j i t d 6d
d 6� | St d t k r�| j i d d 6d d 6� | S| r�t d � \ }
} |
o�| } | | 7} n | j i | d 6| d 6� | S( u�
Manages the configuration of NTP peers and servers on the device, as specified in the state SLS file.
NTP entities not specified in these lists will be removed whilst entities not configured on the device will be set.
SLS Example:
.. code-block:: yaml
netntp_example:
netntp.managed:
- peers:
- 192.168.0.1
- 172.17.17.1
- servers:
- 24.124.0.251
- 138.236.128.36
Output example:
.. code-block:: python
{
'edge01.nrt04': {
'netntp_|-netntp_example_|-netntp_example_|-managed': {
'comment': 'NTP servers already configured as needed.',
'name': 'netntp_example',
'start_time': '12:45:24.056659',
'duration': 2938.857,
'changes': {
'peers': {
'removed': [
'192.168.0.2',
'192.168.0.3'
],
'added': [
'192.168.0.1',
'172.17.17.1'
]
}
},
'result': None
}
}
}
u resultu commentu u changesu> NTP peers must be a list of valid IP Addresses or Domain Namesu@ NTP servers must be a list of valid IP Addresses or Domain NamesR u peersu expected_config_changeu successfully_changedu
u serversu Device configured properly.u testuB This is in testing mode, the device configuration was not changed!u net.config_controlN( R R2 R R R R& R RM R: R
R3 R ( R R! R, R t resultRH RE RG RF t
_peers_rett _changed_peerst _servers_rett _changed_serverst
config_resultt config_comment( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt managed sh 0
(' t __doc__t
__future__R R R t loggingt salt.extR t salt.utils.napalmR t netaddrR t netaddr.coreR R R t ImportErrorR t dns.resolverR R R t getLoggert __name__t logR
R R R R& R) R+ R- R. R/ R5 RM R3 RU ( ( ( s6 /usr/lib/python2.7/site-packages/salt/states/netntp.pyt <module> s<
( e
Mini Shell