-
-
1.5.7d5fdc06b · ·
1.5.7 This is the 1.5.7 stable release of ara. It features a new "hosts" page to browse and search playbook reports by host as well as fixes and improvements. Instructions for upgrading are included in the upgrade notes. Changes since 1.5.6: UI -- - Added a new "hosts" page to browse and search reports by host name - Improved page HTML titles to be dynamic based on the context - Added a note highlighting if a task has been delegated to another host (https://github.com/ansible-community/ara/issues/282) - Improved how long file paths or playbook names are truncated and displayed API --- - Added a new read-only API endpoint: /api/v1/latesthosts It provides the latest playbook result for each host name. Under the hood, it implements the machinery for updating the latest host every time a host is created or deleted and includes a SQL migration to initially populate a new database table with the latest hosts. - Added a `delegated_to` field to results in order to record a host id to which a task has been delegated. - Added support for finding results delegated to a specific host: /api/v1/results?delegated_to=<host_id> Callback plugin --------------- - Fixed tasks and results being recorded out of order when using "strategy: free" (https://github.com/ansible-community/ara/issues/260) - Added support for recording 'delegate_to' on tasks Documentation ------------- - Removed an unused sphinx lexer to allow recent versions of sphinx>=4 - Created a new troubleshooting guide with common issues: https://ara.readthedocs.io/en/latest/troubleshooting.html - Added a database relationship graph to the endpoint documentation: https://ara.readthedocs.io/en/latest/api-documentation.html#relationship-between-objects Upgrade notes ------------- It is always recommended to take a backup of your database before upgrading. This release includes two database migrations that must be run: - One for populating the data for the new /api/v1/latesthosts endpoint as well as the new 'hosts' page - One for adding a `delegated_to` field in the results. Note that delegated tasks will only be recorded as such from 1.5.7 on. After upgrading to 1.5.7, database migrations can be run manually with the `ara-manage migrate` command if they are not taken care of automatically by the callback plugin. Known issues ------------ ara will not record task delegation for tasks that are skipped or for items in a loop that are skipped because Ansible doesn't provide the necessary information in those cases.
-
1.5.7rc5d5fdc06b · ·
1.5.7rc5 This is the fifth release candidate for the 1.5.7 stable release of ara. It features a new "hosts" page to browse and search playbook reports by host as well as fixes and improvements. Instructions for upgrading are included in the upgrade notes. Changes since 1.5.7rc4: - Removed source files that were not intended to be packaged in the release tarball - Made delegated_to field optional to provide backwards compatibility with the ara callback plugin from previous versions. - Added a title with explanations over 'Include all playbook reports' Changes since 1.5.6: UI -- - Added a new "hosts" page to browse and search reports by host name - Improved page HTML titles to be dynamic based on the context - Added a note highlighting if a task has been delegated to another host (https://github.com/ansible-community/ara/issues/282) - Improved how long file paths or playbook names are truncated and displayed API --- - Added a new read-only API endpoint: /api/v1/latesthosts It provides the latest playbook result for each host name. Under the hood, it implements the machinery for updating the latest host every time a host is created or deleted and includes a SQL migration to initially populate a new database table with the latest hosts. - Added a `delegated_to` field to results in order to record a host id to which a task has been delegated. - Added support for finding results delegated to a specific host: /api/v1/results?delegated_to=<host_id> Callback plugin --------------- - Fixed tasks and results being recorded out of order when using "strategy: free" (https://github.com/ansible-community/ara/issues/260) Documentation ------------- - Removed an unused sphinx lexer to allow recent versions of sphinx>=4 - Created a new troubleshooting guide with common issues: https://ara.readthedocs.io/en/latest/troubleshooting.html - Added a database relationship graph to the endpoint documentation: https://ara.readthedocs.io/en/latest/api-documentation.html#relationship-between-objects Upgrade notes ------------- It is always recommended to take a backup of your database before upgrading. This release includes two database migrations that must be run: - One for populating the data for the new /api/v1/latesthosts endpoint as well as the new 'hosts' page - One for adding a `delegated_to` field in the results. Note that delegated tasks will only be recorded as such from 1.5.7 on. After upgrading to 1.5.7, database migrations can be run manually with the `ara-manage migrate` command if they are not taken care of automatically by the callback plugin.
-
1.5.7rc40302e632 · ·
1.5.7rc4 This is the fourth release candidate for the 1.5.7 stable release of ara. It features a new "hosts" page to browse and search playbook reports by host as well as fixes and improvements. Instructions for upgrading are included in the upgrade notes. Changes since 1.5.7rc3: - Skip recording delegated_to for skipped items in task loops, the value of delegated_to can erroneously be returned as a variable due to an Ansible bug. Changes since 1.5.6: UI -- - Added a new "hosts" page to browse and search reports by host name - Improved page HTML titles to be dynamic based on the context - Added a note highlighting if a task has been delegated to another host (https://github.com/ansible-community/ara/issues/282) - Improved how long file paths or playbook names are truncated and displayed API --- - Added a new read-only API endpoint: /api/v1/latesthosts It provides the latest playbook result for each host name. Under the hood, it implements the machinery for updating the latest host every time a host is created or deleted and includes a SQL migration to initially populate a new database table with the latest hosts. - Added a `delegated_to` field to results in order to record a host id to which a task has been delegated. - Added support for finding results delegated to a specific host: /api/v1/results?delegated_to=<host_id> Callback plugin --------------- - Fixed tasks and results being recorded out of order when using "strategy: free" (https://github.com/ansible-community/ara/issues/260) Documentation ------------- - Removed an unused sphinx lexer to allow recent versions of sphinx>=4 - Created a new troubleshooting guide with common issues: https://ara.readthedocs.io/en/latest/troubleshooting.html - Added a database relationship graph to the endpoint documentation: https://ara.readthedocs.io/en/latest/api-documentation.html#relationship-between-objects Upgrade notes ------------- It is always recommended to take a backup of your database before upgrading. This release includes two database migrations that must be run: - One for populating the data for the new /api/v1/latesthosts endpoint as well as the new 'hosts' page - One for adding a `delegated_to` field in the results. Note that delegated tasks will only be recorded as such from 1.5.7 on. After upgrading to 1.5.7, database migrations can be run manually with the `ara-manage migrate` command if they are not taken care of automatically by the callback plugin.
-
1.5.7rc38df13a99 · ·
1.5.7rc3 This is the third release candidate for the 1.5.7 stable release of ara. It features a new "hosts" page to browse and search playbook reports by host as well as fixes and improvements. Instructions for upgrading are included in the upgrade notes. Changes since 1.5.7rc2: - Skip recording delegated_to for skipped tasks, the value of delegated_to can erroneously be returned as a variable due to an Ansible bug. - When deleting a playbook, update the latesthost table if one of the hosts of the playbook is a latesthost. Changes since 1.5.6: UI -- - Added a new "hosts" page to browse and search reports by host name - Improved page HTML titles to be dynamic based on the context - Added a note highlighting if a task has been delegated to another host (https://github.com/ansible-community/ara/issues/282) - Improved how long file paths or playbook names are truncated and displayed API --- - Added a new read-only API endpoint: /api/v1/latesthosts It provides the latest playbook result for each host name. Under the hood, it implements the machinery for updating the latest host every time a host is created or deleted and includes a SQL migration to initially populate a new database table with the latest hosts. - Added a `delegated_to` field to results in order to record a host id to which a task has been delegated. - Added support for finding results delegated to a specific host: /api/v1/results?delegated_to=<host_id> Callback plugin --------------- - Fixed tasks and results being recorded out of order when using "strategy: free" (https://github.com/ansible-community/ara/issues/260) Documentation ------------- - Removed an unused sphinx lexer to allow recent versions of sphinx>=4 - Created a new troubleshooting guide with common issues: https://ara.readthedocs.io/en/latest/troubleshooting.html - Added a database relationship graph to the endpoint documentation: https://ara.readthedocs.io/en/latest/api-documentation.html#relationship-between-objects Upgrade notes ------------- It is always recommended to take a backup of your database before upgrading. This release includes two database migrations that must be run: - One for populating the data for the new /api/v1/latesthosts endpoint as well as the new 'hosts' page - One for adding a `delegated_to` field in the results. Note that delegated tasks will only be recorded as such from 1.5.7 on. After upgrading to 1.5.7, database migrations can be run manually with the `ara-manage migrate` command if they are not taken care of automatically by the callback plugin.
-
1.5.7rc2973c138d · ·
1.5.7rc2 This is the second release candidate for the 1.5.7 stable release of ara. It features a new "hosts" page to browse and search playbook reports by host as well as fixes and improvements. Instructions for upgrading are included in the upgrade notes. Changes since 1.5.7rc1: - Fixed issues with recording delegate_to in tasks - Adjusted filtering on latesthost to allow searching by dates on both the latesthost and it's host. Changes since 1.5.6: UI -- - Added a new "hosts" page to browse and search reports by host name - Improved page HTML titles to be dynamic based on the context - Added a note highlighting if a task has been delegated to another host (https://github.com/ansible-community/ara/issues/282) - Improved how long file paths or playbook names are truncated and displayed API --- - Added a new read-only API endpoint: /api/v1/latesthosts It provides the latest playbook result for each host name. Under the hood, it implements the machinery for updating the latest host every time a host is created or deleted and includes a SQL migration to initially populate a new database table with the latest hosts. - Added a `delegated_to` field to results in order to record a host id to which a task has been delegated. - Added support for finding results delegated to a specific host: /api/v1/results?delegated_to=<host_id> Callback plugin --------------- - Fixed tasks and results being recorded out of order when using "strategy: free" (https://github.com/ansible-community/ara/issues/260) Documentation ------------- - Removed an unused sphinx lexer to allow recent versions of sphinx>=4 - Created a new troubleshooting guide with common issues: https://ara.readthedocs.io/en/latest/troubleshooting.html - Added a database relationship graph to the endpoint documentation: https://ara.readthedocs.io/en/latest/api-documentation.html#relationship-between-objects Upgrade notes ------------- It is always recommended to take a backup of your database before upgrading. This release includes two database migrations that must be run: - One for populating the data for the new /api/v1/latesthosts endpoint as well as the new 'hosts' page - One for adding a `delegated_to` field in the results. Note that delegated tasks will only be recorded as such from 1.5.7 on. After upgrading to 1.5.7, database migrations can be run manually with the `ara-manage migrate` command if they are not taken care of automatically by the callback plugin.
-
1.5.7rc144a49ab7 · ·
1.5.7rc1 This is the first release candidate for the 1.5.7 stable release of ara. It features a new "hosts" page to browse and search playbook reports by host as well as fixes and improvements. Instructions for upgrading are included in the upgrade notes. Changes since 1.5.6: UI -- - Added a new "hosts" page to browse and search reports by host name - Improved page HTML titles to be dynamic based on the context - Added a note highlighting if a task has been delegated to another host (https://github.com/ansible-community/ara/issues/282) - Improved how long file paths or playbook names are truncated and displayed API --- - Added a new read-only API endpoint: /api/v1/latesthosts It provides the latest playbook result for each host name. Under the hood, it implements the machinery for updating the latest host every time a host is created or deleted and includes a SQL migration to initially populate a new database table with the latest hosts. - Added a `delegated_to` field to results in order to record a host id to which a task has been delegated. - Added support for finding results delegated to a specific host: /api/v1/results?delegated_to=<host_id> Callback plugin --------------- - Fixed tasks and results being recorded out of order when using "strategy: free" (https://github.com/ansible-community/ara/issues/260) Documentation ------------- - Removed an unused sphinx lexer to allow recent versions of sphinx>=4 - Created a new troubleshooting guide with common issues: https://ara.readthedocs.io/en/latest/troubleshooting.html - Added a database relationship graph to the endpoint documentation: https://ara.readthedocs.io/en/latest/api-documentation.html#relationship-between-objects Upgrade notes ------------- It is always recommended to take a backup of your database before upgrading. This release includes two database migrations that must be run: - One for populating the data for the new /api/v1/latesthosts endpoint as well as the new 'hosts' page - One for adding a `delegated_to` field in the results. Note that delegated tasks will only be recorded as such from 1.5.7 on. After upgrading to 1.5.7, database migrations can be run manually with the `ara-manage migrate` command if they are not taken care of automatically by the callback plugin.
-
1.5.6c80efbe4 · ·
1.5.6 This is the 1.5.6 stable release of ara. It features a refresh of the playbook reporting interface included with the API server as well as fixes and improvements. Changes since 1.5.5: UI -- - Refactored the built-in reporting UI with the bootstrap CSS framework using themes from bootswatch - Added a dark theme in addition to the default light theme (toggle at the top right) - Improved the mobile version of the reporting interface - Improved the playbook and task result tables - Revamped search forms for playbook and playbook results - Revamped hosts table in playbook reports - Added task results to the host details page that includes host facts - Moved ansible-playbook CLI arguments to a modal - Added an "about" modal with the version of ara and links to resources - Moved the link to the documentation to the "about" modal - Clicking on a host or task name in a playbook report will now filter results for that host or task - bugfix: Links to files including a lineno will now highlight that line (https://github.com/ansible-community/ara/issues/154) - bugfix: Fixed broken documentation link to ara_record (https://github.com/ansible-community/ara/issues/219) API --- - Playbook references will now always include CLI arguments, for example: /api/v1/tasks/1 -> { "id": 1, "playbook": { "id": 1, "arguments": { #... } } } Callback plugin --------------- - bugfix: Truncate play UUIDs given back by ansible-runner when running in serial (https://github.com/ansible-community/ara/issues/211)
-
1.5.6rc2c80efbe4 · ·
1.5.6rc2 This is the first release candidate for the 1.5.6 stable release of ara. It features a refresh of the playbook reporting interface included with the API server as well as fixes and improvements. Changes since 1.5.6rc1: - Pinned tzlocal to <3.0 to prevent broken pre-release installation when installing with "pip install --pre ara[server]". Changes since 1.5.5: UI -- - Refactored the built-in reporting UI with the bootstrap CSS framework using themes from bootswatch - Added a dark theme in addition to the default light theme (toggle at the top right) - Improved the mobile version of the reporting interface - Improved the playbook and task result tables - Revamped search forms for playbook and playbook results - Revamped hosts table in playbook reports - Added task results to the host details page that includes host facts - Moved ansible-playbook CLI arguments to a modal - Added an "about" modal with the version of ara and links to resources - Moved the link to the documentation to the "about" modal - Clicking on a host or task name in a playbook report will now filter results for that host or task - bugfix: Links to files including a lineno will now highlight that line (https://github.com/ansible-community/ara/issues/154) - bugfix: Fixed broken documentation link to ara_record (https://github.com/ansible-community/ara/issues/219) API --- - Playbook references will now always include CLI arguments, for example: /api/v1/tasks/1 -> { "id": 1, "playbook": { "id": 1, "arguments": { #... } } } Callback plugin --------------- - bugfix: Truncate play UUIDs given back by ansible-runner when running in serial (https://github.com/ansible-community/ara/issues/211)
-
1.5.6rc195d3e1a7 · ·
1.5.6rc1 This is the first release candidate for the 1.5.6 stable release of ara. It features a refresh of the playbook reporting interface included with the API server as well as fixes and improvements. Changes since 1.5.5: UI -- - Refactored the built-in reporting UI with the bootstrap CSS framework using themes from bootswatch - Added a dark theme in addition to the default light theme (toggle at the top right) - Improved the mobile version of the reporting interface - Improved the playbook and task result tables - Revamped search forms for playbook and playbook results - Revamped hosts table in playbook reports - Added task results to the host details page that includes host facts - Moved ansible-playbook CLI arguments to a modal - Added an "about" modal with the version of ara and links to resources - Moved the link to the documentation to the "about" modal - Clicking on a host or task name in a playbook report will now filter results for that host or task - bugfix: Links to files including a lineno will now highlight that line (https://github.com/ansible-community/ara/issues/154) - bugfix: Fixed broken documentation link to ara_record (https://github.com/ansible-community/ara/issues/219) API --- - Playbook references will now always include CLI arguments, for example: /api/v1/tasks/1 -> { "id": 1, "playbook": { "id": 1, "arguments": { #... } } } Callback plugin --------------- - bugfix: Truncate play UUIDs given back by ansible-runner when running in serial (https://github.com/ansible-community/ara/issues/211)
-
1.5.5f4ec13a5 · ·
1.5.5 This is the 1.5.5 stable release of ara. Changes since 1.5.4: API --- - Added support for searching playbooks by ansible_version, for example: /api/v1/playbooks?ansible_version=2.10 UI -- - Added syntax highlighting to task results - Added support for rendering nested results for tasks with loops - Added support for rendering diffs provided by "ansible-playbook --diff" - Added support for searching playbooks by ansible_version - The playbook links in the index no longer filter to changed results - Ordering by date or duration no longer discards existing search arguments - Clicking on the logo or the "playbooks" link now discards existing search arguments CLI --- - Added support for searching playbooks by ansible_version - Added missing argument for --controller to "ara playbook metrics"
-
1.5.5rc2f4ec13a5 · ·
1.5.5rc2 This is the second release candidate for the 1.5.5 stable release of ara. There are no changes since rc1, this is for exercising release automation to pypi. Changes since 1.5.4: API --- - Added support for searching playbooks by ansible_version, for example: /api/v1/playbooks?ansible_version=2.10 UI -- - Added syntax highlighting to task results - Added support for rendering nested results for tasks with loops - Added support for rendering diffs provided by "ansible-playbook --diff" - Added support for searching playbooks by ansible_version - The playbook links in the index no longer filter to changed results - Ordering by date or duration no longer discards existing search arguments - Clicking on the logo or the "playbooks" link now discards existing search arguments CLI --- - Added support for searching playbooks by ansible_version - Added missing argument for --controller to "ara playbook metrics"
-
1.5.5rc1f4ec13a5 · ·
1.5.5rc1 This is the first release candidate for the 1.5.5 stable release of ara. Changes since 1.5.4: API --- - Added support for searching playbooks by ansible_version, for example: /api/v1/playbooks?ansible_version=2.10 UI -- - Added syntax highlighting to task results - Added support for rendering nested results for tasks with loops - Added support for rendering diffs provided by "ansible-playbook --diff" - Added support for searching playbooks by ansible_version - The playbook links in the index no longer filter to changed results - Ordering by date or duration no longer discards existing search arguments - Clicking on the logo or the "playbooks" link now discards existing search arguments CLI --- - Added support for searching playbooks by ansible_version - Added missing argument for --controller to "ara playbook metrics"
-
1.5.4f3da150e · ·
1.5.4 This is the 1.5.4 stable release of ara. Changes since 1.5.3: CLI --- New commands were added to the 'ara' CLI: - ara playbook metrics: provides stats aggregated by name, path, ansible version or controller - ara host metrics: provides task result stats for hosts across playbooks - ara task metrics: provides duration stats aggregated by task name, action/module or path Refer to the documentation for examples and more information on these commands: https://ara.readthedocs.io/en/latest/cli.html Callback plugin --------------- - Threading is now disabled by default to avoid running into sqlite locking contention For details, see: https://github.com/ansible-community/ara/issues/195 - The callback didn't provide a timezone for timestamps which could result in a wrong interpretation by the API server. Timestamps are now provided as UTC. Controller hostname ------------------- The hostname of the controller that ran the playbook is now recorded by ara. Playbooks can be filtered by controller in the UI as well as the API: /api/v1/playbooks?controller=localhost As well as with the CLI, for example: ara playbook list --controller=localhost ara playbook metrics --controller=localhost Container images ---------------- - ARA API server container images are now published to quay.io/recordsansible/ara-api in addition to hub.docker.com/r/recordsansible/ara-api. - Fedora 32 images were replaced by images based on Fedora 33 - The 'which' package is now installed as a dependency - Removed a temporary workaround for dynaconf switching from PyYAML to ruamel.yaml UI -- - Added missing information about the play when browsing details for a task result Upgrade notes ------------- The new controller hostname feature introduces a SQL migration to update the database schema. After upgrading, database migrations will need to be run at least once using 'ara-manage migrate'. Because the hostname was not previously saved and can't be recovered retroactively, playbooks that were recorded before the upgrade will have the controller set to 'localhost'.
-
1.5.4rc1f3da150e · ·
1.5.4rc1 This is the first release candidate for the 1.5.4 stable release of ara. Changes since 1.5.3: CLI --- New commands were added to the 'ara' CLI: - ara playbook metrics: provides stats aggregated by name, path, ansible version or controller - ara host metrics: provides task result stats for hosts across playbooks - ara task metrics: provides duration stats aggregated by task name, action/module or path Refer to the documentation for examples and more information on these commands: https://ara.readthedocs.io/en/latest/cli.html Callback plugin --------------- - Threading is now disabled by default to avoid running into sqlite locking contention For details, see: https://github.com/ansible-community/ara/issues/195 - The callback didn't provide a timezone for timestamps which could result in a wrong interpretation by the API server. Timestamps are now provided as UTC. Controller hostname ------------------- The hostname of the controller that ran the playbook is now recorded by ara. Playbooks can be filtered by controller in the UI as well as the API: /api/v1/playbooks?controller=localhost As well as with the CLI, for example: ara playbook list --controller=localhost ara playbook metrics --controller=localhost Container images ---------------- - ARA API server container images are now published to quay.io/recordsansible/ara-api in addition to hub.docker.com/r/recordsansible/ara-api. - Fedora 32 images were replaced by images based on Fedora 33 - The 'which' package is now installed as a dependency - Removed a temporary workaround for dynaconf switching from PyYAML to ruamel.yaml UI -- - Added missing information about the play when browsing details for a task result Upgrade notes ------------- The new controller hostname feature introduces a SQL migration to update the database schema. After upgrading, database migrations will need to be run at least once using 'ara-manage migrate'. Because the hostname was not previously saved and can't be recovered retroactively, playbooks that were recorded before the upgrade will have the controller set to 'localhost'.
-
1.5.23837b3b6 · ·
1.5.2 This is the 1.5.2 stable release of ARA. Changes since 1.5.1: Ansible callback plugin ----------------------- - Significant performance improvement by running non-blocking API calls in threads https://github.com/ansible-community/ara/issues/171 - Handler tasks are now also recorded in addition to regular tasks https://github.com/ansible-community/ara/issues/178 API --- - Add support for searching handler tasks (ex: /api/v1/tasks?handler=true) UI -- - Hosts in the playbook report are now sorted alphabetically by hostname - Added a column to display the number of tasks in the playbook summary
-
1.5.2rc13837b3b6 · ·
1.5.2rc1 This is the first release candidate for the 1.5.2 stable release of ARA. Changes since 1.5.1: Ansible callback plugin ----------------------- - Significant performance improvement by running non-blocking API calls in threads https://github.com/ansible-community/ara/issues/171 - Handler tasks are now also recorded in addition to regular tasks https://github.com/ansible-community/ara/issues/178 API --- - Add support for searching handler tasks (ex: /api/v1/tasks?handler=true) UI -- - Hosts in the playbook report are now sorted alphabetically by hostname - Added a column to display the number of tasks in the playbook summary