Modified README
This commit is contained in:
43
README.md
43
README.md
@@ -2,3 +2,46 @@
|
||||
|
||||
Comprehensive Ansible configuration for managing Fedora Workstation laptops. This repository provides automated configuration management for system setup, package management, security hardening, and laptop-specific optimizations.
|
||||
|
||||
## Running the Playbook
|
||||
|
||||
### Basic Usage
|
||||
|
||||
Run the main playbook against localhost:
|
||||
|
||||
```bash
|
||||
ansible-playbook -i inventory/hosts playbook.yml --ask-become-pass
|
||||
```
|
||||
|
||||
The `--ask-become-pass` flag will prompt you for your sudo password, which is needed for most system configuration tasks.
|
||||
|
||||
### Useful Variations
|
||||
|
||||
**Dry run first** (see what would change without making changes):
|
||||
```bash
|
||||
ansible-playbook -i inventory/hosts playbook.yml --check --diff
|
||||
```
|
||||
|
||||
**Check syntax** before running:
|
||||
```bash
|
||||
ansible-playbook playbook.yml --syntax-check
|
||||
```
|
||||
|
||||
**Run only specific tags**:
|
||||
```bash
|
||||
ansible-playbook -i inventory/hosts playbook.yml --tags "packages" --ask-become-pass
|
||||
```
|
||||
|
||||
**List all tasks** that would be executed:
|
||||
```bash
|
||||
ansible-playbook -i inventory/hosts playbook.yml --list-tasks
|
||||
```
|
||||
|
||||
**Run against specific host**:
|
||||
```bash
|
||||
ansible-playbook -i inventory/hosts playbook.yml --limit hostname --ask-become-pass
|
||||
```
|
||||
|
||||
### Recommendation
|
||||
|
||||
It's recommended to start with `--check --diff` to preview changes before actually applying them to your system.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user