summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/version/git.txt
blob: 8831895525fbf38686db412616cb1235883386ba (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
.. -*- mode: rst -*-

.. _server-plugins-version-git:

===
Git
===

Why use the Git plugin
======================

The Git plugin is useful if you would like to track changes to your bcfg2
repository using a `Git <http://git-scm.com/>`_ backend. Currently,
It enables you to get revision information out of your repository for
reporting purposes. Once the plugin is enabled, every time a client
checks in, it will include the current repository revision in the
reports/statistics.

Future plans are to commit changes to the repo which are made by the
server (adding clients, ssh keys, etc).

How to enable the Git plugin
============================

The Git plugin uses `Dulwich <http://samba.org/~jelmer/dulwich/>`_ to
interface with git repositories. Therefore, you will need to install
Dulwich on the bcfg2 server first. Once installed, simply add Git to
your plugins line in /etc/bcfg2.conf::

    [server]
    plugins = Base,Bundler,Cfg,...,Git