Add blog post for release of 1.0

Change-Id: I5bf345c50ea688931dc1a410e6f683bba6a00da4
This commit is contained in:
David Moreau Simard 2019-06-03 16:57:35 -04:00
parent f8329ebad0
commit bcbc6d1bad
No known key found for this signature in database
GPG Key ID: CBEB466764A9E621
2 changed files with 89 additions and 0 deletions

View File

@ -0,0 +1,89 @@
---
author: "David Moreau Simard"
categories:
- news
tags:
- ansible
date: 2019-06-04
title: "Announcing the release of ARA Records Ansible 1.0"
slug: announcing-the-release-of-ara-records-ansible-1.0
type: post
---
After more than three years since the creation of the project, we are excited
to announce that the version 1.0 of ARA Records Ansible is now available.
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.
# Want to try it out ?
If you want a quick start, you can have a look at the
[README](https://github.com/ansible-community/ara/tree/feature/1.0#quickstart)
or there is otherwise plenty of documentation available to get started:
- [Frequently asked questions](https://ara.readthedocs.io/en/feature-1.0/faq.html)
- [Installing ARA](https://ara.readthedocs.io/en/feature-1.0/installation.html)
- [Configuring Ansible to use ARA](https://ara.readthedocs.io/en/feature-1.0/ansible-configuration.html)
- [Configuring the ARA Ansible plugins](https://ara.readthedocs.io/en/feature-1.0/ara-plugin-configuration.html)
- [Customizing the API server configuration](https://ara.readthedocs.io/en/feature-1.0/api-configuration.html)
- [Setting up authentication and security considerations](https://ara.readthedocs.io/en/feature-1.0/api-security.html)
- [API endpoint documentation and object relationships](https://ara.readthedocs.io/en/feature-1.0/api-documentation.html)
- [How to use the API with the built-in API clients](https://ara.readthedocs.io/en/feature-1.0/api-usage.html)
You might also want to take a look at ARA features such as
[playbook names and labels](https://ara.readthedocs.io/en/feature-1.0/playbook-names-and-labels.html)
and the [ara_record action module to record arbitrary data](https://ara.readthedocs.io/en/feature-1.0/ara-record.html).
There are even built-in Ansible roles to help you set up an API server as well
as the new web interface:
- [ansible-role-ara-api](https://ara.readthedocs.io/en/feature-1.0/ansible-role-ara-api.html)
- [ansible-role-ara-web](https://ara.readthedocs.io/en/feature-1.0/ansible-role-ara-web.html)
In fact, these roles are the ones used to deploy the live demos on
[api.demo.recordsansible.org](https://api.demo.recordsansible.org/) and
[web.demo.recordsansible.org](https://web.demo.recordsansible.org/):
![live-demo-playbook](live-demo-playbook.png)
You'll find the Ansible roles in the [source repository](https://github.com/ansible-community/ara/tree/feature/1.0/roles).
# What comes after 1.0
In the near future, what is now the default master branch in the ara git
repository will be relocated to stable/0.x and future dot releases to ARA 0.x,
if necessary, will be tagged from that branch.
The feature/1.0 branch will be relocated to the master branch and will be where
development will happen moving forward.
A similar switch will happen for the documentation on
[ara.readthedocs.org](https://ara.readthedocs.org) where the default
documentation will now be for 1.0 and the 0.x documentation will remain available.
Afterwards, the plan is to keep iterating on ara as well as ara-web and resume
a regular pace of release.
# Questions ? Issues ? Feedback ?
Please reach out !
You can find us on [IRC and Slack](https://ara.recordsansible.org/community/)
and issues are tracked on GitHub for both
[ara](https://github.com/ansible-community/ara/issues) and
[ara-web](https://github.com/ansible-community/ara-web/issues).

Binary file not shown.

After

Width:  |  Height:  |  Size: 96 KiB