common/readme.md

70 lines
2.4 KiB
Markdown

# Ansible Role: Common
Manage core Operating System components and system defaults.
## Variables
### APT Configuration
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `apt_automatic_reboot_time` | No | `04:00` | Automated reboot time |
| `apt_automatic_reboot` | No | `true` | Enable automated reboots |
| `apt_enable_multiverse` | No | `false` | Enable multiverse repository |
| `apt_enable_universe` | No | `true` | Enable universe repository |
| `apt_repository` | No | `https://archive.ubuntu.com/ubuntu` | APT repository URL (Ubuntu 22) |
| `apt_repository_main` | No | `https://archive.ubuntu.com/ubuntu` | Main APT repository (Ubuntu 24+) |
| `apt_repository_security` | No | `https://archive.ubuntu.com/ubuntu` | Security APT repository (Ubuntu 24+) |
### DNS Configuration
| Variable | Required | Default | Description |
|----------------|----------|--------------------------|--------------------------------|
| `dns_servers` | No | `["192.168.10.1"]` | List of DNS nameservers to use |
| `dns_search` | No | `["example.internal"]` | List of search domains to use |
| `dns_options` | No | `[]` | List of resolver options |
### NTP Configuration
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `ntp_server` | No | `pool.ntp.org` | NTP server for time synchronization |
| `timezone` | No | `Europe/Amsterdam` | System timezone |
## Tags
Available tags for selective execution:
- `apt` - APT package management
- `apt-cleanup` - Clean APT cache
- `apt-update` - Update APT packages
- `dns` - Manage DNS configuration
- `cron` - Configure cron
- `environment-file` - Manage environment files
- `hostname` - Set hostname
- `hostfile` - Manage /etc/hosts
- `firewall` - Configure firewall
- `journald` - Configure journald
- `locale` - Set system locale
- `lldp` - Configure LLDP
- `lxd` - Configure LXD
- `motd` - Set message of the day
- `ntp` - Configure NTP
- `telemetry` - Configure telemetry
- `snap` - Manage snap packages
- `sshd` - Configure SSH daemon
- `swap` - Configure swap
- `sysctl` - Manage sysctl settings
- `systemctl` - Manage systemd services
- `syslog` - Configure syslog
- `timezone` - Set timezone
- `usermanagement` - Manage users
## Example
```yaml
apt_automatic_reboot: true
apt_automatic_reboot_time: "03:00"
ntp_server: "time.cloudflare.com"
timezone: "UTC"
```