diff --git a/doc/changelog-release-notes.sh b/doc/changelog-release-notes.sh
new file mode 100755
index 00000000..df0d0a56
--- /dev/null
+++ b/doc/changelog-release-notes.sh
@@ -0,0 +1,46 @@
+#!/bin/bash
+# Copyright (c) 2020 The ARA Records Ansible authors
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+# Quick and dirty translation of release notes from git tags to rst format
+# $ ./changelog-release-notes.sh > source/changelog-release-notes.rst
+
+function header() {
+ echo "${1}"
+ characters=$(expr length "${1}")
+ printf '%0.s*' $(seq 1 $characters)
+ echo
+ echo
+}
+
+function smallheader() {
+ echo "${1}"
+ characters=$(expr length "${1}")
+ printf '%0.s#' $(seq 1 $characters)
+ echo
+ echo
+}
+
+echo ".."
+echo " note: generated through doc/changelog-release-notes.sh"
+echo
+
+header "Changelog and release notes"
+
+# Order the git repository tags by date, exclude alpha, beta and rc releases,
+# then reverse it so the most recent one is at the top instead.
+for tag in $(git tag -l --sort=creatordate | egrep -v "a|b|rc" | tac); do
+ tag_date=$(git log -1 --pretty='%ad' --date=format:'%Y-%m-%d' $tag)
+ smallheader "${tag} (${tag_date})"
+ echo "https://github.com/ansible-community/ara/releases/tag/${tag}"
+ echo
+ # Don't include a code-block if there's no message
+ length=$(git tag -n9001 $tag | tail -n +3 | wc -l)
+ if [ $length -gt 0 ]; then
+ echo ".. code-block:: text"
+ echo
+ # Remove the header from the output and strip one whitespace from the left
+ git tag -n9001 $tag | tail -n +3 | cut -c 1-
+ fi
+ echo
+done
diff --git a/doc/source/changelog-release-notes.rst b/doc/source/changelog-release-notes.rst
new file mode 100644
index 00000000..fb6e38b2
--- /dev/null
+++ b/doc/source/changelog-release-notes.rst
@@ -0,0 +1,1588 @@
+..
+ note: generated through doc/changelog-release-notes.sh
+
+Changelog and release notes
+***************************
+
+1.4.3 (2020-08-10)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.4.3
+
+.. code-block:: text
+
+ This is the 1.4.3 stable release of ARA.
+
+ The only change since 1.4.2 is an additional regression fix with the
+ latest version of dynaconf. For more information, see the issue:
+ https://github.com/ansible-community/ara/issues/149
+
+1.4.2 (2020-07-01)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.4.2
+
+.. code-block:: text
+
+ This is the 1.4.2 stable release of ARA.
+
+ This release comes sooner than expected in order to fix a regression when
+ installing ara with the latest version of dynaconf (3.0.0) due to a change in
+ the preferred yaml package.
+
+ For more information about this issue, see https://github.com/ansible-community/ara/issues/146
+
+ Built-in reporting interface
+ ----------------------------
+
+ - Improvements to the interface scaling and rendering for mobile devices
+ - The playbook index has been refactored from a list of cards to a table view
+ and searching/filtering controls are no longer hidden in a submenu
+ - Sorting by playbook date and duration is now built into the table headers
+ - The Ansible CLI arguments are now available from the playbook index
+ - The host stats summary now displays colors and icons for the different statuses
+ - Task result columns were re-ordered and statuses now have colors and icons
+ - Long task results or host facts should no longer render off-screen
+
+1.4.1 (2020-05-26)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.4.1
+
+.. code-block:: text
+
+ This is the 1.4.1 stable release of ARA.
+
+ Changes since 1.4.0:
+
+ Ansible Adhoc command recording
+ -------------------------------
+
+ It is now possible to record "ansible" commands in addition to the
+ existing support for "ansible-playbook" commands starting with Ansible
+ 2.9.7 and above.
+
+ To record Ansible adhoc commands, set 'bin_ansible_callbacks' to true in
+ your ansible.cfg or run: export ANSIBLE_LOAD_CALLBACK_PLUGINS=true
+
+ API
+ ---
+
+ - Added search for ignore_errors in results:
+ /api/v1/results?status=failed # includes "ignore_errors: true"
+ /api/v1/results?status=failed&ignore_errors=false
+
+ - Added search for task by action:
+ /api/v1/tasks?action=package
+ /api/v1/tasks?action=command
+
+ - Adjusted search for file paths to be partial:
+ /api/v1/files?path=/home/user/ansible/roles/foo/tasks/main.yaml
+ /api/v1/files?path=foo
+
+ - Added search for task by path:
+ /api/v1/tasks?path=/home/user/ansible/roles/foo/tasks/main.yaml
+ /api/v1/tasks?path=foo
+
+ - Fixed an error 500 when querying playbooks with labels
+
+ Built-in UI
+ -----------
+
+ - The path to the playbooks that are displayed when no names are given
+ by "ara_playbook_name" are now truncated from the left rather than
+ from the right. For example, given:
+ /home/user/git/source/organization/repo/playbooks/prod/restart-everything.yaml
+
+ Before:
+ /home/user/git/source/organization/repo/playbooks/...
+ After:
+ ...zation/repo/playbooks/prod/restart-everything.yaml
+
+ Container images
+ ----------------
+
+ The project now publishes simple container images suitable for use with sqlite,
+ mysql and postgresql database backends out of the box.
+
+ The images are currently available on Docker Hub:
+ https://hub.docker.com/r/recordsansible/ara-api
+
+ You can learn about how the images are built, how you can build
+ your own and how you can run them in the documentation:
+ https://ara.readthedocs.io/en/latest/container-images.html
+
+1.4.0 (2020-04-16)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.4.0
+
+.. code-block:: text
+
+ This is the 1.4.0 stable release of ARA.
+
+ Changes since 1.3.2:
+
+ API
+ ---
+
+ - Added support for searching plays, tasks and hosts by name
+ - Added support for searching playbooks by label
+ - Fixed label representation to be consistent through different calls
+ - Reversed the default sort order for playbooks, plays, tasks and results
+
+ API server
+ ----------
+
+ - Validate that settings.yaml (or ARA_SETTINGS) exists before launching (thank you @zswanson!)
+ - Template the default settings file without objects generated by python-box
+
+ Bundled reporting interface
+ ---------------------------
+
+ - Added a default robots.txt to prevent crawling
+ - Added support for searching by label
+ - Improved the display of labels in the playbook list
+ - Added pagination support when browsing the playbook report list
+ - Use relative links for pagination (thank you @flowerysong !)
+ - Bumped included patternfly CSS from 2.21.5 to 2.56.3
+
+ ara_api Ansible role
+ ------------
+
+ - Provide sensible PATH defaults when virtualenvs are not used
+ - Added support for installing from Fedora packages
+ - Only run SQL migrations once when necessary
+ - Allow retries when attempting to run SQL migrations
+ - Ensure settings.yaml permissions are 0640
+ - Added "ara_api_secure_logging" variable to control behavior of sensitive tasks with no_log
+ - Properly default to IPv6 when no IPv4 is available
+ - Default gunicorn worker count based on number of available CPU cores
+ - Added support for deploying on EL8
+
+ Ansible plugins
+ ---------------
+
+ - New Ansible plugins: ara_playbook and ara_api
+ - Improved consistency of stored task results (thank you @flowerysong!)
+ - Fix bad logic when determining if labels should be updated
+ - Added support for not saving files based on patterns (thank you @LaurentDumont!)
+ - Added support for specifying default playbook labels
+
+ Integration tests
+ -----------------
+
+ - Refactored integration tests to simplify and improve coverage across different
+ database backends, linux distributions and versions of Ansible
+
+ Upgrade notes
+ -------------
+
+ - 1.4 introduces a new SQL migration to ensure labels are unique. If upgrading
+ from a previous version, you will need to run SQL migrations with ``ara-manage migrate``.
+
+0.16.7 (2020-04-14)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.7
+
+.. code-block:: text
+
+ 0.16.7 is a maintenance release for ARA 0.x.
+
+ Changes since 0.16.6:
+
+ - Fix typo in ara.setup.env for ANSIBLE_ACTION_PLUGINS [1]
+ - Pin pyfakefs to <4 in order to avoid breaking python2 usage [2]
+ - Pin junit-xml to <=1.8 in order to avoid deprecation warnings in unit tests
+
+ ARA 0.x end of life
+ -------------------
+
+ The code base for ARA 0.x has not been actively maintained and developed
+ since 2018 and will officially reach end of life June 4th, 2019, one year
+ after the release of ARA 1.0.
+
+ Unless critical bugs are found between this release and June 4th, 0.16.7
+ will be the last supported release of the 0.x branch.
+
+ Please use the latest version of ARA to benefit from the
+ new features and fixes.
+
+ [1]: https://github.com/ansible-community/ara/pull/97
+ [2]: https://github.com/ansible-community/ara/issues/118
+
+1.3.2 (2019-12-12)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.3.2
+
+.. code-block:: text
+
+ This is the 1.3.2 stable release of ARA.
+
+ Changes since 1.3.1:
+
+ - Fix compatibility with the new version of
+ django-rest-framework, 3.11 [1]
+
+ [1]: https://github.com/ansible-community/ara/issues/102
+
+1.3.1 (2019-12-06)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.3.1
+
+.. code-block:: text
+
+ This is the 1.3.1 stable release of ARA.
+
+ Changes since 1.3.0:
+
+ - bugfix: the callback plugin now properly retrieves host facts for
+ both setup and gather_fact tasks
+ - bugfix: fixed a typo in ara.setup.env which set the
+ ANSIBLE_ACTION_PLUGINS to the callback directory instead of the
+ action module directory.
+ - unit tests: use assertLogs instead of patch_logger since
+ patch_logger was removed from django 3.
+ - misc: bumped versions of Ansible used in integration tests
+
+1.3.0 (2019-12-03)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.3.0
+
+.. code-block:: text
+
+ This is the 1.3.0 stable release of ARA.
+
+ Changes since 1.2.0:
+
+ General
+ -------
+
+ - Removed hard requirement on python 3.6 due to the usage of f-strings.
+ ARA should also work on python 3.5 now.
+
+ Web user interface
+ ------------------
+
+ - Added a tab at the top of the playbook list to search, sort and filter by date
+ - Search can be based on the playbook's name, path, or status
+ - Sort can be ascending or descending for start date, end date or duration
+ - Filter can show playbooks in the last 60 minutes, 24 hours, 7 days or 30 days
+ - Fixed a bad link to the task file in the detailed result view
+
+ API
+ ---
+
+ - Added support for searching date fields for playbooks, plays, tasks and results [1]
+ For example:
+
+ /api/v1/playbooks?started_before=2019-10-01T09:57:36.489016
+ /api/v1/results?created_after=2019-10-01T09:57:36.489016
+
+ - The duration of items is now calculated and stored in the database model
+ instead of being calculated on demand by the API. This provides the ability to
+ easily sort objects based on their duration.
+ A SQL migration has been added as a result of this change.
+
+ - Added support for ordering objects by most fields [2]
+ For example:
+
+ /api/v1/playbooks?order=id (ascending, oldest first)
+ /api/v1/playbooks?order=-id (descending, most recent first)
+
+ The currently supported fields available for sorting are:
+ - created
+ - updated
+ - started (for playbooks, plays, tasks, results)
+ - ended (for playbooks plays, tasks, results)
+ - duration (for playbooks, plays, tasks, results)
+ - path (for files)
+ - key (for records)
+ - ok, skipped, changed, failed and unreachable (for hosts)
+
+ - Added support for searching playbooks by their full path or only part of it.
+ For example, a playbook with the path ``/home/user/ansible/playbook.yml``
+ can be found by searching for either ``user`` or the full path.
+
+ - Searching for playbook names now also supports partial search.
+
+ - Improved handling of non-ascii/binary output to prevent UnicodeEncodeError
+ exceptions [3]
+
+ - Standardized the search by status for playbooks, plays, tasks and results
+
+ - The built-in development server now checks if psycopg2 or mysqlclient are
+ installed before launching when using the postgresql or mysql database backend. [4]
+
+ API client
+ ----------
+
+ - Added support for ignoring SSL verification [5]
+
+ Plugins
+ -------
+
+ - Added the ``ARA_API_INSECURE`` setting to the callback plugin to ignore SSL
+ verification.
+
+ CLI
+ ---
+
+ - Added an ``ara-manage prune`` command to delete playbooks older than a specified
+ amount of days. [6]
+
+ Documentation
+ -------------
+
+ - Refreshed docs on installation
+ - First iteration of documentation for the ``ara-manage`` commands
+ - Docs now require the API server dependencies to be installed so CLI snippets
+ can be included automatically with sphinxcontrib-programoutput.
+
+ Upgrade notes
+ -------------
+
+ - 1.3.0 introduces a new SQL migration to move durations from the API to the
+ database model. If upgrading from a previous version, you will need to run
+ SQL migrations with ``ara-manage migrate``.
+
+ Referenced or fixed issues
+ --------------------------
+
+ [1]: https://github.com/ansible-community/ara/issues/30
+ [2]: https://github.com/ansible-community/ara/issues/68
+ [3]: https://github.com/ansible-community/ara/issues/48
+ [4]: https://github.com/ansible-community/ara/issues/63
+ [5]: https://github.com/ansible-community/ara/issues/90
+ [6]: https://github.com/ansible-community/ara/issues/31
+
+0.16.6 (2019-11-18)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.6
+
+.. code-block:: text
+
+ 0.16.6 is a maintenance release for ARA 0.x.
+
+ Changes since 0.16.5:
+
+ - Fixed web application crash due to encoding/decoding of binary
+ non-ascii content in task results
+ - The sqlite middleware was adapted to support running under gunicorn.
+ - ``python -m ara.setup.env`` now returns commands that use bash expansion to
+ take into account existing environment variables
+
+ Eventual end of life for ARA 0.x
+ --------------------------------
+
+ All new feature and development effort for more than a year has been spent on
+ the master branch of ARA which is the basis of version 1.x releases.
+
+ Users are encouraged to try the latest release of ARA and create an issue on
+ GitHub if they encounter any issues or missing features.
+
+ ARA 0.16.6 could be the last release of ARA 0.x if no major issues are found.
+
+1.2.0 (2019-10-25)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.2.0
+
+.. code-block:: text
+
+ This is the 1.2.0 stable release of ARA.
+
+ Changes since 1.1.0:
+
+ New bundled reporting interface
+ -------------------------------
+
+ - A new simple built-in web reporting interface is now bundled with the API server
+ - The simple web reporting interface can be exported to static html with ``ara-manage generate <path>``
+
+ API
+ ---
+
+ - An ``items`` field was added to playbook, plays and task objects to display the number of child references
+ - The task file path is now available as task.path
+ - Playbook labels as well as ansible_version are now always provided for playbook objects
+ - The "created" and "updated" fields are now provided when querying a host list
+
+ Settings
+ --------
+
+ - New setting to control the timezone used for storing and displaying data: ``ARA_TIME_ZONE``
+ - New setting to provide a list of regex patterns for whitelisting CORS: ``ARA_CORS_ORIGIN_REGEX_WHITELIST``
+ - The default for ``ARA_DISTRIBUTED_SQLITE_PREFIX`` was changed from /ara-api to /ara-report
+
+ Other changes
+ -------------
+
+ - Significant performance improvements by reducing the amount of API calls to host and file endpoints by the callback plugin during playbook execution
+ - A basic healthcheck has been implemented at ``/healthcheck/`` to allow simple monitoring of the interface and database connection
+ - ``python -m ara.setup.env`` now returns commands that use bash expansion to take into account existing environment variables
+ - The API clients will strip trailing slashes if they are provided in the endpoints
+ - Removed a needless newline when generating the default settings.yaml file
+
+ Upgrade notes
+ -------------
+
+ The new healthcheck feature adds a dependency on the django-health-check library
+ and includes a SQL migration that needs to be run before it can be used.
+ SQL migrations can be executed by running ``ara-manage migrate``.
+
+1.1.0 (2019-06-14)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.1.0
+
+.. code-block:: text
+
+ Changes since 1.0.1:
+ - Added support for dynamically serving multiple sqlite databases
+ dynamically from a single API server instance [1]
+ - ara_record no longer instanciates it's own API client and will
+ instead retrieve the client instance used by the callback.
+ - Django's CONN_MAX_AGE database setting for configuring the
+ duration of a database connection is now exposed [2]
+ - The ARA API client timeout as configured by Ansible through the
+ callback plugin is now always an integer.
+ - The offline API client now has an argument to prevent SQL
+ migrations from running automatically [3]
+
+ For the ara_api Ansible role [4]:
+ - The role no longer attempts to set up and manage a PID file when
+ setting up a persistent service running with gunicorn.
+ - The bundled selinux policy file for running out of a user's home
+ directory has been updated and is now integration tested.
+ - Added support and integration tests for deploying Django with the
+ MySQL backend
+
+ [1]: https://ara.readthedocs.io/en/latest/distributed-sqlite-backend.html
+ [2]: https://ara.readthedocs.io/en/latest/api-configuration.html#ara-database-conn-max-age
+ [3]: https://ara.readthedocs.io/en/latest/api-usage.html#ara-offline-api-client
+ [4]: https://ara.readthedocs.io/en/latest/ansible-role-ara-api.html
+
+0.16.5 (2019-06-04)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.5
+
+.. code-block:: text
+
+ Changes since 0.16.4:
+
+ - Updated references to the master git branch or documentation
+ now that 0.x development work has been moved to stable/0.x
+
+1.0.1 (2019-06-05)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.0.1
+
+.. code-block:: text
+
+ Changes since 1.0.0:
+
+ - Updated references to the feature/1.0 git branch or documentation
+ now that 1.0 development work has been moved to master
+ - Fixed an issue preventing the HTTP API client from being used unless
+ the server dependencies had been installed.
+ - Added support for customizing the amount of results per page returned
+ by the API with ARA_PAGE_SIZE [1]
+ - The ara_api role now sets up a basic selinux policy when running
+ gunicorn out of a home directory on Red Hat based systems.
+
+ [1]: https://ara.readthedocs.io/en/latest/api-configuration.html#ara-page-size
+
+1.0.0 (2019-06-03)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/1.0.0
+
+.. code-block:: text
+
+ This is the first release of ARA on top of a new framework and API,
+ dubbed version 1.0.
+
+ This new release marks the deprecation of ARA 0.x and while full feature parity
+ has not yet been achieved, we are moving forward and we will iterate to add
+ missing features in future releases.
+
+ Main changes from ARA 0.x:
+
+ - The backend has been re-written from Flask to Django/Django-rest-framework
+ - A new API as well as built-in API clients are available to record and query playbook results
+ - The project's dependencies have been decoupled: the Ansible plugins, API backend and web interface can be installed independently from one another
+ - The web interface has been re-written as a standalone project -- ara-web: https://github.com/ansible-community/ara-web
+
+ In summary, all the different components before 1.0, including the web interface,
+ would communicate directly with the database model.
+
+ After 1.0, these components communicate with the new REST API which results in
+ easier development, maintenance and integration.
+
+0.16.4 (2019-05-22)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.4
+
+.. code-block:: text
+
+ This is a stable release of ARA, 0.16.4.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, is
+ currently in beta and is not backwards compatible with ARA 0.x.
+ In order to avoid upgrading unexpectedly when 1.0 is released,
+ we recommend pinning ara to <1.0.0 in your scripts and requirements.
+ ***
+
+ Changelog since 0.16.3:
+ - Fixed a regression when saving tasks with Ansible 2.8 [1]
+
+ [1]: https://github.com/ansible-community/ara/issues/46
+
+0.16.3 (2019-01-21)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.3
+
+.. code-block:: text
+
+ This is a stable release of ARA, 0.16.3.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL database schema.
+ ***
+
+ Changelog:
+ - Update integration tests to target latest versions of Ansible (2.7.6,
+ 2.6.12 and 2.5.14)
+ - Adjust how CLI options are saved to support the upcoming release of
+ Ansible, 2.8.
+
+0.16.2 (2018-12-31)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.2
+
+.. code-block:: text
+
+ This is the newest stable release of ARA, 0.16.2.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL database schema.
+ ***
+
+ This release comes thanks to bug fixes contributed by the community:
+
+ - Jonathan Herlin fixed the deprecation notice "Call to deprecated
+ function CreateFile. Use create_file instead." when generating HTML
+ reports.
+ - Sorin Sbarnea addressed testing warnings and made it so future
+ warnings would be considered as errors
+ - Sorin Sbarnea removed integration testing for the "static: no"
+ argument from Ansible includes since this parameter has been removed
+ from Ansible after being deprecated.
+
+0.16.1 (2018-09-04)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.1
+
+.. code-block:: text
+
+ This is the newest stable release of ARA, 0.16.1.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL database schema.
+ ***
+
+ This is a hotfix release to address a bug in host facts sanitization
+ with the introduction of the "ARA_IGNORE_FACTS" feature in 0.16.0.
+ While task results were properly sanitized, host facts were not.
+
+ 0.16.1 addresses the issue by sanitizing both host facts and task
+ results.
+
+0.16.0 (2018-08-27)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.16.0
+
+.. code-block:: text
+
+ This is the newest stable release of ARA, 0.16.0.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL database schema.
+ ***
+
+ This release of ARA is made possible thanks to the following contributions:
+
+ - Tristan de Cacqueray from Red Hat resolved an issue where under certain
+ circumstances, an empty ARA_LOG_FILE configuration could raise an exception.
+ - Artem Goncharov from Open Telekom Cloud resolved an issue where configuration
+ parameters through environment variables could not taken into account
+ properly when using the ara-wsgi and ara-wsgi-sqlite scripts.
+ - Joshua Harlow from GoDaddy submitted several improvements to performance and
+ RAM usage when browsing large reports.
+ - Sorin Sbarnea from Red Hat contributed documentation on serving static ARA
+ reports with nginx and improved the junit export to allow for overrides
+ - Haikel Guemar from Red Hat identified and fixed usage of reserved key words
+ in Python 3.7
+ - Robert de Bock for suggesting a security improvement around host facts
+ and the ansible_env fact.
+
+ Other improvements include:
+
+ - Improve self-healing when running into a race condition where the playbook
+ run is interrupted early enough for the playbook to be created in the
+ database but before it's file was saved.
+ - Prevent ARA's logging configuration from "leaking" into the configuration
+ of other python modules at runtime.
+ - Add a trailing slash to file links in the file tab, resolving an issue
+ where reverse proxies might get confused when doing SSL termination.
+
+ Security:
+
+ Robert de Bock from ING Bank reported that sensitive information might
+ be stored in environment variables from the Ansible control node and
+ that as such, there should be a way to prevent the 'ansible_env' host
+ fact from being recorded by ARA.
+
+ As such, we have added a new configuration parameter: ARA_IGNORE_FACTS [1].
+ ARA_IGNORE_FACTS is a comma-separated list of host facts that ARA will not
+ record in it's database.
+ ARA will also sanitize the output of gather_facts and setup tasks to prevent
+ these facts from displaying in the task results.
+ By default, only the "ansible_env" fact is ignored due to the high likelihood
+ of it containing sensitive information.
+
+ Maintenance:
+
+ - Dropped backwards compatibility layer for supporting Ansible 2.3
+ - Updated integration jobs to test against the latest versions of Ansible 2.4,
+ 2.5 and 2.6
+
+ [1]: https://ara.readthedocs.io/en/latest/configuration.html#ara-ignore-facts
+
+0.15.0 (2018-05-01)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.15.0
+
+.. code-block:: text
+
+ This is the newest stable release of ARA, 0.15.0.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL database schema.
+ ***
+
+ Changelog:
+
+ - ARA: Ansible Run Analysis has been "rebranded" to ARA Records Ansible
+ (Another Recursive Acronym)
+ - Significant improvements to memory usage and performance when running ARA as
+ a WSGI application with 'ara-wsgi' or 'ara-wsgi-sqlite'.
+ - Resolved an issue where the 'ara-wsgi-sqlite' middleware could serve a
+ cached report instead of the requested one
+ - Added support for configuring the 'SQLALCHEMY_POOL_SIZE',
+ 'SQLALCHEMY_POOL_TIMEOUT' and 'SQLALCHEMY_POOL_RECYCLE' parameters.
+ See the configuration documentation [1] for more details.
+ - Logging was fixed and improved to provide better insight when in DEBUG level.
+ - Vastly improved the default logging configuration.
+ ARA will create a default logging configuration file in '~/.ara/logging.yml'
+ that you can customize, if need be. Deleting this file will make ARA create
+ a new one with updated defaults.
+ - Added python modules to help configure Ansible to use ARA, for example,
+ 'python -m ara.setup.callback_plugins' will print the path to ARA's callback
+ plugins.
+ You can find more examples in the configuration documentation. [1]
+ - Implemented a workaround for fixing a race condition where an
+ 'ansible-playbook' command may be interrupted after the playbook was recorded
+ in the database but before playbook file was saved.
+ - Flask 0.12.3 was blacklisted from ARA's requirements [2], this was a broken
+ release.
+ - The ARA CLI can now be called with "python -m ara" if you need to specify a
+ specific python interpreter, for example.
+ - Updated and improved integration tests across different operating systems,
+ python2 and python3 with different versions of Ansible. The full test matrix
+ is available in the README. [3].
+
+ [1]: https://ara.readthedocs.io/en/stable/configuration.html
+ [2]: https://github.com/openstack/ara/commit/87272840bfc8b4c5db10593e47884e33a0f4af40
+ [3]: https://github.com/openstack/ara#contributing-testing-issues-and-bugs
+
+0.14.6 (2018-02-04)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.14.6
+
+.. code-block:: text
+
+ This is a maintenance release for the stable version of ARA.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL schema.
+ Please see this blog post [1] for details.
+ ***
+
+ Changelog:
+ - Unit and integration changes improvements
+ - Workaround an issue where Ansible could sometimes return a non-boolean
+ value for the "ignore_errors" field.
+
+ [1]: https://dmsimard.com/2017/11/22/status-update-ara-1.0/
+
+0.14.5 (2017-10-26)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.14.5
+
+.. code-block:: text
+
+ This is a release for the version 0.14.5 of ARA.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL schema.
+ Please see this blog post [1] for details.
+ ***
+
+ This version notably fixes an issue when using ansible.cfg to
+ configure ARA when using Ansible 2.4.0.
+ 0.14.5 is meant to be used with Ansible 2.4.1 and using it with Ansible
+ 2.4.0 is not recommended because it does not contain a necessary bugfix [2].
+
+ Changelog:
+ - ARA can be configured through an ansible.cfg file with Ansible 2.4.1.
+ - Ansible 2.4.0 is blacklisted in requirements.txt
+ - Added a WSGI middleware to load sqlite databases at variable locations
+ for advanced large-scale usage. See documentation [1] for details.
+ - Resolved an issue when clicking on permalink icons (blue chain links)
+ on Firefox. (Thanks Mohammed Naser)
+
+ [1]: http://ara.readthedocs.io/en/latest/advanced.html#serving-ara-sqlite-databases-over-http
+ [2]: https://github.com/ansible/ansible/pull/31200
+
+0.14.4 (2017-09-19)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.14.4
+
+.. code-block:: text
+
+ 0.14.4 adds Ansible 2.4 support for ARA.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL schema.
+ Please see this blog post [1] for details.
+ ***
+
+ Changelog:
+ - Add support for Ansible 2.4
+
+0.14.3 (2017-09-15)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.14.3
+
+.. code-block:: text
+
+ 0.14.3 is a minor bugfix release for ARA.
+ Note that ARA does not yet support Ansible 2.4.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL schema.
+ Please see this blog post [1] for details.
+ ***
+
+ Changelog:
+ - Bugfix: 'include_role' tasks with 'static: no' are now handled properly
+ (See Ansible issue: https://github.com/ansible/ansible/issues/30385 )
+ - Backport from 1.0: 404 not found errors when generating static reports will
+ now be ignored as they are non-fatal.
+ - Ansible was pinned to <2.4, ARA does not yet support Ansible 2.4.
+ - Pygments was pinned to >=1.6, prior versions did not have the required
+ JSONLexer methods.
+ - Flask was pinned to >=0.11, prior versions did not provide the
+ flask_logging.DEBUG_LOG_OUTPUT variable. The version prior to 0.11 was released
+ in 2013.
+
+0.14.2 (2017-08-29)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.14.2
+
+.. code-block:: text
+
+ Bugfix: "logging.config" also needed to be imported for
+ the new file configuration option to work properly.
+
+0.14.1 (2017-08-27)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.14.1
+
+.. code-block:: text
+
+ 0.14.1 is a minor bugfix release for ARA.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL schema.
+ Please see this blog post [1] for details.
+ ***
+
+ Changelog:
+ - Bugfix: Implicit tasks with no specific file and task
+ information provided by Ansible (such as "gather_facts")
+ now resolve back to the playbook file by default. See upstream
+ Ansible bug [2] for details.
+
+ - Feature: Logging for ARA and it's components can now be done
+ through a logging configuration file [3].
+
+ - Integration tests on Fedora 26 with python3.6 were
+ added to the existing tests under CentOS 7 and
+ Ubuntu 16.04.
+
+ [1]: https://dmsimard.com/2017/08/16/whats-coming-in-ara-1.0/
+ [2]: https://github.com/ansible/ansible/issues/28451
+ [3]: https://ara.readthedocs.io/en/latest/configuration.html#ara-log-config
+
+0.14.0 (2017-07-31)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.14.0
+
+.. code-block:: text
+
+ 0.14.0 is a major release for ARA which brings significant changes
+ and introduces full Python 3 support with Ansible 2.3.x.
+
+ ***
+ WARNING: Please note that the next major version of ARA, 1.0, will contain
+ backwards incompatible changes due to significant refactor work
+ involving core back end code as well as the SQL schema.
+ ***
+
+ Changelog for 0.14.0 (up from 0.13.3):
+
+ New features:
+ - Python 3 now works and is supported
+ - All unit and integration tests are passing on python 3
+ - New code contributions to ARA are simultaneously gated against py2
+ and py3 tests to avoid regressions
+ - Added the 'ara generate subunit' [1] command in order to export playbook
+ run data to the subunit format
+
+ Improvements:
+ - Host facts, task results and records display has been improved with
+ highlighting where appropriate
+ - Addressed a backwards database schema relationship between files and
+ tasks (no migration required)
+
+ Updates and deprecations:
+ - Flask has been unpinned from 0.11.1 (latest release is currently 0.12.2)
+ - Ansible 2.1.x is no longer supported (end of life and out of support upstream as well)
+ - A regression in unit tests was fixed in order to allow us to unpin Pytest
+
+ Docs:
+ - Improve FAQ on what versions of Ansible are supported [2]
+ - Added a FAQ on the status of Python 3 support [3]
+
+ Misc:
+ - Preliminary work in order to support the upcoming release of Ansible (2.4)
+ - ARA has been relicensed from Apache 2.0 to GPLv3 to simplify it's
+ relationship with Ansible which is itself GPLv3. Rationale behind the
+ change is available in the commit [4]
+
+ Special thanks
+ - Lars Kellogg-Stedman for help on python 3 and database schema troubleshooting
+ - Jesse Pretorius for contributing support for Subunit generation
+
+ [1]: https://ara.readthedocs.io/en/latest/usage.html#generating-a-static-subunit-version-of-the-task-results
+ [2]: https://ara.readthedocs.io/en/latest/faq.html#what-versions-of-ansible-are-supported
+ [3]: https://ara.readthedocs.io/en/latest/faq.html#does-ara-support-running-on-python-3
+ [4]: https://review.openstack.org/#/c/486733/
+
+0.13.3 (2017-06-30)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.13.3
+
+.. code-block:: text
+
+ This release addresses a regression introduced in 0.13.2
+ where files would no longer be displayed correctly and would
+ instead show raw HTML.
+
+0.13.2 (2017-06-22)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.13.2
+
+.. code-block:: text
+
+ This is a minor feature/bugfix release for ARA.
+
+ Changelog:
+ - Security: Use the 'escape' jinja2 filter instead of the
+ 'safe' filter to escape potentially problematic HTML
+ characters and prevent them from being interpreted.
+
+ - ara_record can now be used as a standalone task outside
+ the context of a playbook run to, for example, record data
+ on a playbook run that has already been completed.
+ An example use case is to attach the ansible-playbook run
+ stdout as a record of the playbook [1][2].
+ More details is available in the documentation [3].
+
+ - ara_record now returns the equivalent of ara_read when
+ registering the task where ara_record runs. This avoids
+ needing to run ara_read if you don't need to.
+
+ Misc:
+ - Unit test fixes after the release of Ansible 2.3.1
+ - Work and testing against Ansible Devel (unreleased 2.4) has started
+
+ [1]: https://github.com/openstack/ara/blob/a72ece2e7ab69cd4e2882ba207152703b2bc0a90/run_tests.sh#L95-L96
+ [2]: https://github.com/openstack/ara/blob/a72ece2e7ab69cd4e2882ba207152703b2bc0a90/run_tests.sh#L130
+ [3]: http://ara.readthedocs.io/en/latest/usage.html#using-the-ara-record-module
+
+0.13.1 (2017-05-21)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.13.1
+
+.. code-block:: text
+
+ This is a minor release to fix the warning that Alembic
+ 0.9.2 started introducing during SQL migrations.
+
+ The "About" page has also been improved.
+
+0.13.0 (2017-05-04)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.13.0
+
+.. code-block:: text
+
+ ARA 0.13.0 marks a new major release for ARA, dropping deprecations
+ and modifying your database schema with automated migrations.
+
+ Please read the release notes and back up your database just in
+ case before upgrading.
+
+ General / UI
+ ============
+ - The home page has been relocated to "about" and the default home
+ page is now the report list.
+ - Playbooks reports now have permanent links.
+ Use the blue chain icon on the left hand side of the report list.
+ - Host facts, files and task results now have permanent links.
+ Use the blue chain icon on the top right of the popups.
+ - Note: Permanent links have slightly grown the weight and amount
+ of files generated in a static report but has no significant impact on
+ generation time.
+ - Browsing tips have been improved and folded into "?" tooltips
+ inside each panel.
+ - The file panel was improved to show a file browser interface
+ instead of a file list.
+ - There is a new panel, "Parameters", which contains all parameters
+ used as part of your ansible-playbook commands.
+ - Role names are now included when recording task results, this means
+ you can now search for the role name in your task result list.
+ - Task tags are now included when recording task results, this means
+ you can now search for the tag name in your task result list.
+ - Task results that are provided from a loop (ex: with_items) are now
+ properly saved and displayed.
+ Note that an upstream Ansible issue can make it so the last item in a
+ loop is someetimes not saved (Ansible issue #24207)
+ - There has been some level of performance improvements which may
+ be more noticeable on larger deployments.
+ - Fixed an issue where tooltips would sometime not display properly
+ in the hosts table.
+ - Fixed an issue that would cause "include" tasks to be recorded and
+ displayed twice by ARA on Ansible >= 2.2.
+ - External CSS and JS libraries are no longer bundled with ARA and
+ we now used packaged versions with python-XStatic.
+ - The UI has been resized a bit in general to be less of a problem on
+ larger resolutions (>=1920px wide)
+
+ Configuration
+ =============
+ - New parameter: ARA_HOST to select the host to bind on default
+ with the embedded development web server. (Defaults to '127.0.0.1')
+ - New parameter: ARA_PORT to select the port on which the
+ embedded development web server will listen on. (Defaults to '9191')
+ - The embedded development web server will now use threads by
+ default, improving performance significantly.
+ - New parameter: ARA_IGNORE_PARAMETERS to avoid saving
+ potentially sensitive data when recording ansible-playbook command
+ line parameters. (Defaults to 'extra_vars')
+
+ Database
+ ========
+ - There is a new SQL migration to provide the necessary schema for
+ ansible metadata (ansible-playbook parameters) as well as task tags.
+ - Fixed a bad migration statement for a column in the table 'data'
+
+ Deprecations and removals
+ =========================
+ - The command "ara generate" has been removed, it was deprecated
+ and replaced by "ara generate html" in ARA 0.11.
+ - The URLs under /playbook/ have been removed, they were deprecated
+ and redirected to the new playbook reports page in ARA 0.12.
+
+ Distribution packaging and unbundling
+ =====================================
+ ARA no longer carries in-tree external CSS and JS libraries (jquery,
+ jquery-datatables, patternfly, patternfly-bootstrap-treeview, bootstrap).
+ For that effort:
+ - We've packaged and created new packages on PyPi for missing
+ python-XStatic libraries: patternfly, patternfly-bootstrap-treeview
+ - We've updated the python-XStatic package for jquery-datatables on
+ PyPi
+
+ ARA 0.13 will be the first version to be packaged for RHEL-derivative
+ distributions. For that effort we've packaged new packages for Fedora
+ and EPEL:
+ - python-xstatic-patternfly
+ - python-xstatic-patternfly-bootstrap-treeview
+ - python-xstatic-datatables
+ - python-pyfakefs
+
+0.12.5 (2017-04-19)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.12.5
+
+.. code-block:: text
+
+ 0.12.5 is a small maintenance release.
+
+ Changelog:
+ - Fix encoding/decoding issues when using non-ascii characters
+ in playbooks and improve integration testing for this kind of
+ problem.
+ - The full playbook path is no longer printed in the table.
+ The playbook path turned out to be too long and truncated most of
+ the time. Only the file name is shown now. The full path is still
+ available in the tooltip when hovering over the playbook file name.
+ - Improved performance for the reports page, especially when viewing
+ playbook runs with a larger amount of data.
+ - Considerably reduced package/module size on disk
+
+0.12.4 (2017-04-01)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.12.4
+
+.. code-block:: text
+
+ 0.12.4 is primarily a maintenance/bugfix release.
+
+ Callback changes:
+ - Task results as recorded by ARA are now "filtered" by Ansible's
+ _dump_results method [1]. This will only be effective on task recording
+ moving forward, it will not edit previously recorded playbooks.
+ The _dump_results method strips Ansible 'internal' keys (_ansible_*)
+ from the task results and also respects the 'no_log: yes' task directive.
+ Prior to this change, ARA did not respect the no_log directive and
+ recorded the raw task results as well as all the Ansible internal keys.
+ Task results should be cleaner now and be properly censored when using
+ 'no_log'.
+ This ultimately results in what is hopefully less unnecessary things
+ in the task results and the net effect should be positive.
+
+ Internal changes:
+ - Refactor of ARA's configuration module to fix issues in order to properly
+ detect configuration parameters like booleans or lists. This refactor
+ also brings cleaner backwards and forwards compatibility from Ansible 2.1
+ through 2.3.
+ - Fixed issue to prevent PBR from throwing exceptions when overriding the
+ version
+ - Different changes in both the CLI and the testing framework in order to
+ bootstrap and teardown the application properly to prevent context from
+ leaking where it shouldn't be
+
+ UI changes:
+ - Javascript datatables in the UI where most of the content is displayed
+ will now throw warnings in the background (javascript console) rather
+ than in the foreground (javascript alert). These warnings are fairly
+ expected, especially in the case of incomplete or interrupted playbooks.
+ - Adjust wording when notifying users about a playbook that is incomplete
+ or was interrupted to make it more straightforward
+ - Performance improvements on the home and reports page, more optimization
+ will follow in the future.
+ - Fixed an odd problem where certain webservers (ex: nginx) would not behave
+ well for the statically generated version of the reports.
+
+ CLI changes:
+ - The "ara generate html" command will now suppress
+ "MissingURLGeneratorWarning" warnings by default. A new configuration
+ parameter 'ignore_empty_generation' was introduced to revert back to
+ the previous behavior. For context on this change, see the commit [2].
+ - Alembic messages that are not related to migrations are now sent to the
+ background.
+
+ Database:
+ - Fix PosgreSQL support, add documentation for using it it and provide
+ instructions for integration testing it
+
+ Documentation:
+ - The project now has a manifesto [3] to express in writing the project's core
+ values and philosophy
+ - Improved contributor documentation
+ - Added a FAQ on running the ARA callback and the web application on
+ different machines
+
+ [1]: https://github.com/ansible/ansible/blob/b3251c9585b0b0180fcdf09748e9a0dc439bc1aa/lib/ansible/plugins/callback/__init__.py
+ [2]: http://git.openstack.org/cgit/openstack/ara/commit/?id=440dac3789ca12c50f63a89850a7e65c1ac93789
+ [3]: http://ara.readthedocs.io/en/latest/manifesto.html
+
+0.12.3 (2017-03-09)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.12.3
+
+.. code-block:: text
+
+ This is a bugfix release for the 0.12 series.
+ It includes two fixes for the data and tooltips in the
+ host panel to display properly.
+
+0.12.2 (2017-03-06)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.12.2
+
+.. code-block:: text
+
+ This is a minor release that aims to significantly improve
+ web application performance on large scale deployments of
+ ARA, tested against hundreds of playbooks composed of hundreds
+ of thousands of tasks, task results and files.
+
+ This is achieved by deferring the bulk of the data loading
+ and processing to AJAX calls in the background.
+
+0.12.1 (2017-03-03)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.12.1
+
+.. code-block:: text
+
+ This is a small bugfix release to ensure pages from
+ pagination can be detected as html mimetype.
+
+0.12.0 (2017-02-24)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.12.0
+
+.. code-block:: text
+
+ This is a major release which features a complete
+ rewrite of the web application interface.
+
+ The home page now highlights the data recorded by ARA
+ and the core of the UI now revolves around the one and
+ single playbook reports page.
+
+ There were three main objectives with this UI work:
+ - Improve UX (ex: being able to search, find & sort things easily
+ * Everything is now searchable and sortable
+ * Browsing tips have been added to help users get the most out
+ of the interface features
+
+ - Improve scalability and performance: the interface should be
+ fast and easy to browse whether you have dozens or thousands
+ of hosts and tasks
+ * Every result list or table are now paginated
+ * You can customize pagination preferences with the
+ ARA_PLAYBOOK_PER_PAGE and ARA_RESULT_PER_PAGE
+ configuration parameters.
+
+ - Improve static generation time and weight
+ Examples of the same data sets before and after:
+ * ARA integration tests (5 playbooks, 59 tasks, 69 results):
+ * Before: 5.4 seconds, 1.6MB (gzipped), 217 files
+ * After: 2 seconds, 1.2MB (gzipped), 119 files
+ * OpenStack-Ansible (1 playbook, 1547 tasks, 1667 results):
+ * Before: 6m21 seconds, 31MB (gzipped), 3710 files
+ * After: 20 seconds, 8.9MB (gzipped), 1916 files
+
+ Other features and fixes include:
+ - First party WSGI support [1]
+ - Fixed syntax highlighting support when viewing files
+ - Preparations for supporting the upcoming Ansible 2.3 release
+ - Preparations for full python 3 support
+ - Various performance improvements
+
+ Misc:
+ - Jinja HTML templates are now fully indented with no regards
+ to line length or PEP8 to privilege readability over long and
+ nested content.
+ - Added some missing web application unit tests
+ - Various javascript and css optimizations
+ - The web application backend in itself was significantly
+ simplified: less routes, less templates, less code
+ - Added a configuration parameter ARA_PLAYBOOK_PER_PAGE which
+ controls the amount of playbooks per page in the playbook
+ report list.
+ - Added a configuration parameter ARA_RESULT_PER_PAGE which
+ controls the amount of results per page in the data results
+ table (such as hosts, plays and tasks).
+
+ Known issues:
+ - The file list table in the file panel will eventually
+ be replaced by a folder/file hierarchy tree
+
+ [1]: http://ara.readthedocs.io/en/latest/webserver.html
+
+0.11.0 (2017-02-13)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.11.0
+
+.. code-block:: text
+
+ - New feature: ARA UI and Ansible version (ARA UI is running with)
+ are now shown at the top right
+ - New feature: The Ansible version a playbook was run is now stored
+ and displayed in the playbook reports
+ - New feature: New command: "ara generate junit": generates a junit
+ xml stream of all task results
+ - New feature: ara_record now supports two new types: "list" and "dict",
+ each rendered appropriately in the UI
+ - UI: Add ARA logo and favicon
+ - UI: Left navigation bar was removed (top navigation bar will be
+ further improved in future versions)
+ - Bugfix: CLI commands could sometimes fail when trying to format
+ as JSON or YAML
+ - Bugfix: Database and logs now properly default to ARA_DIR if ARA_DIR
+ is changed
+ - Bugfix: When using non-ascii characters (ex: äëö) in playbook files,
+ web application or static generation could fail
+ - Bugfix: Trying to use ara_record to record non strings
+ (ex: lists or dicts) could fail
+ - Bugfix: Ansible config: 'tmppath' is now a 'type_value' instead of a
+ boolean
+ - Deprecation: The "ara generate" command was deprecated and moved to
+ "ara generate html"
+ - Deprecation: The deprecated callback location, ara/callback has been
+ removed. Use ara/plugins/callbacks.
+ - Misc: Various unit and integration testing coverage improvements and
+ optimization
+ - Misc: Slowly started working on full python 3 compatibility
+
+0.10.5 (2017-01-16)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.10.5
+
+.. code-block:: text
+
+ Ansible 2.2.1.0 shipped with a hard dependency on Jinja2 < 2.9 [1].
+ Since Flask has a requirement on Jinja2 >= 2.4, it would pick up
+ 2.9.4 first and then disregard Ansible's requirement.
+
+ [1]: https://github.com/ansible/ansible/commit/6c6570583f6e74521e3a4f95fe42ffddb69634fe
+
+0.10.4 (2017-01-14)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.10.4
+
+.. code-block:: text
+
+ New feature:
+
+ - Playbook lists now have an icon to display their
+ status, whether it has been completed or not
+ and if it has been successful or not.
+
+ Bug fixes/maintenance:
+
+ - Fix SyntaxError when creating ARA directory
+ under Python3
+ - Update static patternfly assets to 3.17.0
+ - Fixed some bad logic in integration tests in order
+ to properly test different versions of Ansible
+
+0.10.3 (2016-12-12)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.10.3
+
+.. code-block:: text
+
+ This is a minor release that continues ongoing efforts
+ to streamline some things in order to package ARA for
+ linux distributions.
+
+ Flask-Testing is no longer a dependency and tests have
+ been rewritten accordingly.
+
+0.10.2 (2016-12-10)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.10.2
+
+.. code-block:: text
+
+ This is a minor release to streamline some things in
+ order to package ARA for linux distributions.
+
+ - pymysql is no longer installed by default
+ - tests are now shipped inside the module
+ - misc fixes (pep8, bandit)
+
+0.10.1 (2016-12-05)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.10.1
+
+.. code-block:: text
+
+ This is a bugfix release that resolves an issue that made
+ it impossible to use MySQL (and potentially other RDBMS).
+
+ For more details, see commit [1].
+
+ [1]: https://git.openstack.org/cgit/openstack/ara/commit/?id=dd159df4f0c152d28455fedf6c6f1e0b56cd7350
+
+0.10.0 (2016-12-01)
+###################
+
+https://github.com/ansible-community/ara/releases/tag/0.10.0
+
+.. code-block:: text
+
+ This is a major release.
+ For the full list of changes between 0.9.3 and 0.10.0, please
+ view the list of commits on GitHub [1].
+
+ Summary:
+ - Database schema is now stable and automatically migrated.
+ Databases created on >= 0.9.0 are supported.
+ - Significant web interface improvements
+ - New built-in Ansible modules: ara_record and ara_read for
+ recording arbitrary data with ARA
+ - Improved unit and integration testing coverage
+
+ [1]: https://github.com/openstack/ara/compare/0.9.3...0.10.0
+
+0.9.3 (2016-11-14)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.9.3
+
+
+0.9.2 (2016-10-22)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.9.2
+
+.. code-block:: text
+
+ This is a maintenance release.
+
+ - Update static assets to their latest versions
+ (Patternfly, Flask, etc.)
+ - The location of the callback has been changed from
+ ara/callback to ara/plugins/callbacks/. The previous
+ location has been deprecated and will be removed in
+ a future version.
+ - Bugfix: The home link in the navigation now behaves
+ more as expected and redirect to the root of the web
+ application rather than the root of the domain or
+ filesystem.
+ - Misc: Integration test coverage improvements
+
+0.9.1 (2016-09-15)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.9.1
+
+.. code-block:: text
+
+ - Introduced a parameter (defaulting to true) to hide warnings
+ introduced in 0.9.0 that are safe to ignore.
+
+0.9.0 (2016-08-12)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.9.0
+
+.. code-block:: text
+
+ - ARA is now hosted by the OpenStack project community infrastructure.
+ - ARA's source code is now available at:
+ https://git.openstack.org/cgit/openstack/ara
+ or mirrored at
+ https://github.com/openstack/ara
+ - Submitting patches is now done through OpenStack's Gerrit
+ system.
+ Documentation on how to contribute is available at
+ http://ara.readthedocs.io/en/latest/contributing.html
+ - Unit and integration testing is no longer done through
+ Travis but instead by OpenStack Zuul testing infrastructure.
+
+ - UI Revamp: First implementation
+ This is the first release in which lands a first implementation of
+ a large UI revamp with the Patternfly [1] CSS framework. There are
+ some small issues and quirks but we will iterate in order to fix
+ them.
+
+ - Playbook file storage
+ ARA now stores a unique, zipped copy of playbook files allowing you
+ to see the content of your task files as they ran in a particular
+ ansible-playbook run. The UI leverages that feature and also provides
+ a direct link with line highlight to show where a particular action
+ took place.
+
+ [1]: https://www.patternfly.org/
+
+0.8.1 (2016-06-03)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.8.1
+
+.. code-block:: text
+
+ This reverts commit 00673c1cf231dbd3058ca187295e67e39f6c9fff.
+ 2.1 has a regression [1] that breaks ARA and 2.0.2.0 had other
+ regressions we are not interested in.
+
+ [1]: https://github.com/ansible/ansible/issues/16125
+
+0.8.0 (2016-06-02)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.8.0
+
+.. code-block:: text
+
+ stop catching bare Exceptions
+
+0.7.1 (2016-05-30)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.7.1
+
+.. code-block:: text
+
+ Temporarily pin flask
+
+0.7.0 (2016-05-27)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.7.0
+
+.. code-block:: text
+
+ Try really hard to pretty print json-looking results
+
+0.6.0 (2016-05-21)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.6.0
+
+
+0.5.2 (2016-05-18)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.5.2
+
+
+0.5.1 (2016-05-17)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.5.1
+
+.. code-block:: text
+
+ iterate over results containing multiple items
+
+0.5.0 (2016-05-14)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.5.0
+
+.. code-block:: text
+
+ Merge development work
+
+0.4.0 (2016-05-10)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.4.0
+
+
+0.3.1 (2016-05-09)
+##################
+
+https://github.com/ansible-community/ara/releases/tag/0.3.1
+
+.. code-block:: text
+
+ This isn't a proper configuration file yet but will allow to
+ transition toward that goal while improving configurability with
+ very low effort.
+
+0.3 (2016-05-09)
+################
+
+https://github.com/ansible-community/ara/releases/tag/0.3
+
+.. code-block:: text
+
+ - Properly support browsing multiple playbook runs in /playbook
+ - Add run info at the top
+ - Minor tweaks to models, effectively just add foreign keys on
+ playbook_uuid for sanity
+
+0.2 (2016-05-09)
+################
+
+https://github.com/ansible-community/ara/releases/tag/0.2
+
+
+0.1 (2016-05-08)
+################
+
+https://github.com/ansible-community/ara/releases/tag/0.1
+
+
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 12e4c127..89d78a76 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -20,3 +20,4 @@ Table of Contents
CLI: ara and ara-manage <cli>
Contributing to ARA <contributing>
Frequently asked questions <faq>
+ Changelog and release notes <changelog-release-notes>