Tags: ansible-community/ara
Tags
1.7.4 1.7.4 is a feature release for ara's web UI and includes a fix for using Django 5.2.x with MariaDB. Changes since 1.7.3: https://codeberg.org/ansible-community/ara/compare/1.7.3...1.7.4 Server ------ Django 5.0 changed how uuid fields (for plays and tasks) are managed with MariaDB. The models have been updated and a new migration was added accordingly. See upgrade notes. UI --- - Loading or refreshing a page using the light theme should no longer flicker - The playbook header at the top of a playbook report has been redesigned for clarity and mobile responsiveness - The hosts, files and records sections have received similar treatment - The recorded files are now displayed inside a file hierarchy browser - When ``gather_facts: true``, ara will now display a dashboard including (but not limited to): - load average, memory and disk usage - uptime, OS, kernel and python version - network interfaces - It is still possible to access the raw host facts and a search box has been added Client ------- - Include the HTTP error code when logging about an API error Container images ------------- - Bumped fedora images to 43 Tests -------- - Maintenance for ansible-core 2.19/2.10 compatibility For ara's own tests, written in ansible. ara already worked with 2.19 and 2.20. - Bumped tests up to fedora-43, debian-13 and ansible-core 2.20 - Improved how codeberg CI results are sent to demo.recordsansible.org Upgrade notes ------------------ Update the version of ara and restart the server if one is running. Then, a new SQL migration takes care of the compatibility for Django 5.2 with MariaDB. As always, take a backup of the database and run ``ara-manage migrate`` after updating ara where the server runs from. It is largely no-op and runs quickly, even on large databases. ara 1.7.4 is expected to be the last version to support python3.8.
1.7.4rc1 1.7.4 is a feature release for ara's web UI and includes a fix for using Django 5.2.x with MariaDB. This is the first release candidate. Changes since 1.7.3: https://codeberg.org/ansible-community/ara/compare/1.7.3...1.7.4rc1 Server ------ Django 5.0 changed how uuid fields (for plays and tasks) are managed with MariaDB. The models have been updated and a new migration was added accordingly. See upgrade notes. UI --- - Loading or refreshing a page using the light theme should no longer flicker - The playbook header at the top of a playbook report has been redesigned for clarity and mobile responsiveness - The hosts, files and records sections have received similar treatment - The recorded files are now displayed inside a file hierarchy browser - When ``gather_facts: true``, ara will now display a dashboard including (but not limited to): - load average, memory and disk usage - uptime, OS, kernel and python version - network interfaces - It is still possible to access the raw host facts and a search box has been added Client ------- - Include the HTTP error code when logging about an API error Container images ------------- - Bumped fedora images to 43 Tests -------- - Maintenance for ansible-core 2.19/2.10 compatibility For ara's own tests, written in ansible. ara already worked with 2.19 and 2.20. - Bumped tests up to fedora-43, debian-13 and ansible-core 2.20 - Improved how codeberg CI results are sent to demo.recordsansible.org Upgrade notes ------------------ Update the version of ara and restart the server if one is running. Then, a new SQL migration takes care of the compatibility for Django 5.2 with MariaDB. As always, take a backup of the database and run ``ara-manage migrate`` after updating ara where the server runs from. It is largely no-op and runs quickly, even on large databases. ara 1.7.4 is expected to be the last version to support python3.8.
1.7.3 1.7.3 is a maintenance release which adds a few new features. It includes minor changes as a result of the project migration from GitHub to Codeberg. The source repository now lives at: https://codeberg.org/ansible-community/ara The repository on GitHub remains as a mirror for now. Changes since 1.7.2: Server ------ - Added tzdata/zoneinfo to server requirements for compatibility across versions of python and django - Bumped the minimum version of django LTS from 3.2 to 4.2 (up to 5.2) UI -- - Added an auto refresh arrow at the top right, allowing automatic refreshes of the pages at the selected duration - Clicking on the number of hosts for a playbook on the playbooks page should now correctly display the results for each host of that playbook API client ---------- - Avoid using ARA_API_USERNAME and ARA_API_PASSWORD if they are set to empty values Callback -------- - Added support for specifying 'all' to ARA_IGNORED_FACTS to prevent ara from recording any host facts New action plugin: ara_label ---------------------------- This new module provides the ability to manipulate ara's labels on playbooks. Excerpt from the documentation: ``` - name: Add a static label to this playbook (the one that is running) # Note: By default Ansible will run this task on every host. # Consider the use case and declare 'run_once: true' when there is no need to # run this task more than once. # This might sound obvious but it avoids updating the same labels 100 times # if there are 100 hosts, incurring a performance penalty needlessly. run_once: true ara_label: state: present labels: - state:running - name: Add dynamically templated labels to this playbook ara_label: state: present labels: - "git:{{ lookup('git -C {{ playbook_dir }} rev-parse HEAD') }}" - "os:{{ ansible_distribution }}-{{ ansible_distribution_version }}" - name: Add labels to a specific playbook ara_label: state: present playbook_id: 1 labels: - state:deployed - name: Remove labels from the running playbook (if they exist) ara_label: state: absent labels: - state:running ``` Maintenance ----------- - Completed migration from GitHub to Codeberg (links, CI jobs, etc.) - Bumped CI and container images to Fedora 41 - Bumped CI to the latest versions of ansible (11) and ansible-core (2.18) Docs ---- - Stop using sphinx's get_html_theme_path since it's been deprecated - Updated contributor documentation to mention Codeberg - Included a high level overview of how CI jobs work and what they do Upgrade Notes ------------- - There are no known migrations, deprecations or backwards-incompatible changes in this release. - ara 1.7.3 is expected to be the last release supporting python3.8.
1.7.3rc3
This is the third release candidate for the 1.7.3 stable release of ara.
1.7.3 is a maintenance release which adds a few new features.
Changes since 1.7.2:
Server
------
- Added tzdata/zoneinfo to server requirements for compatibility across versions of python and django
- Bumped the minimum version of django from 3.2 to 4.2 (up to 5.2)
UI
--
- Added an auto refresh arrow at the top right, allowing automatic refreshes of the pages at the selected duration
- Clicking on the number of hosts for a playbook on the playbooks page should now correctly display the results
for each host of that playbook
API client
----------
- Avoid using ARA_API_USERNAME and ARA_API_PASSWORD if they are set to
empty values
Callback
--------
- Added support for specifying 'all' to ARA_IGNORED_FACTS to prevent ara from recording any host facts
New action plugin: ara_label
----------------------------
This new module provides the ability to manipulate ara's labels on playbooks.
Excerpt from the documentation:
```
- name: Add a static label to this playbook (the one that is running)
# Note: By default Ansible will run this task on every host.
# Consider the use case and declare 'run_once: true' when there is no need to
# run this task more than once.
# This might sound obvious but it avoids updating the same labels 100 times
# if there are 100 hosts, incurring a performance penalty needlessly.
run_once: true
ara_label:
state: present
labels:
- state:running
- name: Add dynamically templated labels to this playbook
ara_label:
state: present
labels:
- "git:{{ lookup('git -C {{ playbook_dir }} rev-parse HEAD') }}"
- "os:{{ ansible_distribution }}-{{ ansible_distribution_version }}"
- name: Add labels to a specific playbook
ara_label:
state: present
playbook_id: 1
labels:
- state:deployed
- name: Remove labels from the running playbook (if they exist)
ara_label:
state: absent
labels:
- state:running
```
Maintenance
-----------
- Completed migration from GitHub to Codeberg (links, CI jobs, etc.)
- Bumped CI and container images to Fedora 41
- Bumped CI to the latest versions of ansible (11) and ansible-core (2.18)
- Docs: Stop using deprecated usage of get_html_theme_path
Docs
----
- Updated contributor documentation to mention Codeberg
- Included a high level overview of how CI jobs work and what they do
Upgrade Notes
-------------
- There are no known migrations, deprecations or backwards-incompatible changes in this release.
1.7.3rc2
This is the second release candidate for the 1.7.3 stable release of ara.
1.7.3 is a maintenance release which adds a few new features.
Changes since 1.7.2:
Server
------
- Added tzdata to django server requirements
- Bumped the minimum version of django from 3.2 to 4.2 (up to 5.2)
UI
--
- Added an auto refresh arrow at the top right, allowing automatic refreshes of the pages at the selected duration
- Clicking on the number of hosts for a playbook on the playbooks page should now correctly display the results
for each host of that playbook
API client
----------
- Avoid using ARA_API_USERNAME and ARA_API_PASSWORD if they are set to
empty values
Callback
--------
- Added support for specifying 'all' to ARA_IGNORED_FACTS to prevent ara from recording any host facts
New action plugin: ara_label
----------------------------
This new module provides the ability to manipulate ara's labels on playbooks.
Excerpt from the documentation:
```
- name: Add a static label to this playbook (the one that is running)
# Note: By default Ansible will run this task on every host.
# Consider the use case and declare 'run_once: true' when there is no need to
# run this task more than once.
# This might sound obvious but it avoids updating the same labels 100 times
# if there are 100 hosts, incurring a performance penalty needlessly.
run_once: true
ara_label:
state: present
labels:
- state:running
- name: Add dynamically templated labels to this playbook
ara_label:
state: present
labels:
- "git:{{ lookup('git -C {{ playbook_dir }} rev-parse HEAD') }}"
- "os:{{ ansible_distribution }}-{{ ansible_distribution_version }}"
- name: Add labels to a specific playbook
ara_label:
state: present
playbook_id: 1
labels:
- state:deployed
- name: Remove labels from the running playbook (if they exist)
ara_label:
state: absent
labels:
- state:running
```
Maintenance
-----------
- Completed migration from GitHub to Codeberg (links, CI jobs, etc.)
- Bumped CI and container images to Fedora 41
- Bumped CI to the latest versions of ansible (11) and ansible-core (2.18)
- Docs: Stop using deprecated usage of get_html_theme_path
Docs
----
- Updated contributor documentation to mention Codeberg
- Included a high level overview of how CI jobs work and what they do
Upgrade Notes
-------------
- There are no known migrations, deprecations or backwards-incompatible changes in this release.
1.7.3rc1
This is the first release candidate for the 1.7.3 stable release of ara.
1.7.3 is a maintenance release which adds a few new features.
Changes since 1.7.2:
Server
------
- Added tzdata to django server requirements
UI
--
- Added an auto refresh arrow at the top right, allowing automatic refreshes of the pages at the selected duration
Callback
--------
- Added support for specifying 'all' to ARA_IGNORED_FACTS to prevent ara from recording any host facts
New action plugin: ara_label
----------------------------
This new module provides the ability to manipulate ara's labels on playbooks.
Excerpt from the documentation:
```
- name: Add a static label to this playbook (the one that is running)
# Note: By default Ansible will run this task on every host.
# Consider the use case and declare 'run_once: true' when there is no need to
# run this task more than once.
# This might sound obvious but it avoids updating the same labels 100 times
# if there are 100 hosts, incurring a performance penalty needlessly.
run_once: true
ara_label:
state: present
labels:
- state:running
- name: Add dynamically templated labels to this playbook
ara_label:
state: present
labels:
- "git:{{ lookup('git -C {{ playbook_dir }} rev-parse HEAD') }}"
- "os:{{ ansible_distribution }}-{{ ansible_distribution_version }}"
- name: Add labels to a specific playbook
ara_label:
state: present
playbook_id: 1
labels:
- state:deployed
- name: Remove labels from the running playbook (if they exist)
ara_label:
state: absent
labels:
- state:running
```
Maintenance
-----------
- Bumped CI and container images to Fedora 41
- Bumped CI to the latest versions of ansible (11) and ansible-core (2.18)
- Docs: Stop using deprecated usage of get_html_theme_path
Upgrade Notes
-------------
- There are no migrations, deprecations or backwards-incompatible changes in this release.
Notes
-----
- With the new release of Django 5.2 LTS, the next release of ara (1.8.0) is expected
to bump the django requirement from `>=3.2,<4.3` to `>=4.2,<5.3`.
The python requirement will remain `>=3.8`.
- ara 1.7.3 will be the last release made from https://github.com/ansible-community/ara.
The project is moving to Codeberg: https://codeberg.io/ansible-community/ara.
This does not change the availability of releases on PyPi, Docker Hub or Quay.io.
1.7.2 This is the 1.7.2 stable release of ara. 1.7.2 is a maintenance and bugfix release that includes a few new features. Changes since 1.7.1: UI -- - When recording diffs, properly format and display the "prepared" key for the modules that use it (apt, git, cli_config and others) - Sorting task results by duration when browsing playbook results works once again - Updated bootstrap css from 5.3.0 to 5.3.3 Callback plugin --------------- - Catch SIGINT and SIGTERM signals resulting in the interruption of playbooks to set the status of the playbook to "expired" instead of keeping it running forever unless expired with `ara playbook expire` from the CLI. API Client ---------- - Add support for UTF-8 encoded usernames and passwords Docs ---- - Add .readthedocs.yaml to fix broken documentation builds - Formally include ara as a dependency in order to include --help commands in the docs - Added an introduction page Maintenance and packaging ------------------------- - Made dependency on ruamel.yaml explicit rather than implicit - Update usage of logging.warn to logging.warning for python 3.13 - Updated versions of Ansible tested in CI to Ansible 10 and ansible-core 2.17 Upgrade notes ------------- There are no API changes or SQL migrations in this release.
1.7.2rc2 This is the second release candidate for the 1.7.2 stable release of ara. 1.7.2 is a maintenance and bugfix release that includes a few new features. Changes since 1.7.1: UI -- - When recording diffs, properly format and display the "prepared" key for the modules that use it (apt, git, cli_config and others) - Sorting task results by duration when browsing playbook results works once again - Updated bootstrap css from 5.3.0 to 5.3.3 Callback plugin --------------- - Catch SIGINT and SIGTERM signals resulting in the interruption of playbooks to set the status of the playbook to "expired" instead of keeping it running forever unless expired with `ara playbook expire` from the CLI. API Client ---------- - Add support for UTF-8 encoded usernames and passwords Docs ---- - Add .readthedocs.yaml to fix broken documentation builds - Formally include ara as a dependency in order to include --help commands in the docs - Added an introduction page Maintenance and packaging ------------------------- - Made dependency on ruamel.yaml explicit rather than implicit - Update usage of logging.warn to logging.warning for python 3.13 - Updated versions of Ansible tested in CI to Ansible 10 and ansible-core 2.17 Upgrade notes ------------- There are no API changes or SQL migrations in this release.
1.7.2rc1 This is the first release candidate for the 1.7.2 stable release of ara. 1.7.2 is a maintenance and bugfix release that includes a few new features. Changes since 1.7.1: UI -- - When recording diffs, properly format and display the "prepared" key for the modules that use it (apt, git, cli_config and others) - Sorting task results by duration when browsing playbook results works once again - Updated bootstrap css from 5.3.0 to 5.3.3 Callback plugin --------------- - Catch SIGINT and SIGTERM signals resulting in the interruption of playbooks to set the status of the playbook to "expired" instead of keeping it running forever unless expired with `ara playbook expire` from the CLI. Docs ---- - Add .readthedocs.yaml to fix broken documentation builds - Formally include ara as a dependency in order to include --help commands in the docs - Added an introduction page Maintenance and packaging ------------------------- - Made dependency on ruamel.yaml explicit rather than implicit - Update usage of logging.warn to logging.warning for python 3.13 - Updated versions of Ansible tested in CI to Ansible 10 and ansible-core 2.17 Upgrade notes ------------- There are no API changes or SQL migrations in this release.
1.7.1 This is the 1.7.1 stable release of ara. 1.7.1 is a maintenance release that features minor bug fixes. Changes since 1.7.0: - Address deprecation of yaml.dump in ruamel.yaml when generating the default server settings.yaml file (#524) - Don't use setuptools/pkg_resources to retrieve the version of ara since it is not always installed by default. - Bumped the version of ansible, ansible-core and fedora used in Zuul CI jobs.
PreviousNext