Documentation

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
(added in 2.3)
    Choices:
  • 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
(added in 1.4)
Path to svn executable to use. If not supplied, the normal mechanism for resolving binary paths will be used.
export
(added in 1.6)
    Choices:
  • no ←
  • yes
If yes, do export instead of checkout/update.
force
    Choices:
  • 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.
password
--password parameter passed to svn.
repo
required
The subversion URL to the repository.

aliases: name, repository
revision
Default:
HEAD
Specific revision to checkout.

aliases: version
switch
(added in 2.0)
    Choices:
  • no
  • yes ←
If no, do not call svn switch before update.
update
(added in 2.3)
    Choices:
  • 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

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

For more information about Red Hat’s support of this module, please refer to this Knowledge Base article

Author

Hint

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