OPSEXP-3053 Refactor transformers role to use default vars (#1087)

Author: pmacius

.secrets.baseline

@@ -144,7 +144,7 @@
         "filename": "playbooks/acs.yml",
         "hashed_secret": "0ca8f28152882e5edb182fc3f7d4ae10a5b10dc5",
         "is_verified": false,
-        "line_number": 500
+        "line_number": 506
       }
     ],
     "roles/activemq/molecule/default/tests/test_activemq.py": [
@@ -187,16 +187,6 @@
         "is_secret": false
       }
     ],
-    "roles/transformers/tasks/main.yml": [
-      {
-        "type": "Secret Keyword",
-        "filename": "roles/transformers/tasks/main.yml",
-        "hashed_secret": "0eeb6b7bb932e8594b4ffe039dc15332f670cbd9",
-        "is_verified": false,
-        "line_number": 92,
-        "is_secret": false
-      }
-    ],
     "tests/molecule_it/script.sh": [
       {
         "type": "Secret Keyword",
@@ -208,5 +198,5 @@
       }
     ]
   },
-  "generated_at": "2025-02-20T20:40:33Z"
+  "generated_at": "2025-02-21T13:10:34Z"
 }

7.3.N-extra-vars.yml

@@ -21,10 +21,6 @@ api_explorer:
   artifact_name: api-explorer
   repository: "{{ nexus_repository.releases }}"
   version: 7.3.0
-transform:
-  artifact_name: alfresco-transform-core-aio
-  repository: "{{ nexus_repository.releases }}"
-  version: 5.1.6
 dependencies_version:
   postgresql_connector: 42.6.1
   postgres_major_version: 14

7.4.N-extra-vars.yml

@@ -24,10 +24,6 @@ api_explorer:
   artifact_name: api-explorer
   repository: "{{ nexus_repository.releases }}"
   version: 7.4.0
-transform:
-  artifact_name: alfresco-transform-core-aio
-  repository: "{{ nexus_repository.releases }}"
-  version: 5.1.6
 dependencies_version:
   postgresql_connector: 42.6.1
   postgres_major_version: 14

docs/deployment-guide.md

@@ -635,7 +635,7 @@ For example, to override the JAVA_OPTS environment variable for the All-In-One T
 all:
   children:
     transformers:
-      tengine_environment:
+      transformers_tengine_environment:
         JAVA_OPTS:
           - -Xms512m
           - -Xmx1g

group_vars/all.yml

@@ -47,19 +47,11 @@ api_explorer:
   artifact_name: api-explorer
   repository: "{{ nexus_repository.releases }}"
   version: 23.4.0
-transform:
-  artifact_name: alfresco-transform-core-aio
-  repository: "{{ nexus_repository.releases }}"
-  version: 5.1.6
 downloads:
   acs_zip_url: >-
     {{ acs.repository }}/{{ acs.artifact_name }}/{{ acs.version }}/{{ acs.artifact_name }}-{{ acs.version }}.zip
   acs_zip_sha1_checksum_url: >-
     {{ acs.repository }}/{{ acs.artifact_name }}/{{ acs.version }}/{{ acs.artifact_name }}-{{ acs.version }}.zip.sha1
-  transform_jar_url: >-
-    {{ transform.repository }}/{{ transform.artifact_name }}/{{ transform.version }}/{{ transform.artifact_name }}-{{ transform.version }}.jar
-  transform_jar_sha1_checksum_url: >-
-    {{ transform.repository }}/{{ transform.artifact_name }}/{{ transform.version }}/{{ transform.artifact_name }}-{{ transform.version }}.jar.sha1
 war_downloads:
   - url: >-
       {{ api_explorer.repository }}/{{ api_explorer.artifact_name }}/{{ api_explorer.version }}/{{ api_explorer.artifact_name }}-{{ api_explorer.version }}.war

playbooks/acs.yml

@@ -185,7 +185,7 @@
       ansible.builtin.import_role:
         name: "../roles/transformers"
       vars:
