---
name: "cdist-type__git"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__git"
---

# cdist-type\_\_git(7)

Get and or keep git repositories up-to-date

## 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

```
__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.

## COPYRIGHT

ungleich GmbH 2021