User Guide

Command Line Interface

The chasm command provides several subcommands for managing your infrastructure:

chasm --help

Common Commands

init

Initialize a new Chasm project:

chasm init [project-name]

inventory

Manage your inventory:

chasm inventory create    # Create a new inventory
chasm inventory list     # List available inventories
chasm inventory show     # Show inventory details

deploy

Deploy your infrastructure:

chasm deploy             # Deploy all playbooks
chasm deploy --playbook  # Deploy specific playbook

Configuration

Project Configuration

The project configuration file (chasm.yml) supports the following options:

# Global settings
ansible_config: ansible.cfg
inventory_dir: inventory
playbook_dir: playbooks
role_dir: roles

# Default variables
variables:
  environment: production
  region: us-west-2

Inventory Management

Creating an Inventory

Create a new inventory:
```
chasm inventory create my-inventory
```

Edit the inventory file:

all:
  children:
    webservers:
      hosts:
        web1:
          ansible_host: 192.168.1.10
        web2:
          ansible_host: 192.168.1.11
    databases:
      hosts:
        db1:
          ansible_host: 192.168.1.20

Playbook Management

Creating a Playbook

Create a new playbook:
```
chasm playbook create my-playbook
```

Edit the playbook:

- name: My Playbook
  hosts: webservers
  become: yes
  tasks:
    - name: Install nginx
      package:
        name: nginx
        state: present

Role Management

Creating a Role

Create a new role:
```
chasm role create my-role
```
The role structure will be created in the roles/ directory.

Best Practices

Keep your inventory organized using groups
Use variables for configuration
Document your playbooks and roles
Use version control for your project
Test your playbooks before deployment