Current File : //lib/python2.7/site-packages/salt/states/docker_volume.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z e j e � Z
d Z d
Z d � Z
d � Z d d e d � Z d d � Z d S( u�
Management of Docker volumes
.. versionadded:: 2017.7.0
:depends: docker_ Python module
.. note::
Older releases of the Python bindings for Docker were called docker-py_ in
PyPI. All releases of docker_, and releases of docker-py_ >= 1.6.0 are
supported. These python bindings can easily be installed using
:py:func:`pip.install <salt.modules.pip.install>`:
.. code-block:: bash
salt myminion pip.install docker
To upgrade from docker-py_ to docker_, you must first uninstall docker-py_,
and then install docker_:
.. code-block:: bash
salt myminion pip.uninstall docker-py
salt myminion pip.install docker
.. _docker: https://pypi.python.org/pypi/docker
.. _docker-py: https://pypi.python.org/pypi/docker-py
These states were moved from the :mod:`docker <salt.states.docker>` state
module (formerly called **dockerng**) in the 2017.7.0 release.
i ( t absolute_importt print_functiont unicode_literalsNu
docker_volumeu moby_volumec C@ s# d t k r t St t j d � f S( u?
Only load if the docker execution module is available
u docker.version( t __salt__t __virtualname__t Falset missing_fun_string( ( ( s= /usr/lib/python2.7/site-packages/salt/states/docker_volume.pyt __virtual__/ s c C@ sU t d � d } | rQ g | D] } | d | k r | ^ q } | rQ | d Sn d S( u'
Find volume by name on minion
u docker.volumesu Volumesu Namei N( R t None( t namet docker_volumest vt volumes( ( s= /usr/lib/python2.7/site-packages/salt/states/docker_volume.pyt _find_volume8 s ) c C@ sY i | d 6i d 6t d 6d d 6} t j j j | � rO t j j j | � } n t | � } | s� t d r� d | d <d j | � | d <| Sy( t
d | d | d
| �| d d <Wn* t k
r� } d j | | � | d <| SXt } | | d <| Sn | d k r8| d
| k r8| sUd j | | d
| � | d <t d rGd n t | d <| St d r�d | d <d j | | � | d <| Sy t
d | � | d d <Wn* t k
r�} d j | | � | d <| SXy( t
d | d | d
| �| d d <Wn* t k
r } d j | | � | d <| SXt } | | d <| Sn t | d <d j | � | d <| S( u6
Ensure that a volume is present.
.. versionadded:: 2015.8.4
.. versionchanged:: 2015.8.6
This state no longer deletes and re-creates a volume if the existing
volume's driver does not match the ``driver`` parameter (unless the
``force`` parameter is set to ``True``).
.. versionchanged:: 2017.7.0
This state was renamed from **docker.volume_present** to **docker_volume.present**
name
Name of the volume
driver
Type of driver for that volume. If ``None`` and the volume
does not yet exist, the volume will be created using Docker's
default driver. If ``None`` and the volume does exist, this
function does nothing, even if the existing volume's driver is
not the Docker default driver. (To ensure that an existing
volume's driver matches the Docker default, you must
explicitly name Docker's default driver here.)
driver_opts
Options for the volume driver
force : False
If the volume already exists but the existing volume's driver
does not match the driver specified by the ``driver``
parameter, this parameter controls whether the function errors
out (if ``False``) or deletes and re-creates the volume (if
``True``).
.. versionadded:: 2015.8.6
Usage Examples:
.. code-block:: yaml
volume_foo:
docker_volume.present
.. code-block:: yaml
volume_bar:
docker_volume.present
- name: bar
- driver: local
- driver_opts:
foo: bar
.. code-block:: yaml
volume_bar:
docker_volume.present
- name: bar
- driver: local
- driver_opts:
- foo: bar
- option: value
u nameu changesu resultu u commentu testu The volume '{0}' will be createdu docker.create_volumet drivert driver_optsu createdu" Failed to create volume '{0}': {1}u Driveruc Driver for existing volume '{0}' ('{1}') does not match specified driver ('{2}') and force is FalseuG The volume '{0}' will be replaced with a new one using the driver '{1}'u docker.remove_volumeu removedu" Failed to remove volume '{0}': {1}u Volume '{0}' already exists.N(
R t saltt utilst datat is_dictlistt repack_dictlistR
t __opts__R t formatR t Exceptiont True( R R R t forcet rett volumet exct result( ( s= /usr/lib/python2.7/site-packages/salt/states/docker_volume.pyt presentE sh @
!
!
c C@ s� i | d 6i d 6t d 6d d 6} t | � } | sU t | d <d j | � | d <| Sy& t d | � | d d <t | d <Wn) t k
r� } d j | | � | d <n X| S(
uL
Ensure that a volume is absent.
.. versionadded:: 2015.8.4
.. versionchanged:: 2017.7.0
This state was renamed from **docker.volume_absent** to **docker_volume.absent**
name
Name of the volume
Usage Examples:
.. code-block:: yaml
volume_foo:
docker_volume.absent
u nameu changesu resultu u commentu Volume '{0}' already absentu docker.remove_volumeu removedu" Failed to remove volume '{0}': {1}( R R
R R R R ( R R R R R ( ( s= /usr/lib/python2.7/site-packages/salt/states/docker_volume.pyt absent� s
( u moby_volume( t __doc__t
__future__R R R t loggingt salt.utils.dataR t getLoggert __name__t logR t __virtual_aliases__R R
R R R R ( ( ( s= /usr/lib/python2.7/site-packages/salt/states/docker_volume.pyt <module> s
~
Mini Shell