Jonas Hagen
2abc34f922
Provides the capability to make shallow clones (including submodules) to deploy repositories with huge history. Note that this might not work with some servers (github.com) if the commit that is required by a submodule is too far away from any reference.
66 lines
1.3 KiB
ReStructuredText
66 lines
1.3 KiB
ReStructuredText
cdist-type__git(7)
|
|
==================
|
|
|
|
NAME
|
|
----
|
|
cdist-type__git - Get and or keep git repositories up-to-date
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This cdist type allows you to clone git repositories
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
-------------------
|
|
source
|
|
Specifies the git remote to clone from
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
-------------------
|
|
state
|
|
Either "present" or "absent", defaults to "present"
|
|
|
|
branch
|
|
Create this branch by checking out the remote branch of this name
|
|
Default branch is "master"
|
|
|
|
group
|
|
Group to chgrp to.
|
|
|
|
mode
|
|
Unix permissions, suitable for chmod.
|
|
|
|
owner
|
|
User to chown to.
|
|
|
|
recursive
|
|
Passes the --recurse-submodules flag to git when cloning the repository.
|
|
|
|
shallow
|
|
Sets --depth=1 and --shallow-submodules for cloning repositories with big history.
|
|
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
.. code-block:: sh
|
|
|
|
__git /home/services/dokuwiki --source git://github.com/splitbrain/dokuwiki.git
|
|
|
|
# Checkout cdist, stay on branch 2.1
|
|
__git /home/nico/cdist --source git@code.ungleich.ch:ungleich-public/cdist.git --branch 2.1
|
|
|
|
|
|
AUTHORS
|
|
-------
|
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
|
|
|
|
|
COPYING
|
|
-------
|
|
Copyright \(C) 2012 Nico Schottelius. You can redistribute it
|
|
and/or modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation, either version 3 of the
|
|
License, or (at your option) any later version.
|