59 lines
1.1 KiB
Markdown
59 lines
1.1 KiB
Markdown
# Cachy-workstation
|
|
|
|
Infrastructure-as-Code for a CachyOS Linux workstation, managed with Ansible.
|
|
|
|
## Goals
|
|
|
|
- Describe and reproduce the workstation configuration declaratively
|
|
- Learn Ansible patterns: site-based playbooks, roles, and tags
|
|
|
|
## Design
|
|
|
|
- **Tool:** Ansible
|
|
- **Target:** `localhost` only
|
|
- **Entry point:** `site.yml`
|
|
- **Structure:** Roles with tags for selective execution
|
|
|
|
## Prerequisites
|
|
|
|
- Ansible installed on the workstation
|
|
- A working Python environment (required by Ansible)
|
|
|
|
Install prerequisites manually before running the playbook:
|
|
|
|
```bash
|
|
sudo pacman -S ansible ansible-lint
|
|
```
|
|
|
|
## Usage
|
|
|
|
Run the full site playbook:
|
|
|
|
```bash
|
|
ansible-playbook site.yml
|
|
```
|
|
|
|
Run only tasks matching a specific tag:
|
|
|
|
```bash
|
|
ansible-playbook site.yml --tags <tagname>
|
|
```
|
|
|
|
Skip tasks matching a tag:
|
|
|
|
```bash
|
|
ansible-playbook site.yml --skip-tags <tagname>
|
|
```
|
|
|
|
## Structure
|
|
|
|
```
|
|
.
|
|
├── site.yml # Main entry point
|
|
├── inventory/ # Inventory files
|
|
├── roles/ # Ansible roles
|
|
└── group_vars/ # Variables by group
|
|
```
|
|
|
|
> Structure will grow as roles are added.
|