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


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

Documentation and Bugs
======================

To learn how to install and update salt-formulas, consult the documentation
available online at:

    http://salt-formulas.readthedocs.io/

In the unfortunate event that bugs are discovered, they should be reported to
the appropriate issue tracker. Use Github issue tracker for specific salt
formula:

    https://github.com/salt-formulas/salt-formula-git/issues

For feature requests, bug reports or blueprints affecting entire ecosystem,
use Launchpad salt-formulas project:

    https://launchpad.net/salt-formulas

You can also join salt-formulas-users team and subscribe to mailing list:

    https://launchpad.net/~salt-formulas-users

Developers wishing to work on the salt-formulas projects should always base
their work on master branch and submit pull request against specific formula.

    https://github.com/salt-formulas/salt-formula-git

Any questions or feedback is always welcome so feel free to join our IRC
channel:

    #salt-formulas @ irc.freenode.net