arpx

Small-scale process orchestration

• Quick demo
• Installation instructions
• How to use the CLI
• How to write a profile

About

Arpx is a small-scale, run n' gun process orchestrator. In other words, Arpx makes it easy to schedule processes and automate them depending on each others' runtimes in cases where more complex orchestration isn't needed.

Larger-scale process orchestrators (like Kubernetes) allow for in-depth monitoring, complex deployment setups, and granular, real-time process management on top of their normal scheduling and automation features. Arpx, in contrast, aims to provide only that which is necessary for things like running multiple interdependent development servers concurrently, scheduling build scripts or tests in relation to each other, adding naive self-healing to local processes, etc.

automate and relate processes(x)

Vaguely, Arpx's primary use-case is development-oriented tasks which variously require scheduling, concurrency, and/or unsophisticated runtime monitoring and handling.

If you want to hack some orchestration into your development environment, Arpx might be right for you.

Library vs. binary

The name "Arpx" variously refers to the library which provides the program's core functionality (the Arpx runtime object) as well as the binary which wraps that core functionality in a convenient CLI.

Library-specific documentation can be found on docs.rs. Documentation in this repository focuses on the Arpx CLI tool.

Installing

Arpx can be installed using the binaries build on each release or via Rust's cargo install.

Installing a release binary

1. Navigate to the Releases page
2. Choose a release
3. Download the appropriate archive for your machine
4. Unpack the archive and relocate the binary to your desired location
5. Ensure the binary is located in your system's PATH
6. Verify that arpx --version works on your command line

Installing via Cargo

1. Install Rust on your machine (docs)
2. Execute cargo install arpx on your command line

Note on the philosophy behind this project