common/readme.md

61 lines
2 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+) |
### 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
- `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"
```