Skip to content

Commit

Permalink
Bump readme and stack patches
Browse files Browse the repository at this point in the history
  • Loading branch information
gionn committed Dec 3, 2024
1 parent 6e2775a commit 29ce7ca
Show file tree
Hide file tree
Showing 5 changed files with 54 additions and 40 deletions.
4 changes: 2 additions & 2 deletions 7.2.N-extra-vars.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,9 @@ dependencies_version:
postgresql_connector: 42.6.1
postgres_major_version: 13
activemq: 5.16.7
java: 11.0.23
java: 11.0.25
java_build: 9
tomcat: 9.0.91
tomcat: 9.0.97
libreoffice: 7.2.5.1
pdf_renderer: 1.1
imagemagick: 7.1.0-16-ci-10
4 changes: 2 additions & 2 deletions 7.3.N-extra-vars.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,9 @@ dependencies_version:
postgresql_connector: 42.6.1
postgres_major_version: 13
activemq: 5.17.6
java: 11.0.23
java: 11.0.25
java_build: 9
tomcat: 9.0.91
tomcat: 9.0.97
libreoffice: 7.2.5.1
pdf_renderer: 1.1
imagemagick: 7.1.0-16-ci-10
6 changes: 3 additions & 3 deletions 7.4.N-extra-vars.yml
Original file line number Diff line number Diff line change
Expand Up @@ -59,9 +59,9 @@ dependencies_version:
postgresql_connector: 42.6.1
postgres_major_version: 14
activemq: 5.17.6
java: 17.0.11
java_build: 9
tomcat: 9.0.91
java: 17.0.13
java_build: 11
tomcat: 9.0.97
libreoffice: 7.2.5.1
pdf_renderer: 1.1
imagemagick: 7.1.0-16-ci-10
72 changes: 43 additions & 29 deletions docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,17 +9,27 @@ This page provides an overview of Ansible, the project structure and the compone

## Ansible Overview