-        ats_keystore: "{{ transformers_keystore | default({}) }}"
+        transformers_ats_keystore: "{{ transformers_keystore | default({}) }}"
         java_version: "{{ acs_play_java_version }}"
         transformers_libreoffice_version: "{{ acs_play_transformers_libreoffice_version }}"
         transformers_libreoffice_archive_url: "{{ acs_play_transformers_libreoffice_archive_url }}"
@@ -195,12 +195,18 @@
         transformers_pdf_archive_checksum_url: "{{ acs_play_transformers_pdf_archive_checksum_url }}"
         transformers_imagemagick_version: "{{ acs_play_transformers_imagemagick_version }}"
         transformers_imagemagick_repository: "{{ acs_play_transformers_imagemagick_repository }}"
+        transformers_aio_version: "{{ acs_play_transformers_aio_version }}"
+        transformers_aio_archive_url: "{{ acs_play_transformers_aio_download_archive_url }}"
+        transformers_aio_archive_checksum_url: "{{ acs_play_transformers_aio_download_archive_sha1_checksum_url }}"
   post_tasks:
     - name: Update installation status file with Transformers
       become: true
       vars:
         transform_components:
-          transform: "{{ transform }}"
+          transform:
+            artifact_name: "{{ acs_play_transformers_aio_artifact_name }}"
+            repository: "{{ acs_play_transformers_aio_repository }}"
+            version: "{{ acs_play_transformers_aio_version }}"
       ansible.builtin.blockinfile:
         block: "{{ transform_components | to_nice_yaml(indent=2) }}"
         create: true

playbooks/group_vars/transformers.yml

@@ -9,7 +9,7 @@ acs_play_trouter_download_zip_url: "{{ acs_play_trouter_repository }}/{{ acs_pla
 acs_play_trouter_download_zip_sha1_checksum_url: "sha1:{{ acs_play_trouter_download_zip_url }}.sha1"
 
 acs_play_transformers_libreoffice_artifact_name: libreoffice-dist
-acs_play_transformers_libreoffice_archive_name: "{{ acs_play_transformers_libreoffice_artifact_name }}-{{ acs_play_transformers_libreoffice_version }}-{{ pkg_format }}.gz"
+acs_play_transformers_libreoffice_archive_name: "{{ acs_play_transformers_libreoffice_artifact_name }}-{{ acs_play_transformers_libreoffice_version }}-{{ transformers_pkg_format }}.gz"
 acs_play_transformers_libreoffice_repository: "{{ artifacts_repositories.community.base_url }}/repositories/thirdparty/org/libreoffice"
 acs_play_transformers_libreoffice_archive_url: "{{ acs_play_transformers_libreoffice_repository }}/{{ acs_play_transformers_libreoffice_artifact_name }}/{{ acs_play_transformers_libreoffice_version }}/{{ acs_play_transformers_libreoffice_archive_name }}"
 acs_play_transformers_libreoffice_archive_checksum_url: "sha1:{{ acs_play_transformers_libreoffice_archive_url }}.sha1"
@@ -21,3 +21,8 @@ acs_play_transformers_pdf_archive_url: "{{ acs_play_transformers_pdf_repository
 acs_play_transformers_pdf_archive_checksum_url: "sha1:{{ acs_play_transformers_pdf_archive_url }}.sha1"
 
 acs_play_transformers_imagemagick_repository: "{{ nexus_repository.releases }}"
+
+acs_play_transformers_aio_artifact_name: alfresco-transform-core-aio
+acs_play_transformers_aio_repository: "{{ nexus_repository.releases }}"
+acs_play_transformers_aio_download_archive_url: "{{ acs_play_transformers_aio_repository }}/{{ acs_play_transformers_aio_artifact_name }}/{{ acs_play_transformers_aio_version }}/{{ acs_play_transformers_aio_artifact_name }}-{{ acs_play_transformers_aio_version }}.jar"
+acs_play_transformers_aio_download_archive_sha1_checksum_url: "sha1:{{ acs_play_transformers_aio_download_archive_url }}.sha1"

playbooks/prerun-upgrade-checks.yml

