README.rst

===========
Git formula
===========

Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.

Sample pillars
==============

Simplest GIT setup

.. code-block:: yaml

    git:
      client:
        enabled: true

GIT with user setup

.. code-block:: yaml

    git:
      client:
        enabled: true
        user:
        - user:
            name: jdoe
            email: j@doe.com

GIT with user and SSL setup

.. code-block:: yaml

    git:
      client:
        disable_ssl_verification: True
        enabled: true
        user:
        - user:
            name: jdoe
            email: j@doe.com

Reclass with GIT with user setup

.. code-block:: yaml

    git:
      client:
        enabled: true
        user:
        - user: ${linux:system:user:jdoe}

Reclass with GIT with user and SSL setup

.. code-block:: yaml

    git:
      client:
        disable_ssl_verification: True
        enabled: true
        user:
        - user: ${linux:system:user:jdoe}

Reclass with GIT over HTTP server setup. Requires web server.

.. code-block:: yaml

    git:
      server:
        directory: /srv/git
        repos:
          - name: custom-repo-1
          - name: custom-repo-2

Reclass with GIT over HTTP server setup. Requires web server. Mirrored upstream repos example.

.. code-block:: yaml

    git:
      server:
        directory: /srv/git
        repos:
          - name: gerritlib
            url: https://github.com/openstack-infra/gerritlib.git
          - name: jeepyb
            url: https://github.com/openstack-infra/jeepyb.git
            https_user: username
            https_pass: password


Read more
=========

* http://git-scm.com/
* http://git-scm.com/book/en/Customizing-Git-Git-Configuration
* https://github.com/nesi/puppet-git/tree/master/manifests