User Guide

This guide provides installation steps, basic usage instructions, and practical examples for using Parallax.

Installation

go install gitlab.com/digitalxero/parallax@latest

To build from source:

git clone https://gitlab.com/digitalxero/parallax.git
cd parallax
task build  # produces the parallax binary in ./bin

Basic Usage

Execute a playbook:

parallax play playbook.yml

Run with a specific inventory and limit to tags:

parallax play -i inventory.ini --tags "setup,configure" playbook.yml

Skip tags during execution:

parallax play --skip-tags "test,cleanup" playbook.yml

Check mode (dry run):

parallax play --check playbook.yml

Examples

Inventory Formats

  1. INI Format
[webservers]
web1.example.com ansible_host=10.0.0.1
web2.example.com ansible_port=2222

[dbservers]
db[1:3].example.com

[webservers:vars]
http_port=80
  1. YAML Format
all:
  hosts:
    web1.example.com:
      ansible_host: 10.0.0.1
    web2.example.com:
      ansible_port: 2222
  children:
    webservers:
      vars:
        http_port: 80
  1. Command Line
parallax play -i "web1.example.com,web2.example.com" playbook.yml

Sample Playbook

- hosts: webservers
  tasks:
    - name: Ensure nginx is installed
      package:
        name: nginx
        state: present

Run the sample playbook:

parallax play -i inventory.ini sample.yml
Migration Guide