Current File : //usr/lib/python2.7/site-packages/salt/modules/purefb.pyo
�
���^c @@ sc d Z d d l m Z m Z m Z d d l Z d d l m Z d d l m Z d d l m
Z
yH d d l m Z m
Z
m Z m Z d d l m Z m Z m Z e Z Wn e k
r� e Z n Xd Z d
Z d � Z d � Z d
� Z d � Z d � Z d d � Z d e d � Z d d � Z! d d d e d � Z" e d � Z# d � Z$ d � Z% e d � Z& d S( u)
Management of Pure Storage FlashBlade
Installation Prerequisites
--------------------------
- You will need the ``purity_fb`` python package in your python installation
path that is running salt.
.. code-block:: bash
pip install purity_fb
- Configure Pure Storage FlashBlade authentication. Use one of the following
three methods.
1) From the minion config
.. code-block:: yaml
pure_tags:
fb:
san_ip: management vip or hostname for the FlashBlade
api_token: A valid api token for the FlashBlade being managed
2) From environment (PUREFB_IP and PUREFB_API)
3) From the pillar (PUREFB_IP and PUREFB_API)
:maintainer: Simon Dodsley (simon@purestorage.com)
:maturity: new
:requires: purestorage
:platform: all
.. versionadded:: 2019.2.0
i ( t absolute_importt print_functiont unicode_literalsN( t datetime( t six( t CommandExecutionError( t PurityFbt
FileSystemt FileSystemSnapshott SnapshotSuffix( t restt NfsRulet ProtocolRuleu restructuredtext enu purefbc C@ s t r
t St d f S( u6
Determine whether or not to load this module
uK purefb execution module not loaded: purity_fb python library not available.( t
HAS_PURITY_FBt __virtualname__t False( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt __virtual__L s c C@ s[ yW t d d j d � } t d d j d � } | rV t rV t | � } | j � n Wn� t t t f k
r%yG t j j d � } t j j d � } | r� t | � } | j � n Wq&t
t t f k
r!y( t d } t t d � } | j � Wq"t t f k
r t d � � q"Xq&Xn Xy | j
| � Wn t k
rVt d � � n X| S( ub
Get Pure Storage FlasBlade configuration
1) From the minion config
pure_tags:
fb:
san_ip: management vip or hostname for the FlashBlade
api_token: A valid api token for the FlashBlade being managed
2) From environment (PUREFB_IP and PUREFB_API)
3) From the pillar (PUREFB_IP and PUREFB_API)
u pure_tagsu fbu san_ipu api_tokenu PUREFB_IPu
PUREFB_APIu- No Pure Storage FlashBlade credentials found.u. Pure Storage FlashBlade authentication failed.( t __opts__t gett apiR t disable_verify_sslt KeyErrort NameErrort TypeErrort ost environt
ValueErrort
__pillar__R t logint Exception( t
blade_namet api_tokent blade( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt
_get_bladeU s2
c C@ sS g } | j | � y$ | j j d | � } | j d SWn t j k
rN d SXd S( uE
Private function to
check for existance of a filesystem
t namesi N( t appendt file_systemst list_file_systemst itemsR
t ApiExceptiont None( t nameR t _fst res( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt _get_fs~ s
c C@ sR y6 d j | | � } | j j d | � } | j d SWn t j k
rM d SXd S( u-
Return name of Snapshot
or None
u source='{}' and suffix='{}'t filteri N( t formatt file_system_snapshotst list_file_system_snapshotsR& R
R' R( ( R) t suffixR t filtR+ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt
_get_snapshot� s c C@ sB y& t | | � } | r% | j r% | SWn t j k
r= d SXd S( uR
Private function to check
if a file systeem has already been deleted
N( R, t destroyedR
R' R( ( R) R R* ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt _get_deleted_fs� s c C@ s� t � } | d k re d t j t j � t d d d d d d d � j � � } | j d d � } n t | | � d k r� y: g } | j | � | j
j d | d t | � � t
SWq� t j k
r� t SXn t Sd S(
u�
Create a filesystem snapshot on a Pure Storage FlashBlade.
Will return False if filesystem selected to snap does not exist.
.. versionadded:: 2019.2.0
name : string
name of filesystem to snapshot
suffix : string
if specificed forces snapshot name suffix. If not specified defaults to timestamp.
CLI Example:
.. code-block:: bash
salt '*' purefb.snap_create foo
salt '*' purefb.snap_create foo suffix=bar
u snap-i� i i u .u t sourcesR1 N( R! R( R t text_typeR t utcnowt
total_secondst replaceR, R# R/ t create_file_system_snapshotsR t TrueR
R' R ( R) R1 R t source( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt snap_create� s )
c C@ s� t � } t | | | � d k r� y: | d | } t d t � } | j j d | d | � Wn t j k
rr t SX| t k r� y | j j
d | � t SWq� t j k
r� t SXq� t Sn t Sd S( u�
Delete a filesystem snapshot on a Pure Storage FlashBlade.
Will return False if selected snapshot does not exist.
.. versionadded:: 2019.2.0
name : string
name of filesystem
suffix : string
name of snapshot
eradicate : boolean
Eradicate snapshot after deletion if True. Default is False
CLI Example:
.. code-block:: bash
salt '*' purefb.snap_delete foo suffix=snap eradicate=True
u .R4 R) t
attributesN( R! R3 R( R R< R/ t update_file_system_snapshotsR
R' R t delete_file_system_snapshots( R) R1 t eradicateR t snapnamet new_attr( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt snap_delete� s" c C@ sm t � } t | | | � d k re | d | } y | j j d | � t SWqi t j k
ra t SXn t Sd S( uo
Eradicate a deleted filesystem snapshot on a Pure Storage FlashBlade.
Will return False if snapshot is not in a deleted state.
.. versionadded:: 2019.2.0
name : string
name of filesystem
suffix : string
name of snapshot
CLI Example:
.. code-block:: bash
salt '*' purefb.snap_eradicate foo suffix=snap
u .R) N( R! R3 R( R/ RA R< R
R' R ( R) R1 R RC ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt snap_eradicate� s u NFSu *(rw,no_root_squash)c C@ s� t | � d k r" | d d !} n t � } t | � t | | � d k r�| d k ri t d d � } n t d | � } | j � d k r� t d | d | d t d | d
t d t d | � � } n� | j � d
k r t d | d | d t d | d t
d t � � } nI | j � d k rNt d | d | d t d | d t
d t � � } n t Sy | j j
| � t SWq�t j k
r�t SXn t Sd S( u�
Create a filesystem on a Pure Storage FlashBlade.
Will return False if filesystem already exists.
.. versionadded:: 2019.2.0
name : string
name of filesystem (truncated to 63 characters)
proto : string
(Optional) Sharing protocol (NFS, CIFS or HTTP). If not specified default is NFS
snapshot: boolean
(Optional) Are snapshots enabled on the filesystem. Default is False
nfs_rules : string
(Optional) export rules for NFS. If not specified default is
``*(rw,no_root_squash)``. Refer to Pure Storage documentation for
formatting rules.
size : string
if specified capacity of filesystem. If not specified default to 32G.
Refer to Pure Storage documentation for formatting rules.
CLI Example:
.. code-block:: bash
salt '*' purefb.fs_create foo proto=CIFS
salt '*' purefb.fs_create foo size=10T
i? i u stringutils.human_to_bytesu 32Gu nfsR) t provisionedt fast_remove_directory_enabledt snapshot_directory_enabledt nfst enabledt rulesu cifst smbu httpt httpN( t lenR! t printR, R( t __utils__t lowerR R< R R R R$ t create_file_systemsR
R' ( R) t sizet protot nfs_rulest snapshotR t fs_obj( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt fs_create sB
c
C@ s� t � } t | | � d k r� yS | j j d | d t d t d t � d t d t � d t d t � d t � � Wn t
j k
r� t SX| t k r� y | j j | � t SWq� t
j k
r� t SXq� t Sn t Sd S( u�
Delete a share on a Pure Storage FlashBlade.
Will return False if filesystem doesn't exist or is already in a deleted state.
.. versionadded:: 2019.2.0
name : string
name of filesystem
eradicate : boolean
(Optional) Eradicate filesystem after deletion if True. Default is False
CLI Example:
.. code-block:: bash
salt '*' purefb.fs_delete foo eradicate=True
R) R? RJ RK RM RN R4 N(
R! R, R( R$ t update_file_systemsR R R R R< R
R' t delete_file_systems( R) RB R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt fs_deleted s$ c C@ sY t � } t | | � d k rQ y | j j | � t SWqU t j k
rM t SXn t Sd S( u-
Eradicate a deleted filesystem on a Pure Storage FlashBlade.
Will return False is filesystem is not in a deleted state.
.. versionadded:: 2019.2.0
name : string
name of filesystem
CLI Example:
.. code-block:: bash
salt '*' purefb.fs_eradicate foo
N( R! R5 R( R$ R[ R< R
R' R ( R) R ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt fs_eradicate� s c C@ s� i } t � } t | | � } | d k r� t d | � | j k r� yA t d | � | d <t | � } | j j d | d | � t SWq� t j
k
r� t SXq� t Sn t Sd S( u�
Resize an existing filesystem on a Pure Storage FlashBlade.
Will return False if new size is less than or equal to existing size.
.. versionadded:: 2019.2.0
name : string
name of filesystem
size : string
New capacity of filesystem.
Refer to Pure Storage documentation for formatting rules.
CLI Example:
.. code-block:: bash
salt '*' purefb.fs_extend foo 10T
u stringutils.human_to_bytesu provisionedR) R? N( R! R, R( RQ RG R R$ RZ R< R
R' R ( R) RT t attrR R* t n_attr( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt fs_extend� s c C@ s� t � } i } t | | � } | d k r� yY | j j rO t d | � | d <n | | d <t | � } | j j d | d | � t SWq� t
j k
r� t SXn t Sd S( u`
Update filesystem on a Pure Storage FlashBlade.
Allows for change of NFS export rules and enabling/disabled
of snapshotting capability.
.. versionadded:: 2019.2.0
name : string
name of filesystem
rules : string
NFS export rules for filesystem
Refer to Pure Storage documentation for formatting rules.
snapshot: boolean
(Optional) Enable/Disable snapshots on the filesystem. Default is False
CLI Example:
.. code-block:: bash
salt '*' purefb.fs_nfs_update foo rules='10.234.112.23(ro), 10.234.112.24(rw)' snapshot=True
RL u nfsu snapshot_directory_enabledR) R? N(
R! R, R( RJ RK R R R$ RZ R< R
R' R ( R) RL RW R R^ R* R_ ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt fs_update� s
(' t __doc__t
__future__R R R R R t salt.extR t salt.exceptionsR t purity_fbR R R R R
R R R< R
t ImportErrorR t
__docformat__R R R! R, R3 R5 R( R> RE RF RY R\ R] R` Ra ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/purefb.pyt <module>4 s4 "
)
), !H , (
Mini Shell