About this project
AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for Red Hat Ansible Automation Platform, and its code is developed in the open on GitHub.
What it offers
- A web UI for managing and running Ansible-based automation.
- A REST API for programmatic access to the same capabilities.
- A task engine that executes Ansible playbooks and related jobs.
Project status
A caution notice in the README states that the last release was published on Jul 2, 2024, and that releases are paused during a large-scale refactoring. The README points readers to the Ansible Forum and several linked communications for details, including posts about streamlining AWX releases, refactoring AWX into a pluggable service-oriented architecture, upcoming changes to AWX Operator installation methods, and the transition of the AWX UI and credential types to the new pluggable architecture.
Getting started
- Installation instructions are provided in the repository's INSTALL.md.
- Usage documentation is available on the AWX docs site.
- A project FAQ is linked from the README.
Contributing and community
- A contributing guide covers developing, testing, and building AWX.
- Code submissions go through pull requests against the devel branch.
- Contributors must use git commit --signoff, which constitutes agreement with DCO 1.1.
- Merge commits should be avoided; git rebase is preferred over git merge.
- For large changes, the README suggests discussing via the Ansible Forum first.
- Issues should follow the repository's issues guide before opening a new report.
- All community members and contributors are expected to follow the Ansible code of conduct.
- Feedback and ideas are welcomed through the Ansible Forum, and a communication guide lists all the ways to talk with the Ansible community.
Licensing and branding
AWX is released under the Apache 2.0 license. The AWX logos and branding assets are covered by separate trademark guidelines.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.