@@ -54,7 +54,7 @@
           ansible.builtin.fail:
           when:
             - installed_components.transform is defined
-            - transform.version != installed_components.transform.version
+            - acs_play_transformers_aio_version != installed_components.transform.version
 
         - name: Fail on unsupported Trouter upgrades
           ansible.builtin.fail:

roles/transformers/defaults/main.yml

@@ -1,18 +1,18 @@
 ---
 # defaults file for roles/transformers
-pkg_format: "{% if ansible_pkg_mgr == 'apt' %}deb{% else %}rpm{% endif %}"
-tengine_environment:
+transformers_pkg_format: "{% if ansible_pkg_mgr == 'apt' %}deb{% else %}rpm{% endif %}"
+transformers_tengine_environment:
   JAVA_OPTS:
     - -Xms512m
     - -Xmx1536m
-ats_keystore: {}
-include_ghostscript: false
+transformers_ats_keystore: {}
+transformers_include_ghostscript: false
 
 transformers_libreoffice_artifact_name: libreoffice-dist
 transformers_libreoffice_repository: https://artifacts.alfresco.com/nexus/content/repositories/thirdparty/org/libreoffice
 
 transformers_libreoffice_version: 7.2.5.1
-transformers_libreoffice_archive_name: "{{ transformers_libreoffice_artifact_name }}-{{ transformers_libreoffice_version }}-{{ pkg_format }}.gz"
+transformers_libreoffice_archive_name: "{{ transformers_libreoffice_artifact_name }}-{{ transformers_libreoffice_version }}-{{ transformers_pkg_format }}.gz"
 transformers_libreoffice_archive_url: "{{ transformers_libreoffice_repository }}/{{ transformers_libreoffice_artifact_name }}/{{ transformers_libreoffice_version }}/{{ transformers_libreoffice_archive_name }}"
 transformers_libreoffice_archive_checksum_url: "sha1:{{ transformers_libreoffice_archive_url }}.sha1"
 transformers_libreoffice_home: "/opt/libreoffice{{ transformers_libreoffice_version[0:3] }}/"
@@ -27,3 +27,10 @@ transformers_pdf_archive_checksum_url: "sha1:{{ transformers_pdf_archive_url }}.
 
 transformers_imagemagick_version: 7.1.0-16-ci-11
 transformers_imagemagick_repository: https://artifacts.alfresco.com/nexus/content/groups/public/org/alfresco
+
+transformers_aio_artifact_name: alfresco-transform-core-aio
+transformers_aio_repository: https://artifacts.alfresco.com/nexus/content/groups/public/org/alfresco
+
+transformers_aio_version: 5.1.6
+transformers_aio_archive_url: "{{ transformers_aio_repository }}/{{ transformers_aio_artifact_name }}/{{ transformers_aio_version }}/{{ transformers_aio_artifact_name }}-{{ transformers_aio_version }}.jar"
+transformers_aio_archive_checksum_url: "sha1:{{ transformers_aio_archive_url }}.sha1"

roles/transformers/meta/argument_specs.yml

@@ -3,7 +3,13 @@ argument_specs:
   main:
     short_description: Main entrypoint for the tranformers role
     options:
-      ats_keystore:
+      transformers_pkg_format:
+        type: str
+        required: false
+        description: |
+          Package format to use for the transformers installation.
+          Possible values are 'deb' or 'rpm'.
+      transformers_ats_keystore:
         type: dict
         required: false
         no_log: true
@@ -50,3 +56,18 @@ argument_specs:
         required: false
         description: |
           URL of the repository where the ImageMagick distribution is stored.
+      transformers_aio_artifact_name:
+        type: str
+        required: false
+        description: |
+          The name of the transformers All-In-One artifact.
+      transformers_aio_archive_url:
+        type: str
+        required: false
+        description: |
+          The URL to download the transformers All-In-One artifact.
+      transformers_aio_archive_checksum_url:
+        type: str
+        required: false
+        description: |
+          The URL to download the checksum of the transformers All-In-One artifact.