1.5.0b1
This is the first beta for the 1.5.0 stable release of ARA.
Changes since 1.4.3:
CLI
---
A new 'ara' CLI API client is now available with the following commands:
- host delete Deletes the specified host and associated resources
- host list Returns a list of hosts based on search queries
- host show Returns a detailed view of a specified host
- play delete Deletes the specified play and associated resources
- play list Returns a list of plays based on search queries
- play show Returns a detailed view of a specified play
- playbook delete Deletes the specified playbook and associated resources
- playbook list Returns a list of playbooks based on search queries
- playbook prune Deletes playbooks beyond a specified age in days
- playbook show Returns a detailed view of a specified playbook
- record delete Deletes the specified record and associated resources
- record list Returns a list of records based on search queries
- record show Returns a detailed view of a specified record
- result delete Deletes the specified result and associated resources
- result list Returns a list of results based on search queries
- result show Returns a detailed view of a specified result
- task delete Deletes the specified task and associated resources
- task list Returns a list of tasks based on search queries
- task show Returns a detailed view of a specified task
"ara-manage prune" has been deprecated and is replaced by "ara playbook prune".
The new prune command provides additional filters in order to only delete
playbooks matching certain criteria such as label, name, path or status.
More information on the CLI commands is available in the docs:
https://ara.readthedocs.io/en/latest/cli.html
API server
----------
New settings have been added:
- ARA_EXTERNAL_AUTH for enabling Django's external authentication
- ARA_DATABASE_OPTIONS for passing options to the Django database backend such as SSL.
More information on the API server settings are available in the docs:
https://ara.readthedocs.io/en/latest/api-configuration.html
API
---
- Added created/updated fields to list views (ex: /api/v1/playbooks, /api/v1/results)
- Added support for filtering hosts based on their results, for example:
- return hosts with no changes: /api/v1/hosts?changed__lt=1
- return hosts with failures: /api/v1/hosts?failed__gt=0
- return hosts with unreachable tasks: /api/v1/hosts?unreachable__gt=0
- Added support for searching results by changed (ex: /api/v1/results?changed=true)
- Added support for searching results by play, task or host (ex: /api/v1/results?task=<id>)
UI
--
- URLs have been pluralized to match the endpoints provided by the API.
For example:
/playbook/1.html -> /playbooks/1.html
/result/1.html -> /results/1.html
Documentation
-------------
- Refreshed installation docs into a "getting started" guide
- Added notes about installation on CentOS 7 / RHEL 7 as well as Mac OS
- Refreshed and merged Ansible plugin configuration and use case docs
- Changelogs and release notes have been incorporated in the docs
Upgrade notes
-------------
- The introduction of the new CLI adds a requirement on the cliff python library.
Not included in beta1
---------------------
Some changes are not yet ready to be merged but are planned to land in time for 1.5:
- API: Nested resources are no longer included on detailed views due to performance issues:
https://github.com/ansible-community/ara/issues/158
- UI: Implement pagination of playbook results
https://github.com/ansible-community/ara/issues/168
- UI: Visually differentiate playbooks runs with "--check":
https://github.com/ansible-community/ara/issues/148
- UI: Linking to a file line number should highlight the line:
https://github.com/ansible-community/ara/issues/154
- UI: Improve display of diffs for playbook runs with "--diff":
https://github.com/ansible-community/ara/issues/29
- Removal of Ansible roles from the ara source repository in favor of the new collection:
https://github.com/ansible-community/ara-collection