# msvsphere.ci.koji_cli

An Ansible role that installs and configures Koji CLI tools.

## Variables

| Variable          | Default value | Type | Description               | Required |
| ----------------- | ------------- | ---- | ------------------------- | -------- |
| koji_domain_name  |               | str  | Koji server domain name.  | yes      |
| koji_cli_user     |               | str  | Koji CLI tools user name. | no       |
| koji_cli_keytab   |               | str  | Kerberos keytab file for automatic authentication. | no |
| koji_cli_principal |              | str  | Kerberos principal for automatic authentication. | no |
| koji_profile      | "koji"        | str  | Koji profile name.        | no       |
| koji_ca_cert_path |               | str  | Koji CA certificate path. | no       |
| koji_topdir       | "/mnt/koji"   | str  | Koji top directory path.  | no       |

If `koji_cli_user` is omitted, the role will modify the system-wide configuration
file `/etc/koji.conf`, otherwise, a configuration file will be generated for the
specified user.

## Example playbook

```yaml
---
- hosts: all
  roles:
    - role: msvsphere.ci.koji_cli
      koji_domain_name: 'build.msvsphere.test'
      koji_ca_cert_path: '/etc/pki/koji/koji-ca.crt'
```

## License

MIT.

## Authors

* [Eugene Zamriy](mailto:ezamriy@msvsphere-os.ru)