Robert Kaussow
d524a0fa9f
Author: Robert Kaussow <mail@geeklabor.de> Date: Thu Jun 4 15:15:58 2020 +0200 fix link to the license file
186 lines
3.7 KiB
Markdown
186 lines
3.7 KiB
Markdown
---
|
|
title: ucs
|
|
type: docs
|
|
---
|
|
|
|
[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.ucs) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.ucs?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.ucs) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/ansible/xoxys.ucs/src/branch/master/LICENSE)
|
|
|
|
Configure an [Univention Corporate Server](https://www.univention.com/products/ucs/). UCS is a server appliance with an integrated management system for the central and cross-platform administration of servers, services, clients, desktops and users as well as virtualized computers operated in UCS.
|
|
|
|
{{< hint warning >}} **WARNING**\ This role covers only some really basic configurations and is far away production ready. {{< /hint >}}
|
|
|
|
* [Default Variables](#default-variables)
|
|
* [ucs_cronjobs](#ucs_cronjobs)
|
|
* [ucs_custom_tls_apache2_enabled](#ucs_custom_tls_apache2_enabled)
|
|
* [ucs_custom_tls_dovecot_enabled](#ucs_custom_tls_dovecot_enabled)
|
|
* [ucs_custom_tls_enabled](#ucs_custom_tls_enabled)
|
|
* [ucs_custom_tls_postfix_enabled](#ucs_custom_tls_postfix_enabled)
|
|
* [ucs_filesystem_acl](#ucs_filesystem_acl)
|
|
* [ucs_registry_extra](#ucs_registry_extra)
|
|
* [ucs_repository_unmaintained_enabled](#ucs_repository_unmaintained_enabled)
|
|
* [ucs_system_groups](#ucs_system_groups)
|
|
* [ucs_tls_cert_path](#ucs_tls_cert_path)
|
|
* [ucs_tls_certs_dir](#ucs_tls_certs_dir)
|
|
* [ucs_tls_key_dir](#ucs_tls_key_dir)
|
|
* [ucs_tls_key_path](#ucs_tls_key_path)
|
|
* [Dependencies](#dependencies)
|
|
|
|
---
|
|
|
|
## Default Variables
|
|
|
|
### ucs_cronjobs
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_cronjobs: []
|
|
```
|
|
|
|
#### Example usage
|
|
|
|
```YAML
|
|
ucs_cronjobs:
|
|
- name: backup-cleanup
|
|
job: "find /var/univention-backup -mtime +7 -delete"
|
|
user: root
|
|
minute: 0
|
|
hour: 3
|
|
day: "*"
|
|
weekday: "*"
|
|
month: "*"
|
|
state: present
|
|
```
|
|
|
|
### ucs_custom_tls_apache2_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_custom_tls_apache2_enabled: false
|
|
```
|
|
|
|
### ucs_custom_tls_dovecot_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_custom_tls_dovecot_enabled: false
|
|
```
|
|
|
|
### ucs_custom_tls_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_custom_tls_enabled: false
|
|
```
|
|
|
|
### ucs_custom_tls_postfix_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_custom_tls_postfix_enabled: false
|
|
```
|
|
|
|
### ucs_filesystem_acl
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_filesystem_acl: []
|
|
```
|
|
|
|
#### Example usage
|
|
|
|
```YAML
|
|
ucs_filesystem_acl:
|
|
- path: /shares/mydocuments # needs to be set
|
|
entity: john # needs to be set
|
|
etype: user # needs to be set
|
|
permissions: rw # needs to be set
|
|
state: # defaults to 'query'
|
|
recursive: # defaults to 'no'
|
|
```
|
|
|
|
### ucs_registry_extra
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_registry_extra: []
|
|
```
|
|
|
|
#### Example usage
|
|
|
|
```YAML
|
|
ucs_registry_extra:
|
|
- path: timeserver
|
|
value: "ntp.example.com"
|
|
state: present
|
|
```
|
|
|
|
### ucs_repository_unmaintained_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_repository_unmaintained_enabled: false
|
|
```
|
|
|
|
### ucs_system_groups
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_system_groups: []
|
|
```
|
|
|
|
#### Example usage
|
|
|
|
```YAML
|
|
ucs_system_groups:
|
|
- name: fs-mydocuments-rw # needs to be set
|
|
description: # defaults to not set
|
|
subpath: # defaults to not set
|
|
ou: # defaults to not set
|
|
state: # defaults to 'present'
|
|
```
|
|
|
|
### ucs_tls_cert_path
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_tls_cert_path: /etc/pki/tls/certs/mycert.pem
|
|
```
|
|
|
|
### ucs_tls_certs_dir
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_tls_certs_dir: /etc/pki/tls/certs
|
|
```
|
|
|
|
### ucs_tls_key_dir
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_tls_key_dir: /etc/pki/tls/private
|
|
```
|
|
|
|
### ucs_tls_key_path
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
ucs_tls_key_path: /etc/pki/tls/private/mykey.pem
|
|
```
|
|
|
|
## Dependencies
|
|
|
|
None.
|