54 lines
1.5 KiB
Markdown
54 lines
1.5 KiB
Markdown
|
# Base Provision Role
|
||
|
|
|
||
|
|
Provision basic infrastructure on enterprise nodes with security hardening.
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- **Idempotent**: All tasks use proper idempotency markers (`changed_when`, `failed_when`)
|
||
|
|
- **Handlers**: SSH and fail2ban restarts use handlers instead of direct service calls
|
||
|
|
- **Variables**: All configuration in `defaults/main.yml` - no hardcoding
|
||
|
|
- **Validation**: Pre-flight checks for system requirements
|
||
|
|
- **Firewall**: UFW firewall configuration with configurable rules
|
||
|
|
- **SSH Security**: Root login disabled, password auth disabled, key-based auth only
|
||
|
|
|
||
|
|
## Role Variables
|
||
|
|
|
||
|
|
See `defaults/main.yml` for all available variables.
|
||
|
|
|
||
|
|
### Key Variables
|
||
|
|
|
||
|
|
- `node_timezone`: System timezone (default: UTC)
|
||
|
|
- `admin_user`: Admin username for infrastructure access
|
||
|
|
- `ssh_port`: SSH service port (default: 22)
|
||
|
|
- `base_packages`: List of base packages to install
|
||
|
|
- `firewall_enabled`: Enable UFW firewall (default: true)
|
||
|
|
- `firewall_allowed_tcp_ports`: Allowed TCP ports for firewall
|
||
|
|
|
||
|
|
## Vault Variables
|
||
|
|
|
||
|
|
Admin password should be stored in encrypted vault:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
# vars/vault.yml (encrypted)
|
||
|
|
admin_password: "{{ vault_admin_password }}"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
- role: base_provision
|
||
|
|
vars:
|
||
|
|
node_timezone: "Europe/Warsaw"
|
||
|
|
firewall_enabled: true
|
||
|
|
```
|
||
|
|
|
||
|
|
## Handlers
|
||
|
|
|
||
|
|
- `restart sshd`: Restarts SSH service (triggered by config changes)
|
||
|
|
- `restart fail2ban`: Restarts fail2ban service (triggered by config changes)
|
||
|
|
|
||
|
|
## Tags
|
||
|
|
|
||
|
|
- `provision`: All provisioning tasks
|
||
|
|
- `base`: Base provision role tasks
|