[Ansible](https://www.ansible.com/overview/how-ansible-works) models your IT infrastructure by describing how all of your systems inter-relate, rather than just managing one system at a time.
[Ansible](https://www.ansible.com/overview/how-ansible-works) models your IT
infrastructure by describing how all of your systems inter-relate, rather than
just managing one system at a time.

It doesn't use any agents nor additional custom security infrastructure, so it's easy to deploy - and most importantly, it uses a very simple language, YAML, in the form of Ansible Playbooks that allow you to describe your automation jobs in a way that approaches plain English.
It doesn't use any agents nor additional custom security infrastructure, so it's
easy to deploy - and most importantly, it uses a very simple language, YAML, in
the form of Ansible Playbooks that allow you to describe your automation jobs in
a way that approaches plain English.

An Ansible playbook contains one or more roles. A role is an independent component which allows reuse of common configuration steps. It consists of a set of tasks used to configure a host to serve a certain purpose, for example, configuring a service. This is depicted in the diagram below.
An Ansible playbook contains one or more roles. A role is an independent
component which allows reuse of common configuration steps. It consists of a set
of tasks used to configure a host to serve a certain purpose, for example,
configuring a service. This is depicted in the diagram below.

Roles are defined using YAML files with a predefined directory structure.

A role directory structure contains directories: defaults, vars, tasks, files, templates, meta, and handlers.
A role directory structure contains directories: defaults, vars, tasks, files,
templates, meta, and handlers.

* **defaults** contains default variables for the role. Variables in defaults have the lowest priority so they are easy to override
* **defaults** contains default variables for the role. Variables in defaults
have the lowest priority so they are easy to override
* **vars** contains variables for the role. Variables in vars have higher priority than variables in the defaults directory
* **tasks** contains the main list of steps to be executed by the role
* **files** contains files which we want to be copied to the remote host. We don’t need to specify a path of resources stored in this directory
Expand All @@ -31,7 +41,10 @@ A role directory structure contains directories: defaults, vars, tasks, files, t

The project contains a playbook and multiple roles.

The ACS playbook can be found in the _playbooks_ directory. Because the project makes use of Ansible role structure, the playbook contains only definitions of the roles, and all the logic is performed by them, thus making the project both granular and easy to maintain.
The ACS playbook can be found in the _playbooks_ directory. Because the project
makes use of Ansible role structure, the playbook contains only definitions of
the roles, and all the logic is performed by them, thus making the project both
granular and easy to maintain.

The playbook uses the following roles:

Expand Down Expand Up @@ -64,36 +77,37 @@ set of instructions.
## Versioning

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).
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 playbooks can be retrieved from the
> [Pipfile](https://github.com/Alfresco/alfresco-ansible-deployment/blob/master/Pipfile).
The table below shows the version of the components deployed by the playbook for ACS 7.x onward.

| Component | 23.3 Enterprise (Community) | 7.4 Enterprise | 7.3 Enterprise | 7.2 Enterprise | 7.1 Enterprise |
|---------------------|-----------------------------|----------------|----------------|----------------|----------------|
| OpenJDK | 17.0.11 | 17.0.11 | 11.0.23 | 11.0.23 | 11.0.23 |
| Apache Tomcat | 10.1.25 | 9.0.91 | 9.0.91 | 9.0.91 | 9.0.91 |
| PostgreSQL | 15.x | 14.x | 14.x | 13.x | 13.x |
| Apache ActiveMQ | 5.18.5 | 5.17.6 | 5.17.6 | 5.16.7 | 5.16.7 |
| Repository | 23.3.2 (23.3.0) | 7.4.2.1 | 7.3.2.1 | 7.2.2.5 | 7.1.1.10 |
| Share | 23.3.2 (23.3.0) | 7.4.2.1 | 7.3.2.1 | 7.2.2.5 | 7.1.1.10 |
| Search Services | 2.0.11 | 2.0.11 | 2.0.11 | 2.0.11 | 2.0.2.2 |
| Search Enterprise | 4.1.0 (n/a) | 3.3.3 | 3.2.1 | 3.1.1.1 | 3.1.1.1 |
| All-In-One T-Engine | 5.1.4 | 5.1.4 | 3.1.2 | 3.1.2 | 3.1.2 |
| AOS | 3.1.0 | 1.6.2 | 1.5.0 | 1.4.1 | 1.4.1 |
| Google Docs | 4.0.0 | 3.4.2 | 3.3.1 | 3.2.2 | 3.2.1 |
| Digital Workspace | 5.1.0 (n/a) | 4.0.0 | 3.1.0 | 3.0.0 | 2.6.1 |
| Control Center | 9.1.0 | 8.0.0 | n/a | n/a | n/a |
| Transform Router | 4.1.4 (n/a) | 4.1.4 | 2.1.2 | 2.1.2 | 2.1.2 |
| Shared File Store | 4.1.4 (n/a) | 4.1.4 | 2.1.2 | 2.1.2 | 2.1.2 |
| Sync Service | 5.0.0 (n/a) | 3.11.3 | 3.11.3 | 3.11.3 | 3.11.3 |
The table below shows the version of the components deployed by the playbook for
ACS 7.x onward.

| Component | 23.4 Enterprise (Community) | 7.4 Enterprise | 7.3 Enterprise | 7.2 Enterprise |
|---------------------|-----------------------------|----------------|----------------|----------------|
| OpenJDK | 17.0.13 | 17.0.13 | 11.0.25 | 11.0.25 |
| Apache Tomcat | 10.1.33 | 9.0.97 | 9.0.97 | 9.0.97 |
| PostgreSQL | 15.x | 14.x | 14.x | 13.x |
| Apache ActiveMQ | 5.18.6 | 5.17.6 | 5.17.6 | 5.16.7 |
| Repository | 23.4.0 (23.4.0) | 7.4.2.1 | 7.3.2.1 | 7.2.2.5 |
| Share | 23.4.0 (23.4.0) | 7.4.2.1 | 7.3.2.1 | 7.2.2.5 |
| Search Services | 2.0.13 | 2.0.13 | 2.0.12 | 2.0.12 |
| Search Enterprise | 4.2.0 (n/a) | 3.3.3 | 3.2.1 | 3.1.1.1 |
| All-In-One T-Engine | 5.1.4 | 5.1.4 | 3.1.2 | 3.1.2 |
| AOS | 3.2.0 | 1.6.2 | 1.5.0 | 1.4.1 |
| Google Docs | 4.0.0 | 3.4.2 | 3.3.1 | 3.2.2 |
| Digital Workspace | 5.2.0 (n/a) | 4.0.0 | 3.1.0 | 3.0.0 |
| Control Center | 9.2.0 | 8.0.0 | n/a | n/a |
| Transform Router | 4.1.5 (n/a) | 4.1.5 | 2.1.2 | 2.1.2 |
| Shared File Store | 4.1.5 (n/a) | 4.1.5 | 2.1.2 | 2.1.2 |
| Sync Service | 5.1.0 (n/a) | 3.11.3 | 3.11.3 | 3.11.3 |

> Support for ACS 7.0 has been deprecated since April 2024, but you can still use the latest playbook that supported it ([v2.6.0](https://github.com/Alfresco/alfresco-ansible-deployment/releases/tag/v2.6.0))
> Support for ACS 6.2 has been deprecated since November 2022, but you can still use the latest playbook that supported it ([v2.2.0](https://github.com/Alfresco/alfresco-ansible-deployment/releases/tag/v2.2.0))
8 changes: 4 additions & 4 deletions group_vars/all.yml
Original file line number Diff line number Diff line change
Expand Up @@ -191,10 +191,10 @@ use_custom_keystores: false
dependencies_version:
postgresql_connector: 42.6.1
postgres_major_version: 15
activemq: 5.18.5
java: 17.0.11
java_build: 9
tomcat: 10.1.25
activemq: 5.18.6
java: 17.0.13
java_build: 11
tomcat: 10.1.33
libreoffice: 7.2.5.1
pdf_renderer: 1.1
imagemagick: 7.1.0-16-ci-10
Expand Down

0 comments on commit 29ce7ca

Please sign in to comment.