| commit | author | age | ||
| 791ee8 | 1 | # Ansible Role: Git |
| JP | 2 | |
| 3 | [](https://travis-ci.org/geerlingguy/ansible-role-git) | |
| 4 | ||
| 5 | Installs Git, a distributed version control system, on any RHEL/CentOS or Debian/Ubuntu Linux system. | |
| 6 | ||
| 7 | ## Requirements | |
| 8 | ||
| 9 | None. | |
| 10 | ||
| 11 | ## Role Variables | |
| 12 | ||
| 13 | Available variables are listed below, along with default values (see `defaults/main.yml`): | |
| 14 | ||
| 15 | workspace: /root | |
| 16 | ||
| 17 | Where certain files will be downloaded and adjusted prior to git installation, if needed. | |
| 18 | ||
| 19 | git_enablerepo: "" | |
| 20 | ||
| 21 | This variable, a well as `git_packages`, will be used to install git via a particular `yum` repo if `git_install_from_source` is false (CentOS only). Any additional repositories you have installed that you would like to use for a newer/different Git version. | |
| 22 | ||
| 23 | git_packages: | |
| 24 | - git | |
| 25 | - git-svn | |
| 26 | ||
| 27 | The specific Git packages that will be installed. By default, `git-svn` is included, but you can easily add this variable to your playbook's variables and remove `git-svn` if desired. | |
| 28 | ||
| 29 | git_install_from_source: false | |
| 30 | git_install_path: "/usr" | |
| 31 | git_version: "2.16.2" | |
| 32 | ||
| 33 | Whether to install Git from source; if set to `true`, `git_version` is required and will be used to install a particular version of git (see all available versions here: https://www.kernel.org/pub/software/scm/git/), and `git_install_path` defines where git should be installed. | |
| 34 | ||
| 35 | git_install_from_source_force_update: false | |
| 36 | ||
| 37 | If git is already installed at and older version, force a new source build. Only applies if `git_install_from_source` is `true`. | |
| 38 | ||
| 39 | ## Dependencies | |
| 40 | ||
| 41 | None. | |
| 42 | ||
| 43 | ## Example Playbook | |
| 44 | ||
| 45 | - hosts: servers | |
| 46 | roles: | |
| 47 | - { role: geerlingguy.git } | |
| 48 | ||
| 49 | ## License | |
| 50 | ||
| 51 | MIT / BSD | |
| 52 | ||
| 53 | ## Author Information | |
| 54 | ||
| 55 | This role was created in 2014 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/). | |
