Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

OPSEXP-2424: update OS matrix #732

Merged
merged 3 commits into from
Dec 13, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 18 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,17 @@
# Alfresco Ansible Deployment

[![release](https://img.shields.io/github/v/release/Alfresco/alfresco-ansible-deployment?display_name=release)](https://github.com/Alfresco/alfresco-ansible-deployment/releases/latest) [![community](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/community.yml/badge.svg)](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/community.yml) [![enterprise](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/enteprise.yml/badge.svg)](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/enteprise.yml)
[![release](https://img.shields.io/github/v/release/Alfresco/alfresco-ansible-deployment?display_name=release)](https://github.com/Alfresco/alfresco-ansible-deployment/releases/latest)
[![community](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/community.yml/badge.svg)](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/community.yml)
[![enterprise](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/enteprise.yml/badge.svg)](https://github.com/Alfresco/alfresco-ansible-deployment/actions/workflows/enteprise.yml)

This project provides an [Ansible](https://www.ansible.com) playbook capable of deploying Alfresco Content Services (ACS).
This project provides an [Ansible](https://www.ansible.com) playbook capable of
deploying Alfresco Content Services (ACS).

Ansible is an open-source software provisioning, configuration management and application-deployment tool enabling infrastructure as code.
Ansible is an open-source software provisioning, configuration management and
application-deployment tool enabling infrastructure as code.

A user runs a playbook that deploys to any number of hosts as shown in the diagram below.
A user runs a playbook that deploys to any number of hosts as shown in the
diagram below.

![Ansible Overview](./docs/resources/ansible-overview.png)

Expand All @@ -16,21 +21,26 @@ A user runs a playbook that deploys to any number of hosts as shown in the diagr

## Documentation

Please refer to the [Documentation](./docs/README.md) for an overview of the project and the playbook or go directly to the [deployment guide](./docs/deployment-guide.md) to learn how to run the playbook.
Please refer to the [Documentation](./docs/README.md) for an overview of the
project and the playbook or go directly to the
[deployment guide](./docs/deployment-guide.md) to learn how to run the playbook.

Users upgrading from previous versions of the playbook may want to take a look to [Upgrade Notes](docs/playbook-upgrade.md).
Users upgrading from previous versions of the playbook may want to take a look
to [Upgrade Notes](docs/playbook-upgrade.md).

## Development

Developer's guide is available [here](docs/developer-guide.md).

## License

The code in this repository is released under the Apache License, see the [LICENSE](./LICENSE) file for details.
The code in this repository is released under the Apache License, see the
[LICENSE](./LICENSE) file for details.

## Contribution

Please use [this guide](CONTRIBUTING.md) to make a contribution to the project and information to report any issues.
Please use [this guide](CONTRIBUTING.md) to make a contribution to the project
and information to report any issues.

## Release

Expand Down
37 changes: 7 additions & 30 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,36 +60,13 @@ set of instructions.

## Versioning

While ACS supports a wide range of OS, the playbook is only known to work and is
supported for a subset of them. The table below gives detailed information on
the status of supported OS.

Legend:

* :white_check_mark: platform supported and tested on this playbook
* :x: platform not supported by this playbook (despite officially supported by Alfresco)
* `-` platform not officially supported by Alfresco

| OS Flavor / version | 23.1 Enterprise/Community | 7.4 Enterprise | 7.3 Enterprise | 7.2 Enterprise | 7.1 Enterprise | 7.0 Enterprise |
|---------------------|---------------------------|--------------------|--------------------|--------------------|--------------------|--------------------|
| Amazon Linux (v2) | :x: | :x: | :x: | :x: | :x: | :x: |
| Amazon Linux (v1) | :x: | :x: | :x: | :x: | :x: | :x: |
| RHEL 9.2 | :white_check_mark: | :x: | - | - | - | - |
| RHEL 8.7 | :white_check_mark: | :white_check_mark: | - | - | - | - |
| RHEL 8.6 | :white_check_mark: | :white_check_mark: | :white_check_mark: | - | - | - |
| RHEL 8.5 | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | - | - |
| RHEL 8.4 | - | - | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| RHEL 8.2 | - | - | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| RHEL 7.7 | - | - | - | - | :white_check_mark: | :white_check_mark: |
| RHEL 7.6 | - | - | - | - | :white_check_mark: | :white_check_mark: |
| Rockylinux 9.2 | :white_check_mark: | :x: | - | - | - | - |
| Rockylinux 8.7 | :white_check_mark: | :white_check_mark: | - | - | - | - |
| CentOS 7 x64 | :x: | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Ubuntu 22.04 | :white_check_mark: | :white_check_mark: | :white_check_mark: | - | - | - |
| Ubuntu 20.04 | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Ubuntu 18.04 | - | - | - | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| SUSE 15.0 | - | - | - | - | - | :x: |
| SUSE 12.0 SP1 x64 | - | - | - | - | - | :x: |
To understand which Operating System the Alfresco Ansible playbook can work
against (on the target nodes), please refer to the [Supported
platform doc](https://docs.alfresco.com/content-services/latest/support/) (pick
the right Alfresco version).

We aim to support these stacks **with the exception of** Amazon Linux & Suse
distributions.

> Ansible version used for testing this playbook can be retrieved [here](https://github.com/Alfresco/alfresco-ansible-deployment/blob/master/Pipfile#L7).

Expand Down
7 changes: 5 additions & 2 deletions docs/developer-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,8 +140,11 @@ We expect distribution support to be added using mostly roles `vars` files. If
distro specific tasks are needed those should be skipped for other distros
and possibly added in separate task files.

The OS support table in `docs/README.md` must be updates and so does the
`supported_os` variable in the `group_vars/all.yml` file.
New distributions must be added to the `supported_os` variable in the `group_vars/all.yml` file.

If a new OS enters the official supported matrix but is not supported by the
playbook. It must be mentioned in the [Versioning chapter of the
doc](./README.md#versioning)

## Release

Expand Down
6 changes: 6 additions & 0 deletions group_vars/all.yml
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,9 @@ supported_os:
RedHat:
versions:
- 9.2
- 9.1
- 9.0
- 8.8
- 8.7
- 8.6
- 8.5
Expand All @@ -94,6 +97,9 @@ supported_os:
Rocky:
versions:
- 9.2
- 9.1
- 9.0
- 8.8
alxgomz marked this conversation as resolved.
Show resolved Hide resolved
- 8.7
- 8.6
CentOS:
Expand Down