# 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)

## 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.