ansible.builtin.subversion (v2.8.11) — module

Deploys a subversion repository

| "added in version" 0.7 of ansible.builtin"

Authors: Dane Summers (@dsummersl) <njharman@gmail.com>

preview | supported by core

Install Ansible via pip

Install with pip install ansible==2.8.11

Description

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

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Checkout subversion repository to specified folder
  subversion:
    repo: svn+ssh://an.example.org/path/to/repo
    dest: /src/checkout
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Export subversion directory to folder
  subversion:
    repo: svn+ssh://an.example.org/path/to/repo
    dest: /src/export
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Get information about the repository whether or not it has already been cloned locally
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- subversion:
    repo: svn+ssh://an.example.org/path/to/repo
    dest: /srv/checkout
    checkout: no
    update: no

Inputs

    
dest:
    description:
    - Absolute path where the repository should be deployed.
    required: true

repo:
    aliases:
    - name
    - repository
    description:
    - The subversion URL to the repository.
    required: true

force:
    default: 'no'
    description:
    - If C(yes), modified files will be discarded. If C(no), module will fail if it encounters
      modified files. Prior to 1.9 the default was C(yes).
    type: bool

export:
    default: 'no'
    description:
    - If C(yes), do export instead of checkout/update.
    type: bool
    version_added: '1.6'
    version_added_collection: ansible.builtin

switch:
    default: 'yes'
    description:
    - If C(no), do not call svn switch before update.
    type: bool
    version_added: '2.0'
    version_added_collection: ansible.builtin

update:
    default: 'yes'
    description:
    - If C(no), do not retrieve new revisions from the origin repository.
    type: bool
    version_added: '2.3'
    version_added_collection: ansible.builtin

checkout:
    default: 'yes'
    description:
    - If C(no), do not check out the repository if it does not exist locally.
    type: bool
    version_added: '2.3'
    version_added_collection: ansible.builtin

in_place:
    default: 'no'
    description:
    - 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
    type: bool
    version_added: '2.6'
    version_added_collection: ansible.builtin

password:
    description:
    - C(--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.
    - C(--password-from-stdin) parameter when svn is greater or equal to version 1.10.0.

revision:
    aliases:
    - version
    default: HEAD
    description:
    - Specific revision to checkout.

username:
    description:
    - C(--username) parameter passed to svn.

executable:
    description:
    - Path to svn executable to use. If not supplied, the normal mechanism for resolving
      binary paths will be used.
    version_added: '1.4'
    version_added_collection: ansible.builtin