Ansible 核心文档

ansible.builtin.subversion 模块 – 部署 Subversion 仓库

注意

此模块是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，即使不指定 collections 关键字，您也可以使用简短的模块名称 subversion。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.subversion，以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合发生冲突。

概要 

将给定的仓库 URL/修订版本部署到 dest。如果 dest 存在，则更新到指定的修订版本，否则执行检出操作。

要求 

执行此模块的主机需要以下要求。

subversion（带有 svn 入口点的命令行工具）

参数 

参数	注释
checkout 布尔值	如果为 `false`，则如果仓库在本地不存在，则不检出。选项 `false` `true` ← (默认)
dest 路径	应部署仓库的绝对路径。除非 `checkout=no`、`update=no` 和 `export=no`，否则必须指定目标目录。
executable 路径	要使用的 svn 可执行文件的路径。如果未提供，则将使用解析二进制文件路径的正常机制。
export 布尔值	如果为 `true`，则执行导出而不是检出/更新。选项 `false` ← (默认) `true`
force 布尔值	如果为 `true`，则将丢弃已修改的文件。如果为 `false`，则如果遇到已修改的文件，模块将失败。在 1.9 之前，默认值为 `true`。选项 `false` ← (默认) `true`
in_place 布尔值	如果目录存在，则将使用 `svn checkout --force` 在其上检出工作副本；如果指定了 force，则将还原具有不同内容的现有文件。选项 `false` ← (默认) `true`
password 字符串	当 svn 版本低于 1.10.0 时，传递给 svn 的 `--password` 参数。这并不安全，密码将泄露到 argv 中。当 svn 版本大于或等于 1.10.0 时，使用 `--password-from-stdin` 参数。
repo 别名：name、repository 字符串 / 必需	仓库的 Subversion URL。
revision 别名：rev、version 字符串	要检出的特定修订版本。默认值： `"HEAD"`
switch 布尔值	如果为 `false`，则在更新之前不调用 svn switch。选项 `false` `true` ← (默认)
update 布尔值	如果为 `false`，则不从源仓库检索新的修订版本。选项 `false` `true` ← (默认)
username 字符串	传递给 svn 的 `--username` 参数。
validate_certs 布尔值在 ansible-core 2.11 中添加	如果为 `false`，则将 `--trust-server-cert` 标志传递给 svn。如果为 `true`，则不传递该标志。选项 `false` ← (默认) `true`

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 check_mode 下运行并返回更改状态预测，而无需修改目标，如果不受支持，则操作将被跳过。
diff_mode	支持：不支持	在 diff 模式下，将返回有关已更改内容（或可能需要在 check_mode 下更改的内容）的详细信息
platform	平台： posix	可以对其进行操作的目标操作系统/系列

备注 

注意

此模块不处理外部文件。

示例 

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

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

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

作者

Dane Summers (@dsummersl)

集合链接