Current File : //lib/python2.7/site-packages/salt/fileserver/gitfs.pyc
�
���^c @@ s d Z d d l m Z m Z m Z d d l Z d- Z d. Z d/ Z d0 Z d d l
Z d d l m
Z
e j e � Z d Z e d � Z d � Z d � Z d d d � Z d d! � Z d d" � Z d# � Z e d$ � Z d d% � Z d& � Z d' � Z d( � Z d) � Z! d* � Z" d+ � Z# d, � Z$ d S(1 u
Git Fileserver Backend
With this backend, branches and tags in a remote git repository are exposed to
salt as different environments.
To enable, add ``gitfs`` to the :conf_master:`fileserver_backend` option in the
Master config file.
.. code-block:: yaml
fileserver_backend:
- gitfs
.. note::
``git`` also works here. Prior to the 2018.3.0 release, *only* ``git``
would work.
The Git fileserver backend supports both pygit2_ and GitPython_, to provide the
Python interface to git. If both are present, the order of preference for which
one will be chosen is the same as the order in which they were listed: pygit2,
then GitPython.
An optional master config parameter (:conf_master:`gitfs_provider`) can be used
to specify which provider should be used, in the event that compatible versions
of both pygit2_ and GitPython_ are installed.
More detailed information on how to use GitFS can be found in the :ref:`GitFS
Walkthrough <tutorial-gitfs>`.
.. note:: Minimum requirements
To use pygit2_ for GitFS requires a minimum pygit2_ version of 0.20.3.
pygit2_ 0.20.3 requires libgit2_ 0.20.0. pygit2_ and libgit2_ are developed
alongside one another, so it is recommended to keep them both at the same
major release to avoid unexpected behavior. For example, pygit2_ 0.21.x
requires libgit2_ 0.21.x, pygit2_ 0.22.x will require libgit2_ 0.22.x, etc.
To use GitPython_ for GitFS requires a minimum GitPython version of 0.3.0,
as well as the git CLI utility. Instructions for installing GitPython can
be found :ref:`here <gitfs-dependencies>`.
To clear stale refs the git CLI utility must also be installed.
.. _pygit2: https://github.com/libgit2/pygit2
.. _libgit2: https://libgit2.github.com/
.. _GitPython: https://github.com/gitpython-developers/GitPython
i ( t absolute_importt print_functiont unicode_literalsNu baseu
mountpointu rootu
ssl_verifyu saltenv_whitelistu saltenv_blacklistu
env_whitelistu
env_blacklistu refspecsu disable_saltenv_mappingu ref_typesu update_intervalu all_saltenvsu nameu saltenvu pygit2u useru passwordu pubkeyu privkeyu
passphraseu
insecure_auth( t FileserverConfigErroru gitfsc C@ s, t j j j t t d d t d t d | �S( Nu
gitfs_remotest per_remote_overridest per_remote_onlyt init_remotes( t saltt utilst gitfst GitFSt __opts__t PER_REMOTE_OVERRIDESt PER_REMOTE_ONLY( R ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyt _gitfsN s
c C@ sA t t d k r t Sy t d t � t SWn t k
r< n Xt S( uz
Only load if the desired provider module is present and gitfs is enabled
properly in the master config file.
u fileserver_backendR ( t __virtualname__R t FalseR R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyt __virtual__W s
c C@ s t d t � j � S( u&
Completely clear gitfs cache
R ( R R t clear_cache( ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR h s u updatec C@ s t � j d | d | � S( u
Clear update.lk
t remotet lock_type( R t
clear_lock( R R ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR o s c C@ s t � j d | � S( u�
Place an update.lk
``remote`` can either be a dictionary containing repo configuration
information, or a pattern. If the latter, then remotes for which the URL
matches the pattern will be locked.
R ( R t lock( R ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR v s c C@ s t � j | � d S( u1
Execute a git fetch on all of the repos
N( R t update( t remotes( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR � s c C@ s
t � j � S( uA
Returns the update intervals for each configured remote
( R t update_intervals( ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR � s c C@ s t � j d | � S( u@
Return a list of refs that can be used as environments
t ignore_cache( R t envs( R ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR � s c K@ s t � j | d | | �S( u�
Find the first file to match the path and ref, read the file out of git
and send the path to the newly cached file
t tgt_env( R t find_file( t pathR t kwargs( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR � s c C@ s t � d S( us
Initialize remotes. This is only used by the master's pre-flight checks,
and is not invoked by GitFS.
N( R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyt init� s c C@ s t � j | | � S( u?
Return a chunk from a file based on the data received
( R t
serve_file( t loadt fnd( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR! � s c C@ s t � j | | � S( uL
Return a file hash, the hash type is set in the master config file
( R t file_hash( R" R# ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR$ � s c C@ s t � j | � S( u�
Return a list of all files on the file server in a specified
environment (specified as a key within the load dict).
( R t file_list( R" ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR% � s c C@ s g S( u>
Return a list of all empty directories on the master
( ( R" ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyt file_list_emptydirs� s c C@ s t � j | � S( u8
Return a list of all directories on the master
( R t dir_list( R" ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR' � s c C@ s t � j | � S( uI
Return a dict of all symlinks based on a given path in the repo
( R t symlink_list( R" ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyR( � s ( u baseu
mountpointu rootu
ssl_verifyu saltenv_whitelistu saltenv_blacklistu
env_whitelistu
env_blacklistu refspecsu disable_saltenv_mappingu ref_typesu update_interval( u all_saltenvsu nameu saltenv( u pygit2( u useru passwordu pubkeyu privkeyu
passphraseu
insecure_auth(% t __doc__t
__future__R R R t loggingR R
t AUTH_PROVIDERSt AUTH_PARAMSt salt.utils.gitfsR t salt.exceptionsR t getLoggert __name__t logR t TrueR R R t NoneR R R R R R R R R! R$ R% R& R' R( ( ( ( s9 /usr/lib/python2.7/site-packages/salt/fileserver/gitfs.pyt <module>1 s<
Mini Shell