subversion – Deploys a subversion repository

From Get docs
Ansible/docs/2.8/modules/subversion module


subversion – Deploys a subversion repository

Synopsis

  • Deploy given repository URL / revision to dest. If dest exists, update to the specified revision, otherwise perform a checkout.

Parameters

Parameter Choices/Defaults Comments

checkout

boolean

added in 2.3

  • no
  • yes

If no, do not check out the repository if it does not exist locally.

dest

- / required

Absolute path where the repository should be deployed.

executable

-

Path to svn executable to use. If not supplied, the normal mechanism for resolving binary paths will be used.

export

boolean

  • no

  • yes

If yes, do export instead of checkout/update.

force

boolean

  • no

  • yes

If yes, modified files will be discarded. If no, module will fail if it encounters modified files. Prior to 1.9 the default was yes.

in_place

boolean

added in 2.6

  • no

  • yes

If the directory exists, then the working copy will be checked-out over-the-top using svn checkout --force; if force is specified then existing files with different content are reverted

password

-

--password parameter passed to svn when svn is less than version 1.10.0. This is not secure and the password will be leaked to argv.

--password-from-stdin parameter when svn is greater or equal to version 1.10.0.

repo

- / required

The subversion URL to the repository.


aliases: name, repository

revision

-

Default:

"HEAD"

Specific revision to checkout.


aliases: version

switch

boolean

added in 2.0

  • no
  • yes

If no, do not call svn switch before update.

update

boolean

added in 2.3

  • no
  • yes

If no, do not retrieve new revisions from the origin repository.

username

-

--username parameter passed to svn.



Notes

Note

  • Requires svn to be installed on the client.
  • This module does not handle externals.


Examples

- name: Checkout subversion repository to specified folder
  subversion:
    repo: svn+ssh://an.example.org/path/to/repo
    dest: /src/checkout

- name: Export subversion directory to folder
  subversion:
    repo: svn+ssh://an.example.org/path/to/repo
    dest: /src/export

- name: Get information about the repository whether or not it has already been cloned locally
- subversion:
    repo: svn+ssh://an.example.org/path/to/repo
    dest: /srv/checkout
    checkout: no
    update: no

Status

Red Hat Support

More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.

Authors

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/subversion_module.html