Built in the open.
The code, the roadmap, the issues and the decisions behind the design are public. Bug reports, fixes, features and documentation are all welcome.
My run failed
Read the exit code and the message, narrow the failure down to one task, and compare with ansible-playbook. The page walks through it.
When a run failsReport a difference
A playbook that behaves differently under Volant and ansible-playbook is a bug. The template asks for what it takes to reproduce it.
Open a compatibility reportTake an issue
Each planned issue gives the expected behaviour, the acceptance criteria and where to start in the code. Comment on it before you begin.
Good first issuesAsk or propose
Questions, ideas and design discussions go to Discussions. For anything larger than a fix, open an issue first so the approach is agreed.
Go to DiscussionsImprove the documentation
Every page has a link to edit it and a link to report a problem with it. The documentation lives in the same repository as the engine.
Read the documentationSet up in four commands.
The repository pins its Rust toolchain, so rustup picks the right version. Every change goes through a pull request, with tests for what it touches.
cargo install cargo-binstall cargo binstall just just setup # git hooks and the tools the recipes use just check # formatting, lints and the test suite
What comes next.
The releases planned so far, in order. Each one is a milestone on GitHub with its issues.
- v0.1.0-alpha.11
The command suite: volant adhoc, volant vault and volant inventory in Rust; doc, config, galaxy, pull and console through the managed runtime; opt-in ansible-* command names, so existing scripts run unchanged without ansible installed
- v0.1.0-alpha.12
A safe switch: record real ansible-playbook runs, replay them under Volant without touching hosts, and lock the engine version
- v0.1.0-alpha.13
Container connections: docker, podman, kubectl, lxd and incus, chroot, buildah, aws_ssm
- v0.1.0-alpha.14
Internal work: shorter executor functions, declarative tables, memory use
- v0.1.0-alpha.15
Network devices (network_cli, netconf, httpapi), paramiko_ssh and the other stdout callbacks
- v0.1.0-alpha.16
volant galaxy in Rust: collections and roles
- v0.1.0-alpha.17
volant pull and volant console in Rust
- v0.1.0-alpha.18
A Windows controller: volant.exe
- v0.1.0-alpha.19
Windows hosts: winrm, psrp, runas and the PowerShell modules
License
GPL-3.0-or-later, like Ansible. Decision record 0001 explains why.
Security
Report a vulnerability privately, never in a public issue. The security policy says how.
Support
Where to ask, and what to include so someone can help. SUPPORT.md
Decisions
The choices that shape what users see are written down with their reasons. The decision records