This repository contains an Ansible role to install and update cv, the CiviCRM command line interface.
There are eight default variables, set cv to true for the tasks in this role to be run, it defaults to false, the other variables should only need changing if this role isn't run as root and you wish to install cv into a users ~/hom/bin, cv_bin, cv_bash_completion_dir and cv_download_dir directories need to be writable by the cv_owner:
| Variable name | Default value | Comment |
|---|---|---|
cv |
true |
Run the tasks in this role. |
cv_bash_completion_dir |
/etc/bash_completion.d |
Bash_completion directory. |
cv_bin |
/usr/local/bin |
The directory into which cv will be installed. |
cv_download_dir |
/root |
The directory used for downloading files. |
cv_group |
"{{ cv_owner }}" |
The group for the cv files. |
cv_owner |
root |
The owner of the cv files. |
cv_pkgs_present |
bash-completion php-cli |
Required packages. |
cv_verify |
true |
Verify the variables that start with cv_ |
See also the meta/argument_specs.yml for all the variables this role uses, including the internal ones.
The primary URL of this repo is https://git.coop/webarch/cv however it is also mirrored to GitHub and available via Ansible Galaxy.
See the GitLab releases page for details regarding each version, please use a specific version since the master branch is used for development.
This role can also be used with the localhost repo to install cv locally.
Copyright 2021-2025 Chris Croome, <[email protected]>.
This role is released under the same terms as Ansible itself, the GNU GPLv3.