Current File : //lib/python2.7/site-packages/salt/states/git.pyo
�
���^c @@ s� d Z d d l 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 Z d d l
Z
d d l Z d d l
Z d d l Z d d l Z d d l m Z d d l m Z d d l m Z e j e � Z d � Z d � Z d � Z d
� Z d � Z e d � Z e d
� Z d � Z! e e" d � Z# d � Z$ e d � Z% e e d � Z& e d � Z' e d � Z( d � Z) d e e e e e* e" e" e" e" e" e" e" d e* e* e e e e e e d d e d � Z+ e" e* e e e e e e d � Z, e d e e e" e" e* e" e" e e e e e e d � Z- e e e e e e e e d � Z. e e e e e d � Z/ e e e e e e d � Z0 d � Z1 d S( u3
States to manage git repositories and git configuration
.. important::
Before using git over ssh, make sure your remote host fingerprint exists in
your ``~/.ssh/known_hosts`` file.
.. versionchanged:: 2015.8.8
This state module now requires git 1.6.5 (released 10 October 2009) or
newer.
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionError( t LooseVersion( t sixc C@ s9 d t k r t St t d d t � � } | t d � k S( u'
Only load if git is available
u git.versiont versioninfou 1.6.5( t __salt__t Falset
_LooseVersion( t git_ver( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt __virtual__% s c C@ s{ | d k r | d k s0 | d k r4 | d k r4 t S| | k oK d k n rT t S| d k rm | j | � S| | k Sd S( u�
Shorthand helper function for comparing SHA1s. If rev_type == 'sha1' then
the comparison will be done using str.startwith() to allow short SHA1s to
compare successfully.
NOTE: This means that rev2 must be the short rev.
u sha1N( t NoneR t Truet
startswith( t rev1t rev2t rev_type( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _revs_equal/ s
c C@ s | d k r | d Sd S( Ni ( R ( t sha1( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt
_short_shaB s c C@ s2 d j | � } t | � d k r. | d 7} n | S( u
Return a joined list
u . i u .( t joint len( t commentst ret( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _format_commentsF s
c C@ s | d k o | | k S( u<
Short hand for telling when a new branch is needed
N( R ( t brancht local_branch( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _need_branch_changeP s c C@ s� | d k r | | k r d S| d k rD t t d d t � � } n g } | t d � k rr | j d | g � n9 | j d � | j | d k r� | n | � | j | � | S( us
DRY helper to build list of opts for git.branch, for the purposes of
setting upstream tracking branch
u git.versionR u 1.8.0u --set-upstream-tou --set-upstreamN( R R R R t extendt append( R R t all_local_branchest desired_upstreamR
R ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _get_branch_optsW s
c
C@ s� t j d | � y, t d | d | d | d t d | �} Wn' t k
re t j d | � d } n Xt j d | � y, t d | d | d | d t d | �} Wn' t k
r� t j d
| � d } n X| | f S( u@
Return the local revision for before/after comparisons
u Checking local revision for %su git.revisiont usert passwordt ignore_retcodet output_encodingu No local revision for %su Checking local branch for %su git.current_branchu No local branch for %sN( t logt infoR R
R R ( t targetR" R# R% t local_revR ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _get_local_rev_and_branchq s.
c C@ s t j d d | j � S( ue
Strip the actual command that was run from exc.strerror to leave just the
error message
u ^Command [\'"].+[\'"] failed: u ( t ret subt strerror( t exc( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt
_strip_exc� s c C@ sk d j | � | d <| r, | d c d 7<n | rg | d c d j t d rR d n d t | � � 7<n | S( Nu Repository {0} is up-to-dateu commentuW , but with uncommitted changes. Set 'force_reset' to True to purge uncommitted changes.u
Changes {0}made: {1}u testu that would be u ( t formatt __opts__R ( R R( R t
local_changes( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _uptodate� s
c C@ s d | d <| | d <| S( Nu resultu comment( R ( R t comment( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt
_neutral_test� s
c C@ s5 t | d <| r' | d t | � 7} n | | d <| S( Nu resultu
Changes already made: u comment( R R ( R t msgR ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _fail� s
c C@ st t | d <d j | | r( d j | � n d � | d <| rp | d c d j t d r[ d n d t | � � 7<n | S( Nu resultu# Repository already exists at {0}{1}u# and is checked out to branch '{0}'u u commentu
Changes {0}made: {1}u testu that would be ( R
R0 R1 R ( R R( R R ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _already_cloned� s
"
c C@ s% d j t | � � } t | | | � S( Nu� Fetch failed. Set 'force_fetch' to True to force the fetch if the failure was due to not being able to fast-forward. Output of the fetch command follows:
{0}( R0 R/ R7 ( R R. R R6 ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt
_failed_fetch� s c C@ s d t | � } t | | | � S( Nu Failed to update submodules: ( R/ R7 ( R R. R R6 ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _failed_submodule_update� s c
C@ s! d } | d k rr | d k rB | | k ro d j | | � } qo qr | d k rr | | k rr d j | | � } qr n t | � } t | � } t | d j | r� | | k r� d j | | � n d j | � t | | � r� d j | � n d | s� d n d
| rd n d | rd n d | � | � S(
Nu u HEADu� The desired rev ({0}) differs from the name of the local branch ({1}), if the desired rev is a branch name then a forced update could possibly be avoided by setting the 'branch' argument to '{0}' instead.u� The default remote branch ({0}) differs from the local branch ({1}). This could be caused by changing the default remote branch, or if the local branch was manually changed. Rather than forcing an update, it may be advisable to set the 'branch' argument to '{0}' instead. To ensure that this state follows the '{0}' branch instead of the remote HEAD, set the 'rev' argument to '{0}'.ue Repository would be updated {0}{1}, but {2}. Set 'force_reset' to True{3} to force this update{4}.{5}u from {0} to {1}u to {0}u( (after checking out local branch '{0}')u this is not a fast-forward mergeu there are uncommitted changesu (or 'remote-changes')u and discard these changes( R R0 R R7 R (
R t revt pret postR R t default_branchR2 R t
branch_msg( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _not_fast_forward� s0 $ u HEADu originu *c Y @ K@ s-& i | d 6t d 6d d 6i d 6} t j j j | � } | rb t | t j j j | d t �� Sn | ry t | d � Sn | r� t | d � Sn | r� t | d j | � � Sn |
t t d
f k r� t | d � Sn t | t
j � r� t
j | � } n | t
k rZt | t
j � r+t
j | � } n t j j | � rWt | d j | � � Sn n | t
k ovt | t
j � r�t
j | � } n | t
k o�t | t
j � r�t
j | � } n | t
k o�t | t
j � r�t
j | � } n | t
k o t | t
j � r t
j | � } n | t
k r/t | t
j � rH| g } n t | t � rht | d
� Sn g | D] } t j j | � ^ qo} x� | D]� } d | k r�y t d | t � } Wn9 t k
r�} t j d | � t | d j | � � Sn Xn t j j | � r(t | d j | � � Sn q�Wn | t
k oKt | t
j � r`t
j | � } n | t
k o|t | t
j � r�t
j | � } n t t d d i t d 6t d 6� � } | r�i | d 6n i } t j j | � r�t | d j | � � Sn y% t j j j | | | d t �}! Wn& t k
rI} t | | j � � Sn Xt j j j |! � }" |
rnt } n | d k o}| r�t | d � Sn i | d 6| d 6}# d t k r�t d |# d <n t |# | | � }$ t |$ t! � r�| j" |$ � | Sn | r d j | | � d j | � g n g }% t j# d! | � yP t d" | d# t d$ t d% | d& | d' | d( | d) | d* t d+ t d, | �
}& Wnb t$ k
r�} t | d- j t% | � � � Sn4 t& k
r�} d. | j' k r�t$ d/ � � n � n Xd |& k r\|& d }' xX t
j( |& � D]A \ }( }) |( j) d0 � rO|) |' k rL|( j* d0 � d1 }* Pn n qWt
}* n t
}' t
}* t }+ | r�t
}, t
}- n�| d k r�|' t
k r�|' }, t
}+ d2 }- n t
}, t
}- n� d0 | |& k r�|& d0 | }, d3 j+ | | f � }+ d4 }- n� d5 | d6 |& k r*|& d5 | d6 }, d7 }- nv d5 | |& k rQ|& d5 | }, d7 }- nO t, | � d8 k ovt- d9 � | D� � r�| j. � } | }, d2 }- n t
}, t
}- |- d2 k r�| d k r�d: |, d; d< }. n
|, d; }. nf |, t
k rd= j |- d4 k r�|+ n | |, d; � }. n/ t j/ d> | |, |- |+ | r3d? n d � t
}. | t
k o[|- d4 d7 f k rnt | d@ � Sn |, t
k o~| r�| d k r�t | dA j | � � Sn n t0 t dB dC t � � }/ | r�dD n dE }0 t j j+ | |0 � }1 g }2 t j j1 |1 � p t dF | d% | d& | d, | �r y�t dG | d% | d& | d, | �}3 t2 t dH | d% | d& | d, | �� }4 t3 | | | | � \ }5 }6 | o� |, t
k o� |5 t
k r� t | dI � Sn |5 }7 |6 }8 t4 | |6 � r^
| |3 k r� |, }7 nq | }8 y3 t dJ | | dK d% | d& | d* t d, | �}7 Wn5 t$ k
rZ
} t | dL j | t% | � � |2 � Sn Xn t dM | d% | d& | dN t d, | �}9 t5 |5 |, |- � }: y6 t | o�
t dO | d d% | d& | d, | �� }; Wn' t$ k
r�
t j/ dP | � t }; n X|; o |: r� |
t k r| dQ j | � }< t6 dR r` t | d dS <|2 rP |< t7 |2 � 7}< n t8 | |< � Sn t j9 |< j: dT dU � � n, t j9 dV | |
� t; | | t7 |2 � |; � Sn |- d2 k o� |7 t
k o� |7 j) |, � r� t }= n�t }= |, t
k rr
y1 t dJ | |, dK d% | d& | d* t d, | �Wn t$ k
r1 n>X|- d4 k r� | |9 k r� y/ t dJ | |+ d% | d& | d* t d, | �}> Wn t$ k
r� n X|> |, k r� t }= n n n� |- d7 k rZ
| |4 k rW
y3 t dJ | | dK d% | d& | d* t d, | �}? Wn t$ k
r
t
}? n X|? |, k r"
t }= n2 |
rT
t | dW j | t< |, � t< |? � � � Sn n n |- d2 k ro
t }= n n |; o�
|
d
k r�
t n t
}@ |= rV|: o�
| o�
| t
k p�
| |6 k r�
dX j | d k r�
|. j= � n |. |5 d; � | d <| Sn |@ t k rS|7 t
k rt }@ n: t dY | dZ |7 |, g d[ t d% | d& | d* t d, | �}@ n n |@ t k r�|
t k r�t> | | |7 |, | |6 |* |; |2 � Sn d\ }A n |@ t k r�d] }A n d^ }A |8 t
k r�t
}B nV y< t dJ | |8 d_ d` da g d% | d& | d* t d, | �}B Wn t$ k
r!t }B n X| |9 k r?|9 | db }C n t j9 dc | | � t
}C |, t
k om|! |C k r%t6 dR r�dd j | t j j j |C � |" � g }D |= r�|D j? de � n |: r#| r i |5 df 6|, dg 6| d dh <|@ t k r�t | d dS <n |D j? di j |A t< |, � � � n n | d rCt8 | t7 |D � � Sn; |: oN| rht7 |D � | d <| Sn t; | | t7 |D � � Sn t dj | dk | dl | d% | d& | d( | d) | d, | �|C t
k r�|2 j? dm j | |" � � | dn | | d dg <n+ |2 j? do j | t j j j |C � |" � � n |, t
k r�t6 dR r�g }D |= ra|D j? dp j | � � n |: o�| p�| t
k o�| |6 k r�i |5 df 6|, dg 6| d dh <n t4 | |6 � r | |3 k r�|D j? dq j | |. � � |+ r�|D j? dr j |+ � � n n" |D j? ds j | |A t< |, � � � n� |: r�| r�|@ t k ra|D j? dt j t< |5 � t< |, � � � n: |D j? du j |
ov|= rd\ n d^ t< |5 � t< |, � � � n |D j? dv j |5 d; |. � � n |B o�|+ r�|D j? dr j |+ � � nM |B o�|+ t k r|D j? dw � n+ |+ o|B |+ k r1|D j? dx j |+ � � n | d rQt8 | t7 |D � � SnG t7 |D � }E |: on| on|E r�|E | d <| Sn t; | | t7 |D � � Sn |B o�|+ r�dy j |+ � }F t@ | |6 |3 |+ |/ � }G n� |B o�|+ t k r|/ t0 dz � k rd{ }F d| g }G n t
}G nB |+ o |B |+ k rMd} j |+ � }F t@ | |6 |3 |+ |/ � }G n t
}G |G t
k oh|6 t
k r~t | d~ |2 � Sn t2 g t d d� | dl | d` d� d% | d& | d' | d+ t d* t d, | � D]$ } d6 | k r�| j: d5 d � ^ q�� }H |4 |H k r5t }= |H |4 }I |4 |H }J |I r/|I | d d� <n | o8|J r2x� |J D]� }K y; t6 dR r�t d� | |K d` d� d% | d& | d, | �n Wn8 t$ k
r�} | jA d� g � j? d� j |K | � � n X| d jA d� g � j? |K � qBW| d jB d� � r/|2 j? d� j t6 dR rd� n d� d� j+ | d d� � � � n n n |= r?yD t d� | dl | d� | d� |% d% | d& | d' | d+ t d, | �}L Wn# t$ k
r�} tC | | |2 � Sn X|L r�|2 j? d� j | � � n y1 t dJ | |, dK d% | d& | d* t d, | �Wn/ t$ k
r'} t | d� j | | | � � Sn X|: o3| oK| t
k pK| |6 k r�| d k rf|. j= � n |. | d <| d c d� j |5 d; � 7<| Sn |7 t
k r�t }@ n4 t dY | dZ |7 |, g d[ t d% | d& | d, | �}@ |@ |
k o�t k n p|@ t k o|; o|
t k r<t> | | |7 |, | |6 |* |; |2 � Sn n t4 | |6 � r2|; oX| rtt | d� j |6 � � Sn | |3 k r�| d k r�|, }M n |+ r�|+ n | }M d� | g }N n | }M g }N t d� | |M d� | d` |N d% | d& | d, | �d� |N k r|2 j? d� j | |. � � n |2 j? d� j |M � � n |@ t k r�t d� | d` d� |, g d% | d& | d, | | �t | d dS <|; r�|2 j? d� � n |2 j? d� j |. � � nN |@ t k o�|; o�|
t k r�t d� | d% | d& | d, | �|2 j? d� � n |G t
k r:t d� | d` |G d% | d& | d, | �|2 j? |F � n |@ t k oVt5 |7 |, |- � rx|+ ph| d k r t d� | d d` d� g d% | d& | d* t d, | �r |/ t0 d� � k r�d� g }O n g }O t d� | d� |, d` |O d% | d& | d, | | �|2 j? d� j |. � � n t | d� |2 � SnW t d� | d` d� | d k r@|, n | g d% | d& | d, | | �|2 j? d� j | � � n | r�y? t d� | d� d` d� d� g d% | d& | d' | d+ t d, | �Wn# t$ k
r�} tD | | |2 � Sn Xn n� | r� t6 dR r5 d� j | � }< | d r" t8 | |< � Sn t; | | |< � Sn yD t d� | dl | d� | d� |% d% | d& | d' | d+ t d, | �}L Wn# t$ k
r� } tC | | |2 � Sn& X|2 j? d� j | |L r� d� n d � � n y/ t d� d� | d% | d& | d* t d, | � }P Wn t$ k
r t
}P n XWnc tE k
rv } t jF d� d� t �t | t$ � rT t% | � }< n t
j | � }< t | |< |2 � Sn X| o� t5 |P |, |- � r� t | d� |2 � Sn |5 |P k r� t j# d� | |5 |P � t7 |2 � | d <i |5 df 6|P dg 6| d dh <n t; | | t7 |2 � � Snt j j1 | � r� t jG | � }Q | rz t6 dR r t | d d� <| dn | | d dg <t8 | d� j | | � � Sn t j9 d� | | � i }R xo |Q D]g }S t j j+ | |S � }T y t j jH jI |T � Wn2 tJ k
r } | jK tK jL k r | |R |T <n n Xq� W|R ri g t
j( |R � D] \ }U }V d� j |U |V � ^ q }W t | d� j d� j+ |W � � |2 � Sn t | d d� <n |Q r� t | d� j | � � Sn n t j9 d� | � t6 dR r� | dn | | d dg <t8 | d� j | | � � Sn y�|
r� d� g n | r d� g n g }X | d� k r1 |X jM d� | g � n | t
k rb |X jM d� t
j | � d� | g � n t
}6 }5 yE t d� | | d% | d& | d` |X d' | d( | d) | d+ t d, | �Wn8 t$ k
r� } d� j t% | � � }< t | |< |2 � Sn X| dn | | d dg <|2 j? d� j | | |
r !d� n | r,!d� n d � � | r�$|, r�!| d k r�!d� j | | � }< t jF |< | � t | |< d� |2 � Sn n.|- d7 k o�!| t dH | d% | d& | d, | �k r�!t | d� j | � |2 � Sn | t
k r�"| t dG | d% | d& | d, | �k r�"| d k r%"|, }M n |+ r1"|+ n | }M t d� | |M d` d� | g d% | d& | d, | �|2 j? d� j | |. � � n n t3 | | | d, | �\ }5 }6 |6 t
k o�"|, t
k o�"d |& k r�"t | d� |2 � Sn t5 |5 |, |- � r2#t d� | d` d� |, g d% | d& | d, | �|2 j? d� j |. � � n y< t dJ | |6 d_ d` da g d% | d& | d* t d, | �}B Wn t$ k
r�#t }B n X|B o�#|+ r�#dy j |+ � }F t@ | |6 t dG | d% | d& | d, | �|+ |/ � }G n� |B o�#|+ t k r$|/ t0 dz � k r$d{ }F d| g }G n t
}G n^ |+ o)$|B |+ k rr$d} j |+ � }F t@ | |6 t dG | d% | d& | d, | �|+ |/ � }G n t
}G |G t
k r�$t d� | d` |G d% | d& | d, | �|2 j? |F � n n | o�$|, r+%y9 t d� | d� d` d� d� g d% | d& | d' | d, | �Wn# t$ k
r'%} tD | | |2 � Sn Xn y/ t d� d� | d% | d& | d* t d, | � }P Wn t$ k
rs%t
}P n XWnc tE k
r�%} t jF d� d� t �t | t$ � r�%t% | � }< n t
j | � }< t | |< |2 � Sn Xt7 |2 � }< t j# |< � |< | d <|P t
k r)&i t
df 6|P dg 6| d dh <n | S(� u�2
Make sure the repository is cloned to the given directory and is
up-to-date.
name
Address of the remote repository, as passed to ``git clone``
.. note::
From the `Git documentation`_, there are two URL formats
supported for SSH authentication. The below two examples are
equivalent:
.. code-block:: text
# ssh:// URL
ssh://user@server/project.git
# SCP-like syntax
user@server:project.git
A common mistake is to use an ``ssh://`` URL, but with a colon
after the domain instead of a slash. This is invalid syntax in
Git, and will therefore not work in Salt. When in doubt, confirm
that a ``git clone`` works for the URL before using it in Salt.
It has been reported by some users that SCP-like syntax is
incompatible with git repos hosted on `Atlassian Stash/BitBucket
Server`_. In these cases, it may be necessary to use ``ssh://``
URLs for SSH authentication.
.. _`Git documentation`: https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols#The-SSH-Protocol
.. _`Atlassian Stash/BitBucket Server`: https://www.atlassian.com/software/bitbucket/server
rev : HEAD
The remote branch, tag, or revision ID to checkout after clone / before
update. If specified, then Salt will also ensure that the tracking
branch is set to ``<remote>/<rev>``, unless ``rev`` refers to a tag or
SHA1, in which case Salt will ensure that the tracking branch is unset.
If ``rev`` is not specified, it will be assumed to be ``HEAD``, and
Salt will not manage the tracking branch at all.
.. versionchanged:: 2015.8.0
If not specified, ``rev`` now defaults to the remote repository's
HEAD.
target
Name of the target directory where repository is about to be cloned
branch
Name of the local branch into which to checkout the specified rev. If
not specified, then Salt will not care what branch is being used
locally and will just use whatever branch is currently there.
.. versionadded:: 2015.8.0
.. note::
If this argument is not specified, this means that Salt will not
change the local branch if the repository is reset to another
branch/tag/SHA1. For example, assume that the following state was
run initially:
.. code-block:: yaml
foo_app:
git.latest:
- name: https://mydomain.tld/apps/foo.git
- target: /var/www/foo
- user: www
This would have cloned the HEAD of that repo (since a ``rev``
wasn't specified), and because ``branch`` is not specified, the
branch in the local clone at ``/var/www/foo`` would be whatever the
default branch is on the remote repository (usually ``master``, but
not always). Now, assume that it becomes necessary to switch this
checkout to the ``dev`` branch. This would require ``rev`` to be
set, and probably would also require ``force_reset`` to be enabled:
.. code-block:: yaml
foo_app:
git.latest:
- name: https://mydomain.tld/apps/foo.git
- target: /var/www/foo
- user: www
- rev: dev
- force_reset: True
The result of this state would be to perform a hard-reset to
``origin/dev``. Since ``branch`` was not specified though, while
``/var/www/foo`` would reflect the contents of the remote repo's
``dev`` branch, the local branch would still remain whatever it was
when it was cloned. To make the local branch match the remote one,
set ``branch`` as well, like so:
.. code-block:: yaml
foo_app:
git.latest:
- name: https://mydomain.tld/apps/foo.git
- target: /var/www/foo
- user: www
- rev: dev
- branch: dev
- force_reset: True
This may seem redundant, but Salt tries to support a wide variety
of use cases, and doing it this way allows for the use case where
the local branch doesn't need to be strictly managed.
user
Local system user under which to run git commands. By default, commands
are run by the user under which the minion is running.
.. note::
This is not to be confused with the username for http(s)/SSH
authentication.
.. versionadded:: 0.17.0
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
update_head : True
If set to ``False``, then the remote repository will be fetched (if
necessary) to ensure that the commit to which ``rev`` points exists in
the local checkout, but no changes will be made to the local HEAD.
.. versionadded:: 2015.8.3
force_checkout : False
When checking out the local branch, the state will fail if there are
unwritten changes. Set this argument to ``True`` to discard unwritten
changes when checking out.
force_clone : False
If the ``target`` directory exists and is not a git repository, then
this state will fail. Set this argument to ``True`` to remove the
contents of the target directory and clone the repo into it.
force_fetch : False
If a fetch needs to be performed, non-fast-forward fetches will cause
this state to fail. Set this argument to ``True`` to force the fetch
even if it is a non-fast-forward update.
.. versionadded:: 2015.8.0
force_reset : False
If the update is not a fast-forward, this state will fail. Set this
argument to ``True`` to force a hard-reset to the remote revision in
these cases.
.. versionchanged:: 2019.2.0
This option can now be set to ``remote-changes``, which will
instruct Salt not to discard local changes if the repo is
up-to-date with the remote repository.
submodules : False
Update submodules on clone or branch change
bare : False
Set to ``True`` if the repository is to be a bare clone of the remote
repository.
.. note:
Setting this option to ``True`` is incompatible with the ``rev``
argument.
mirror
Set to ``True`` if the repository is to be a mirror of the remote
repository. This implies that ``bare`` set to ``True``, and thus is
incompatible with ``rev``.
remote : origin
Git remote to use. If this state needs to clone the repo, it will clone
it using this value as the initial remote name. If the repository
already exists, and a remote by this name is not present, one will be
added.
fetch_tags : True
If ``True``, then when a fetch is performed all tags will be fetched,
even those which are not reachable by any branch on the remote.
sync_tags : True
If ``True``, then Salt will delete tags which exist in the local clone
but are not found on the remote repository.
.. versionadded:: 2018.3.4
depth
Defines depth in history when git a clone is needed in order to ensure
latest. E.g. ``depth: 1`` is useful when deploying from a repository
with a long history. Use rev to specify branch or tag. This is not
compatible with revision IDs.
.. versionchanged:: 2019.2.0
This option now supports tags as well as branches, on Git 1.8.0 and
newer.
identity
Path to a private key to use for ssh URLs. This can be either a single
string, or a list of strings. For example:
.. code-block:: yaml
# Single key
git@github.com:user/repo.git:
git.latest:
- user: deployer
- identity: /home/deployer/.ssh/id_rsa
# Two keys
git@github.com:user/repo.git:
git.latest:
- user: deployer
- identity:
- /home/deployer/.ssh/id_rsa
- /home/deployer/.ssh/id_rsa_alternate
If multiple keys are specified, they will be tried one-by-one in order
for each git command which needs to authenticate.
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE%20FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
.. versionchanged:: 2016.3.0
Key can now be specified as a SaltStack fileserver URL (e.g.
``salt://path/to/identity_file``).
https_user
HTTP Basic Auth username for HTTPS (only) clones
.. versionadded:: 2015.5.0
https_pass
HTTP Basic Auth password for HTTPS (only) clones
.. versionadded:: 2015.5.0
onlyif
A command to run as a check, run the named command only if the command
passed to the ``onlyif`` option returns true
unless
A command to run as a check, only run the named command if the command
passed to the ``unless`` option returns false
refspec_branch : *
A glob expression defining which branches to retrieve when fetching.
See `git-fetch(1)`_ for more information on how refspecs work.
.. versionadded:: 2017.7.0
refspec_tag : *
A glob expression defining which tags to retrieve when fetching. See
`git-fetch(1)`_ for more information on how refspecs work.
.. versionadded:: 2017.7.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-fetch(1)`: http://git-scm.com/docs/git-fetch
.. note::
Clashing ID declarations can be avoided when including different
branches from the same git repository in the same SLS file by using the
``name`` argument. The example below checks out the ``gh-pages`` and
``gh-pages-prod`` branches from the same repository into separate
directories. The example also sets up the ``ssh_known_hosts`` ssh key
required to perform the git checkout.
Also, it has been reported that the SCP-like syntax for
.. code-block:: yaml
gitlab.example.com:
ssh_known_hosts:
- present
- user: root
- enc: ecdsa
- fingerprint: 4e:94:b0:54:c1:5b:29:a2:70:0e:e1:a3:51:ee:ee:e3
git-website-staging:
git.latest:
- name: git@gitlab.example.com:user/website.git
- rev: gh-pages
- target: /usr/share/nginx/staging
- identity: /root/.ssh/website_id_rsa
- require:
- pkg: git
- ssh_known_hosts: gitlab.example.com
git-website-staging:
git.latest:
- name: git@gitlab.example.com:user/website.git
- rev: gh-pages
- target: /usr/share/nginx/staging
- identity: salt://website/id_rsa
- require:
- pkg: git
- ssh_known_hosts: gitlab.example.com
git-website-prod:
git.latest:
- name: git@gitlab.example.com:user/website.git
- rev: gh-pages-prod
- target: /usr/share/nginx/prod
- identity: /root/.ssh/website_id_rsa
- require:
- pkg: git
- ssh_known_hosts: gitlab.example.com
u nameu resultu u commentu changest raise_excu 'remote' argument is requiredu 'target' argument is requiredu1 '{0}' is not a valid value for the 'rev' argumentu remote-changesu= 'force_reset' must be one of True, False, or 'remote-changes'u$ target '{0}' is not an absolute pathu* identity must be either a list or a stringu salt://u
cp.cache_fileu Failed to cache %su identity '{0}' does not exist.u& identity '{0}' is not an absolute pathu git.config_get_regexpu
filter\.lfs\.u globalu ignore_retcodeu identityu9 Target '{0}' exists and is a regular file, cannot proceedt
https_onlyu HEADu> 'rev' is not compatible with the 'mirror' and 'bare' argumentsu runasu passwordu shellu# refs/heads/{0}:refs/remotes/{1}/{0}u +refs/tags/{0}:refs/tags/{0}u Checking remote revision for %su git.remote_refst headst tagsR" R# t identityt
https_usert
https_passR$ t saltenvR% u Failed to check remote refs: {0}u global nameuH Failed to check remote refs: You may need to install GitPython or PyGit2u refs/heads/i����u sha1u /u branchu
refs/tags/u ^{}u tagi( c s@ s | ] } | t j k Vq d S( N( t stringt hexdigits( t .0t x( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pys <genexpr>= s u
remote HEAD (i u )u {0} ({1})u} Unable to determine remote_loc. rev is %s, remote_rev is %s, remove_rev_type is %s, desired_upstream is %s, and bare is%s setu notu_ When 'depth' is used, 'rev' must be set to the name of a branch or tag on the remote repositoryu: No revision matching '{0}' exists in the remote repositoryu git.versionR u refsu .gitu git.is_worktreeu git.list_branchesu
git.list_tagsuQ Remote repository is empty, cannot update from a non-empty to an empty repositoryu
git.rev_parseu ^{commit}u1 Unable to get position of local branch '{0}': {1}u git.remotest redact_authu git.diffu7 git.latest: Unable to determine if %s has local changesu� {0} is up-to-date, but with uncommitted changes. Since 'force_reset' is set to True, these local changes would be reset. To only reset when there are changes in the remote repository, set 'force_reset' to 'remote-changes'.u testu
forced updateu wouldu willug %s up-to-date, but with uncommitted changes. Since 'force_reset' is set to %s, no changes will be made.u� '{0}' is a tag, but the remote SHA1 for this tag ({1}) doesn't match the local SHA1 ({2}). Set 'force_reset' to True to force this update.uu {0} is already present and local HEAD ({1}) does not match, but update_head=False. HEAD has not been updated locally.u git.merge_baset refst is_ancestoru
hard-resetu fast-forwardedu updatedu @{upstream}t optsu --abbrev-refu fetchu+ Remote '%s' not found in git checkout at %su- Remote '{0}' would be changed from {1} to {2}u Remote would be fetchedu oldu newu revisionu Repository would be {0} to {1}u git.remote_sett urlt remoteu Remote '{0}' set to {1}u => u$ Remote '{0}' changed from {1} to {2}u Remote '{0}' would be fetcheduC New branch '{0}' would be checked out, with {1} as a starting pointu# Tracking branch would be set to {0}u0 Branch '{0}' would be checked out and {1} to {2}u2 Repository would be fast-forwarded from {0} to {1}u' Repository would be {0} from {1} to {2}u\ Local HEAD ({0}) does not match {1} but update_head=False, HEAD would not be updated locallyu Tracking branch would be unsetu' Tracking branch would be updated to {0}u Tracking branch was set to {0}u 1.8.0u Tracking branch was unsetu --unset-upstreamu" Tracking branch was updated to {0}u~ Cannot set/unset upstream tracking branch, local HEAD refers to nonexistent branch. This may have been caused by cloning a remote repository for which the default branch was renamed or deleted. If you are unable to fix the remote repository, you can work around this by setting the 'branch' argument (which will ensure that the named branch is created if it does not already exist).u
git.ls_remotet cwdu --tagsu new_tagsu git.tagu -du warningsu( Failed to remove local tag '{0}':
{1}
u deleted_tagsu; The following tags {0} removed from the local checkout: {1}u would beu wereu , u git.fetcht forcet refspecsu* {0} was fetched, resulting in updated refsu; Fetch did not successfully retrieve rev '{0}' from {1}: {2}ur is already present and local HEAD ({0}) does not match, but update_head=False. HEAD has not been updated locally.ue Local branch '{0}' has uncommitted changes. Set 'force_checkout' to True to discard them and proceed.u -bu git.checkoutu> New branch '{0}' was checked out, with {1} as a starting pointu '{0}' was checked outu git.resetu --hardu" Uncommitted changes were discardedu Repository was hard-reset to {0}u git.discard_local_changesu
git.branchu git.symbolic_refu --quietu 1.8.1.6u --ff-onlyu git.mergeR; u$ Repository was fast-forwarded to {0}u( Unable to fast-forward, HEAD is detachedu* Repository was reset to {0} (fast-forward)u
git.submoduleu updateu --initu --recursiveu' Bare repository at {0} would be fetchedu% Bare repository at {0} was fetched{1}u , resulting in updated refsu git.revisionu( Unexpected exception in git.latest statet exc_infou Failed to update repositoryu Repository %s updated: %s => %su forced cloneu� Target directory {0} exists. Since force_clone=True, the contents of {0} would be deleted, and {1} would be cloned into this directory.uf Removing contents of %s to clone repository %s in its place (force_clone=True set in git.latest state)u
{0}
{1}u Unable to remove
{0}u
u� Target '{0}' exists, is non-empty and is not a git repository. Set the 'force_clone' option to True to remove this directory's contents and proceed with cloning the remote repositoryu/ Target %s is not found, 'git clone' is requiredu% Repository {0} would be cloned to {1}u --mirroru --bareu originu --originu --depthu --branchu git.cloneu Clone failed: {0}u {0} cloned to {1}{2}u
as mirroru as bare repositoryu< %s was cloned but is empty, so {0}/{1} cannot be checked outu
Repositoryu& Revision '{0}' does not exist in cloneu6 Branch '{0}' checked out, with {1} as a starting pointuE Remote HEAD refers to a ref that does not exist. This can happen when the default branch on the remote repository is renamed or deleted. If you are unable to fix the remote repository, you can work around this by setting the 'branch' argument (which will ensure that the named branch is created if it does not already exist).u Repository was reset to {0}(N R
t saltt utilst argst clean_kwargsR7 t invalid_kwargsR R0 t
isinstanceR t string_typest text_typeR t ost patht isabst listt
expanduserR t __env__t IOErrorR& t exceptiont boolt isfileRQ t add_http_basic_autht
ValueErrort __str__t redact_http_basic_autht
__grains__t
mod_run_checkt dictt updateR' R R/ t NameErrort messaget iteritemsR t partitionR R t allt lowert warningR t isdirt setR* R R R1 R R5 t debugt replaceR3 R t
capitalizeR@ R R! t
setdefaultt getR9 R: t Exceptiont errort listdirt filest rm_rft OSErrort errnot ENOENTR (Y t nameR; R( R R" R# t update_headt force_checkoutt force_clonet force_fetcht force_resett
submodulest baret mirrorRR t
fetch_tagst sync_tagst depthRE RF RG t onlyift unlesst refspec_brancht refspec_tagR% t kwargsR RL t
ident_pathR. t use_lfst lfs_optst desired_fetch_urlt redacted_fetch_urlt run_check_cmd_kwargst cretRU t all_remote_refst head_revt refnamet refshaR> R t
remote_revt remote_rev_typet
remote_locR
t checkt gitdirR R t all_local_tagsR) R t base_revt base_brancht remotest
revs_matchR2 R6 t has_remote_revt
local_copyt local_tag_sha1t fast_forwardt merge_actiont upstreamt fetch_urlt actionst formatted_actionst upstream_actiont branch_optst remote_tagst new_tagst deleted_tagst tag_namet
fetch_changest checkout_revt
checkout_optst
merge_optst new_revt target_contentst removal_errorst
target_objectt target_patht kt vt err_stringst
clone_opts( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt latest
s� � n"
%
-
4
$
1
$ %
c
C@ s� i | d 6t d 6d d 6i d 6} t j j | � r�| r_ t j j t j j | d � � r_ | S| r� t j j t j j | d � � s� t d | d | d
| d | �r� | S| r�t d r� | | d d
<t | d d <t | d j | | r� d n d � � St
j d | | rd n d � y9 t j j | � rBt j
| � n t j j j | � Wn) t k
r�}
t | d j | |
� � SXt | d d <q�t j | � r�t | d j | � � Sn t d r�| | d d
<t | d j | r�d n d � � St d d | d | d | d | d | d | d
| d | � d j | rBd n d | � g } | rp| j d j | � � n | r�| j d j | � � n d j | � } t | � d k r�| d 7} n t
j | � | | d d
<| | d <| S(! uU
Ensure that a repository exists in the given directory
.. warning::
If the minion has Git 2.5 or later installed, ``name`` points to a
worktree_, and ``force`` is set to ``True``, then the worktree will be
deleted. This has been corrected in Salt 2015.8.0.
name
Path to the directory
.. versionchanged:: 2015.8.0
This path must now be absolute
force : False
If ``True``, and if ``name`` points to an existing directory which does
not contain a git repository, then the contents of that directory will
be recursively removed and a new repository will be initialized in its
place.
bare : True
If ``True``, and a repository must be initialized, then the repository
will be a bare repository.
.. note::
This differs from the default behavior of :py:func:`git.init
<salt.modules.git.init>`, make sure to set this value to ``False``
if a bare repo is not desired.
template
If a new repository is initialized, this argument will specify an
alternate template directory.
.. versionadded:: 2015.8.0
separate_git_dir
If a new repository is initialized, this argument will specify an
alternate ``$GIT_DIR``
.. versionadded:: 2015.8.0
shared
Set sharing permissions on git repo. See `git-init(1)`_ for more
details.
.. versionadded:: 2015.5.0
user
User under which to run git commands. By default, commands are run by
the user under which the minion is running.
.. versionadded:: 0.17.0
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-init(1)`: http://git-scm.com/docs/git-init
.. _`worktree`: http://git-scm.com/docs/git-worktree
u nameu resultu u commentu changesu HEADu .gitu git.is_worktreeR" R# R% u testu newu forced initu� Target directory {0} exists. Since force=True, the contents of {0} would be deleted, and a {1}repository would be initialized in its place.u bare ue Removing contents of %s to initialize %srepository in its place (force=True set in git.present state)u Unable to remove {0}: {1}u� Target '{0}' exists, is non-empty, and is not a git repository. Set the 'force' option to True to remove this directory's contents and proceed with initializing a repositoryu" New {0}repository would be createdu git.initRS R� t templatet separate_git_dirt sharedu Initialized {0}repository in {1}u Template directory set to {0}u Gitdir set to {0}u . i u .( R
R_ R` Rx Rh R R R1 R5 R0 R& Rz t islinkt unlinkRW RX R� R� R� R7 R� R R R' (
R� RT R� R� R� R� R" R# R% R R. R� Rr ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt present s� S"'!
c / K@ sK i | d 6t d 6d d 6i d 6} t j j j | � } | r_ t | t j j j | d t �� S| s{ t | d j | � � S| s� t | d j | � � St | t
j � s� t
j | � } n | d_ k rt | t
j � s� t
j | � } n t j j | � st | d j | � � Sn | d_ k rGt | t
j � rGt
j | � } n | d_ k rxt | t
j � rxt
j | � } n | d_ k r~t | t
j � r�| g } n t | t � s�t | d
� Sg | D] } t j j | � ^ q�} x� | D]� } d | k rOy t d | � } WqOt k
rK} t j d
| | � t | d j | � � SXn t j j | � s�t | d j | � � Sq�Wn | d_ k r�t | t
j � r�t
j | � } n |
d_ k r�t |
t
j � r�t
j |
� }
n t j j | � rt | d j | � � Sy% t j j j | | |
d t �} Wn# t k
rR} t | | j � � SXt j j j | � } i | d 6} d t k r�t d | d <n t | | | � } t | t � r�| j | � | Sd } t! | � d k rt" d � | D� � r| j# � } d } n g } t } d_ } t j j$ | d � } t j j% | � sbt d | d | d | d | �r�t& | | | d | �d } | d k r�y- t d | | d | d | d t d | �Wn t' k
r�t } q�Xt } qBt d | d | d | d! t d | �} | | k r%| | | d" k r%qBd_ } | | k rH| | d" } n t( d# rkt) | d$ j | | � � St d% | d& | d' | d | d | d( | d) |
d | �| j* d* j | | | � � n�t j j% | � r#t j+ | � }! | rt( d# r t) | d+ j | | � � St j, d, | | � i }" xo |! D]g }# t j j$ | |# � }$ y t j j- j. |$ � Wq,t/ k
r�} | j0 t0 j1 k r�| |" |$ <q�q,Xq,W|" r�g t
j2 |" � D] \ }% }& d- j |% |& � ^ q�}' t | d. j d/ j$ |' � � | � St | d d0 <q#|! r#t | d1 j | � � Sn t j, d2 | � t( d# rVt) | d3 j | | � � Sy� d4 g }( | d5 k r�|( j3 d6 | g � n t d7 | | d | d | d8 |( d9 | d( | d) |
d: t4 d | �| j* d; j | | � � Wn` t5 k
rA} t j d< d= t �t | t' � r"t6 | � }) n t
j | � }) t | |) | � SXd> j | � d? g }* | s/ | t k rln� t( d# r�t) | d@ j | � � SyD t dA | d' | dB t dC |* d | d | d9 | d: t4 d | �}+ Wn= t' k
r } dD }) |) dE t
j | � 7}) t | |) | � SX|+ r/ | j* dF j | � � n d }, | d k r� t d | | d | d | d | �ro | }, q`
t | dG j | � � Sn� y� t dH | d | d | d9 | d( | d) |
d t d | �}- dI | dJ | |- k r� |- dI | dJ | }, n7 dK | |- k r
|- dK | }, n t | dG j | � � SWn/ t' k
r_
} t | dL j | t6 | � � � SX| r�
t( d# r�
t) | dM j | � � St dN | d8 dO dP g d | d | d | �| j* dQ � n |, | k r�
d_ }. n� t( d# r i | dR 6|, dS 6| d dP <t) | dT j |, | � � St dU | |, dB | d | d | d | �| j* dV j |, | � � y/ t dW dX | d | d | d t d | � }. Wn t' k
r� d_ }. n X|
r� t dY | dZ d8 d[ d\ g d | d | d9 | d | �| j* d] � n |. d_ k r i | dR 6|. dS 6| d dP <n
| j* d^ � t7 | � }) t j8 |) � |) | d <| S(` u
.. versionadded:: 2016.3.0
Make sure a repository is cloned to the given target directory and is
a detached HEAD checkout of the commit ID resolved from ``rev``.
name
Address of the remote repository.
rev
The branch, tag, or commit ID to checkout after clone.
If a branch or tag is specified it will be resolved to a commit ID
and checked out.
target
Name of the target directory where repository is about to be cloned.
remote : origin
Git remote to use. If this state needs to clone the repo, it will clone
it using this value as the initial remote name. If the repository
already exists, and a remote by this name is not present, one will be
added.
user
User under which to run git commands. By default, commands are run by
the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
force_clone : False
If the ``target`` directory exists and is not a git repository, then
this state will fail. Set this argument to ``True`` to remove the
contents of the target directory and clone the repo into it.
force_checkout : False
When checking out the revision ID, the state will fail if there are
unwritten changes. Set this argument to ``True`` to discard unwritten
changes when checking out.
fetch_remote : True
If ``False`` a fetch will not be performed and only local refs
will be reachable.
hard_reset : False
If ``True`` a hard reset will be performed before the checkout and any
uncommitted modifications to the working directory will be discarded.
Untracked files will remain in place.
.. note::
Changes resulting from a hard reset will not trigger requisites.
submodules : False
Update submodules
identity
A path on the minion (or a SaltStack fileserver URL, e.g.
``salt://path/to/identity_file``) to a private key to use for SSH
authentication.
https_user
HTTP Basic Auth username for HTTPS (only) clones
https_pass
HTTP Basic Auth password for HTTPS (only) clones
onlyif
A command to run as a check, run the named command only if the command
passed to the ``onlyif`` option returns true
unless
A command to run as a check, only run the named command if the command
passed to the ``unless`` option returns false
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
u nameu resultu u commentu changesRA u1 '{0}' is not a valid value for the 'rev' argumentu4 '{0}' is not a valid value for the 'target' argumentu$ Target '{0}' is not an absolute pathu* Identity must be either a list or a stringu salt://u
cp.cache_fileu Failed to cache %s: %su Identity '{0}' does not exist.u& Identity '{0}' is not an absolute pathu9 Target '{0}' exists and is a regular file, cannot proceedRB u runasu shellu refi( c s@ s | ] } | t j k Vq d S( N( RI RJ ( RK RL ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pys <genexpr>� s u hashu .gitu git.is_worktreeR" R# R% i u git.describeR$ u git.remotesRM u fetchu testu Remote {0} would be set to {1}u git.remote_setRQ RR RF RG u& Remote {0} updated from '{1}' to '{2}'u� Target directory {0} exists. Since force_clone=True, the contents of {0} would be deleted, and {1} would be cloned into this directory.uh Removing contents of %s to clone repository %s in its place (force_clone=True set in git.detached state)u
{0}
{1}u Unable to remove
{0}u
u forced cloneu� Target '{0}' exists, is non-empty and is not a git repository. Set the 'force_clone' option to True to remove this directory's contents and proceed with cloning the remote repositoryu/ Target %s is not found, 'git clone' is requiredu% Repository {0} would be cloned to {1}u
--no-checkoutu originu --originu git.cloneRP RE RH u {0} cloned to {1}u* Unexpected exception in git.detached stateRV u refs/heads/*:refs/remotes/{0}/*u +refs/tags/*:refs/tags/*u& Repository remote {0} would be fetchedu git.fetchRT RU u Fetch failedu :
u1 Remote {0} was fetched, resulting in updated refsu Revision '{0}' does not existu git.remote_refsu
refs/remotes/u /u
refs/tags/u Failed to list refs for {0}: {1}u, Hard reset to HEAD would be performed on {0}u git.resetu --hardu HEADu9 Repository was reset to HEAD before checking out revisionu oldu newu) Commit ID {0} would be checked out at {1}u git.checkoutu$ Commit ID {0} was checked out at {1}u git.revisionRS u
git.submoduleu updateu --initu --recursiveu Submodules were updatedu' Already checked out at correct revisionN(9 R
RW RX RY RZ R7 R[ R R0 R\ R R] R^ R R_ R` Ra Rb Rc R Re R& R� Rh RQ Ri Rj Rk Rl Rm Rn Ro Rp R Ru Rv R Rx R* R R1 R5 R R� Rz R� R� R� R� R� Rs R Rd R R/ R R' (/ R� R; R( RR R" R# R� R� t fetch_remotet
hard_resetR� RE RF RG R� R� R% R� R RL R� R. R� R� R� R� R� R t hash_exists_locallyt local_commit_idR� R� t current_fetch_urlR� R� R� R� R� R� R� R� R6 RU R� t checkout_commit_idR� R� ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt detached� sn l"
%
1
c @ sP i � d 6t d 6d d 6i d 6} � d% k r< d | d <| St � t j � s` t j � � � n t j j � � s� d | d <| S| d% k r� t | t j � s� t j | � } n | s� d | d <| Sn t j j � � s� t
}
nT y$ t d � d
| d | d | �Wn' t k
r/} t j | � | d <| SXt }
g } � � f d
� }
d � } |
r�t
d r�|
| � d j � � | d% k r�d j | � n d � } t | | � S| d% k r�d | g n d% } y? t d � � d | d
| d | d | d | d | d | �Wn5 t k
rB} d j t | � � } t | | | � SX| j d j � � | d% k rpd j | � n d � � |
| � t | � | d <t
| d <| S| d% k r�t | � | | � St d � d
| d | d | �} | | k rt | � | | � St
d r2| | | | � t | d j | � � Sy0 t d � d | d
| d | d t
d | �Wn2 t k
r�d j d | f � } d! | g } n
X| } d% } y0 t d" � d | d | d
| d | d | �Wn2 t k
r} d# j | | � } t | | | � SX| j d$ j | � � | | | | � t | � | d <t
| d <| Sd% S(& u�
.. versionadded:: 2018.3.3,2019.2.0
Ensure that a repository has been cloned to the specified target directory.
If not, clone that repository. No fetches will be performed once cloned.
name
Address of the remote repository
target
Name of the target directory where repository should be cloned
branch
Remote branch to check out. If unspecified, the default branch (i.e.
the one to the remote HEAD points) will be checked out.
.. note::
The local branch name will match the remote branch name. If the
branch name is changed, then that branch will be checked out
locally, but keep in mind that remote repository will not be
fetched. If your use case requires that you keep the clone up to
date with the remote repository, then consider using
:py:func:`git.latest <salt.states.git.latest>`.
user
User under which to run git commands. By default, commands are run by
the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
identity
Path to a private key to use for ssh URLs. Works the same way as in
:py:func:`git.latest <salt.states.git.latest>`, see that state's
documentation for more information.
https_user
HTTP Basic Auth username for HTTPS (only) clones
https_pass
HTTP Basic Auth password for HTTPS (only) clones
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
u nameu resultu u commentu changesu 'target' argument is requiredu 'target' path must be absoluteu Invalid 'branch' argumentu
git.statusR" R# R% c @ s � d � | d d <d S( Nu => u changesu new( ( R ( R� R( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _clone_changes- s c S@ s i | d 6| d 6| d d <d S( Nu oldu newu changesu branch( ( R t oldt new( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt _branch_changes0 s u testu {0} would be cloned to {1}{2}u with branch '{0}'u --branchu git.cloneRP RE RF RG u Clone failed: {0}u {0} cloned to {1}{2}u git.current_branchu Branch would be changed to '{0}'u
git.rev_parseR; R$ u /u originu -bu git.checkoutu% Failed to change branch to '{0}': {1}u Branch changed to '{0}'N( R R R\ R R] R^ R_ R` Ra t existsR
R R R1 R0 R5 R R/ R7 R R R8 R ( R� R( R R" R# RE RF RG R% R t
need_cloneR. R R� R� R4 R� R6 t current_branchR� R� ( ( R� R( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt cloned�
s� >"
c K@ s� i | d 6i d 6t d 6d d 6} t j j j | � } | j d t � } | j d t � } | r� t | t j j j | d t �� S| r� | r� t | d � St | t
j � s� t
j | � } n | d$ k r� t | t
j � s� t
j | � } q� n d
| j d
� j d � d }
t d d
| d |
d | d | d | d t d | i | d 6� } | s`| S| s g t
j | � D]9 \ } }
t |
� d k rvd j | d j |
� � ^ qv} | r | d$ k r�t | d j d j | � � � St | d j d j | � � � Sq n t d r;| | d <t | d j t | � � � S| d$ k rP| } nA t d d
| d |
d d$ d | d | d t d | i | d 6� } g } x� | D]� } yC t d d
| d | d | d | d | d | d | i | d 6� Wq�t k
rR} d j | � } | d$ k r!| d 7} n | d t | � 7} t j | � | j | � q�Xq�W| r|t | d! j d j | � � � St d d
| d |
d d$ d | d | d t d | i | d 6� } xs | D]k } | | k r�| | | d | <n g | | D] } | | | k r�| ^ q�} | r�| | d | <q�q�W| d$ k rH| } nA t d d
| d |
d | d | d | d t d | i | d 6� } | r�g t
j | � D]' \ } }
d j | d j |
� � ^ q�} t | d" j d j | � � � Sd# | d <| S(% u'
.. versionadded:: 2015.8.0
Ensure that the named config key is not present
name
The name of the configuration key to unset. This value can be a regex,
but the regex must match the entire key name. For example, ``foo\.``
would not match all keys in the ``foo`` section, it would be necessary
to use ``foo\..+`` to do so.
value_regex
Regex indicating the values to unset for the matching key(s)
.. note::
This option behaves differently depending on whether or not ``all``
is set to ``True``. If it is, then all values matching the regex
will be deleted (this is the only way to delete multiple values
from a multivar). If ``all`` is set to ``False``, then this state
will fail if the regex matches more than one value in a multivar.
all : False
If ``True``, unset all matches
repo
Location of the git repository for which the config value should be
set. Required unless ``global`` is set to ``True``.
user
User under which to run git commands. By default, commands are run by
the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
global : False
If ``True``, this will set a global git config option
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
**Examples:**
.. code-block:: yaml
# Value matching 'baz'
mylocalrepo:
git.config_unset:
- name: foo.bar
- value_regex: 'baz'
- repo: /path/to/repo
# Ensure entire multivar is unset
mylocalrepo:
git.config_unset:
- name: foo.bar
- all: True
# Ensure all variables in 'foo' section are unset, including multivars
mylocalrepo:
git.config_unset:
- name: 'foo\..+'
- all: True
# Ensure that global config value is unset
mylocalrepo:
git.config_unset:
- name: foo.bar
- global: True
u nameu changesu resultu No matching keys are setu commentu globalu allRA u? Non-global config options require the 'repo' argument to be setu ^u $u git.config_get_regexpRS t keyt value_regexR" R# R$ R% i u {0} ({1})u , uk Multiple values are matched by value_regex for the following keys (set 'all' to True to force removal): {0}u ; uS Multivar(s) matched by the key expression (set 'all' to True to force removal): {0}u testu$ {0} key(s) would have value(s) unsetu git.config_unsetRu u Failed to unset '{0}'u using value_regex '{1}'u : u_ Error(s) occurred unsetting values for the following keys (see the minion log for details): {0}u Failed to unset value(s): {0}u Value(s) successfully unsetN( R
RW RX RY RZ t popR R7 R[ R\ R R] R^ R t lstript rstripR Rs R R0 R R1 R5 R R/ R& R� R ( R� R� t repoR" R# R% R� R t global_t all_R� t pre_matchesRL t yt greedy_matchesR< t failedt key_nameR. R6 R= t unsett post_matches( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt config_unset� s� Z
3
-
:
c K@ s� i | d 6i d 6t d 6d d 6} | d# k rG | d# k rG t | d � St j j j | � } | j d t � } | r� t | t j j j | d t �� S| r� | r� t | d � St
| t j � s� t j
| � } n | d# k r t
| t j � st j
| � } n d
| d
}
| g } n | d# k r�t
| t � s|y | j d � } Wq�t k
rxt j
| � j d � } q�XnU g } xF | D]> }
t
|
t j � r�| j |
� q�| j t j
|
� � q�W| } | }
| } n t d d
| d | d | d | d t d | i t d 6| d 6� } | | k rWd j | r@d n d | |
� | d <| St d r�i | d 6| d 6| d <d j | r�d n d | | d# k r�d n d |
� } t | | � SyE t d d
| d | d | d | d | d | d | i | d 6� } WnA t k
rD} t | d j | r+d n d | |
t | � � � SX| | k rpi | d 6| d 6| d | <n | | k r�t | d! j | r�d n d | |
� � Sd" j | r�d n d | | d# k r�d n d |
� | d <| S($ u
.. versionadded:: 2014.7.0
.. versionchanged:: 2015.8.0
Renamed from ``git.config`` to ``git.config_set``. For earlier
versions, use ``git.config``.
Ensure that a config value is set to the desired value(s)
name
Name of the git config value to set
value
Set a single value for the config item
multivar
Set multiple values for the config item
.. note::
The order matters here, if the same parameters are set but in a
different order, they will be removed and replaced in the order
specified.
.. versionadded:: 2015.8.0
repo
Location of the git repository for which the config value should be
set. Required unless ``global`` is set to ``True``.
user
User under which to run git commands. By default, the commands are run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
global : False
If ``True``, this will set a global git config option
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
**Local Config Example:**
.. code-block:: yaml
# Single value
mylocalrepo:
git.config_set:
- name: user.email
- value: foo@bar.net
- repo: /path/to/repo
# Multiple values
mylocalrepo:
git.config_set:
- name: mysection.myattribute
- multivar:
- foo
- bar
- baz
- repo: /path/to/repo
**Global Config Example (User ``foo``):**
.. code-block:: yaml
mylocalrepo:
git.config_set:
- name: user.name
- value: Foo Bar
- user: foo
- global: True
u nameu changesu resultu u commentu/ Only one of 'value' and 'multivar' is permittedu globalRA u? Non-global config options require the 'repo' argument to be setu 'u ,u git.config_getRS R� R" R# R$ R% u allu {0}'{1}' is already set to {2}u Global key u testu oldu newu {0}'{1}' would be {2} {3}u added asu set tou git.config_sett valuet multivaru" Failed to set {0}'{1}' to {2}: {3}u global key u Failed to set {0}'{1}' to {2}u {0}'{1}' was {2} {3}N( R
R R7 RW RX RY RZ R� R R[ R\ R R] R^ Rb t splitt AttributeErrorR R R0 R1 R5 R R/ ( R� R� R� R� R" R# R% R� R R� t
value_commentt desiredt new_multivart itemR< R6 R= R. ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt
config_set� s� ]
c C@ s� t j | � } | j i t d 6t d 6t d 6t d 6� | d k r t | t � s_ | g } n x� | D]� } t | t j � r� | r� qf n y# t
d | | � d k r� wf n Wn; t k
r� } t j
d | � i d j | � d 6t d
6SXi d d 6t d 6t d
6SWn | d k r�t | t � s0| g } n x� | D]� } t | t j � r[| r[Pn y! t
d | | � d k r{Pn Wq7t k
r�} t j
d
| � i d j | � d 6t d
6SXq7Wi d d 6t d 6t d
6Sn t S( u�
Execute the onlyif and unless logic. Return a result dict if:
* onlyif failed (onlyif != 0)
* unless succeeded (unless == 0)
Otherwise, returns ``True``
u use_vtu bgu ignore_retcodeu python_shellu cmd.retcodei u0 The following onlyif command raised an error: %su3 onlyif raised error ({0}), see log for more detailsu commentu resultu onlyif condition is falseu
skip_watchu0 The following unless command raised an error: %su3 unless raised error ({0}), see log for more detailsu unless condition is trueN( t copyt deepcopyRp R R
R R\ Rb R R] R R R& Rf R0 ( t
cmd_kwargsR� R� t commandR. ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyRn q
s^
(2 t __doc__t
__future__R R R R� R� t loggingR_ R+ RI t salt.utils.argsRW t salt.utils.filest salt.utils.urlt salt.utils.versionst salt.exceptionsR R R t salt.extR t getLoggert __name__R& R R R R R R R! R* R/ R R3 R5 R7 R8 R9 R: R@ R
R� R� R� R� R� R� Rn ( ( ( s3 /usr/lib/python2.7/site-packages/salt/states/git.pyt <module> s�
3 � � � � � � � � � � � � �
Mini Shell