2012-08-13 21:39:00 +02:00
|
|
|
.. _git:
|
|
|
|
|
|
|
|
git
|
|
|
|
```
|
|
|
|
|
|
|
|
Deploys software (or files) from git checkouts.
|
|
|
|
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
|
|
| parameter | required | default | comments |
|
|
|
|
+====================+==========+=========+============================================================================+
|
|
|
|
| repo | yes | | git, ssh, or http protocol address of the git repo |
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
|
|
| dest | yes | | absolute path of where the repo should be checked out to |
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
|
|
| version | no | HEAD | what version to check out -- either the git SHA, the literal string |
|
|
|
|
| | | | 'HEAD', branch name, or a tag name. |
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
|
|
| remote | no | origin | name of the remote branch |
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
2012-08-25 03:13:08 +02:00
|
|
|
| force | no | yes | (New in 0.8) If yes, any modified files in the working repository will be |
|
|
|
|
| | | | thrown out. If no, this module will fail if it encounters modified files. |
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
2012-08-13 21:39:00 +02:00
|
|
|
|
|
|
|
Example action from Ansible :doc:`playbooks`::
|
|
|
|
|
|
|
|
git repo=git://foosball.example.org/path/to/repo.git dest=/srv/checkout version=release-0.22
|