Documentation
PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.21
Documentation for other releases can be found by using the version selector in the top right of any doc page.archive
Creates a compressed archive of one or more files or directories.
Attributes
check_mode:
support: partial
diff_mode:
support: full
Parameters
| Parameter | Required | Type | Values | Description |
|---|---|---|---|---|
| path | true | array | Remote absolute path, list of paths, or glob patterns for the file or files to archive. | |
| dest | true | string | The file name of the destination archive. | |
| format | string | gz bz2 xz tar zip |
The type of compression to use. [default: "gz"] |
|
| exclude | array | List of patterns to exclude from the archive. | ||
| remove | boolean | Remove the original file tree after archiving. | ||
| force | boolean | Force archiving even if the destination archive already exists. |
Examples
- archive:
path: /var/log/app
dest: /backup/logs.tar.gz
- archive:
path:
- /etc/nginx
- /etc/apache2
dest: /backup/web-configs.tar.bz2
format: bz2
- archive:
path: /home/user/data
dest: /backup/data.tar.xz
format: xz
exclude:
- "*.tmp"
- "*.cache"