Merge pull request #19 from elabit/feat/os-centos

feat: add centos to the OS matrix

Author: simonmeggle

.github/workflows/run-suites.yml

@@ -160,14 +160,15 @@ jobs:
   # ── Stage 3: os content type (provision + verify + report) ────────────────
   # Independent of the detect-changes/test pair above: exactly one job per OS
   # family, added deliberately one epic at a time (Story 1.5 adds debian;
-  # Stories 2.2/3.2/4.2 each add one more matrix entry), never auto-detected
-  # from a directory listing the way the examples/templates matrix is.
+  # Stories 2.2/3.2/4.2 each add one more matrix entry; centos is a later
+  # addition sharing the redhat family with rhel), never auto-detected from a
+  # directory listing the way the examples/templates matrix is.
   os:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        slug: [debian, ubuntu, rhel, sles]
+        slug: [debian, ubuntu, rhel, sles, centos]
 
     steps:
       - uses: actions/checkout@v4

README.md

@@ -96,6 +96,7 @@ Proof that each target OS can be provisioned from a stock install (via Ansible,
 
 | OS | Base Image | Repository Link |
 |---|---|---|
+| [centos](os/centos) | `quay.io/centos/centos:stream9` | [try out](https://github.com/robotmk/os-centos) |
 | [debian](os/debian) | `debian:13` | [try out](https://github.com/robotmk/os-debian) |
 | [rhel](os/rhel) | `rockylinux/rockylinux:10` | [try out](https://github.com/robotmk/os-rhel) |
 | [sles](os/sles) | `registry.suse.com/suse/sle15:15.7` | [try out](https://github.com/robotmk/os-sles) |

_dev/_ansible/roles/browser-deps/tasks/redhat.yml

@@ -1,5 +1,5 @@
 ---
-- name: Install Chromium/Playwright system dependencies (Rocky Linux 10 / EL10 package names)
+- name: Install Chromium/Playwright system dependencies (RHEL-family / EL9+EL10 package names)
   ansible.builtin.dnf:
     name:
       - alsa-lib
@@ -30,16 +30,19 @@
     state: present
     update_cache: true
 
-- name: Record Rocky's missing Xvfb/emoji/unifont packages as a caveat, not a silent gap
+- name: Record this family's missing Xvfb/emoji/unifont packages as a caveat, not a silent gap
   ansible.builtin.set_fact:
     install_report_caveats:
       browser-deps:
         - >-
-          Rocky Linux 10's base+AppStream repos do not provide Xvfb, Google
-          Noto Color Emoji, or GNU Unifont (Noto Color Emoji is available via
-          EPEL, which this role deliberately does not enable, to stay close
-          to a stock install). Headless Chromium does not require Xvfb to
-          launch, so this does not block verification, but pages relying on
-          color emoji or Unifont's broad Unicode coverage may render with
-          fallback glyphs. Liberation fonts and scalable X fonts ARE
-          available here, unlike SLES's free BCI image.
+          GNU Unifont is not available in this family's base+AppStream repos
+          without enabling EPEL, which this role deliberately does not, to
+          stay close to a stock install (verified on both Rocky Linux 10 and
+          CentOS Stream 9). Xvfb and Google Noto Color Emoji availability
+          varies by release: absent from Rocky Linux 10's repos (also
+          EPEL-gated there), but present in CentOS Stream 9's AppStream.
+          Headless Chromium does not require Xvfb to launch, so none of this
+          blocks verification, but pages relying on color emoji or Unifont's
+          broad Unicode coverage may render with fallback glyphs on Rocky.
+          Liberation fonts and scalable X fonts ARE available on both, unlike
+          SLES's free BCI image.

_dev/_os/centos/copier.yml

@@ -0,0 +1,2 @@
+_subdirectory: template
+_answers_file: .copier-answers.yml

_dev/_os/centos/populate.yaml

@@ -0,0 +1,18 @@
+populate:
+  - src: _dev/_ansible
+    dst: .devcontainer/ansible
+    exclude:
+      - "*.pyc"
+      - "__pycache__"
+
+  - src: templates/web-browserlibrary
+    dst: tests/web-browserlibrary
+    exclude:
+      - "*.pyc"
+      - "__pycache__"
+      - "output"
+      - "log.html"
+      - "report.html"
+      - "output.xml"
+      - "browser"
+      - "playwright-log.txt"

_dev/_os/centos/template/.copier-answers.yml.jinja

@@ -0,0 +1,4 @@
+# This file is managed by Copier.
+# Do NOT edit manually. To regenerate: task generate
+_src_path: {{ _copier_conf.src_path }}
+_commit: {{ _copier_conf.commit or 'none' }}

_dev/_os/centos/template/.devcontainer/ansible.cfg

@@ -0,0 +1,2 @@
+[defaults]
+callbacks_enabled = install_report

_dev/_os/centos/template/.devcontainer/devcontainer.json.jinja

@@ -0,0 +1,15 @@
+{
+  "name": "os-centos",
+  "image": "{{ centos_image }}",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "d-biehl.robotcode",
+        "redhat.ansible"
+      ]
+    }
+  },
+  "onCreateCommand": "bash .devcontainer/oncreate.sh",
+  "postCreateCommand": "bash .devcontainer/postcreate.sh"
+}

_dev/_os/centos/template/.devcontainer/playbook.yml

@@ -0,0 +1,6 @@
+---
+- name: Provision OS environment
+  hosts: localhost
+  connection: local
+  roles:
+    - browser-deps

_dev/config/versions.env

@@ -20,4 +20,5 @@ SLES_IMAGE=registry.suse.com/suse/sle15:15.7
 # rhel slug is a documented exception to the generic <SLUG-UPPER>_IMAGE
 # derivation: the key is RHEL_COMPAT_IMAGE, not RHEL_IMAGE, because the pinned
 # image is a RHEL-compatible substitute (Rocky Linux), not RHEL itself.
-RHEL_COMPAT_IMAGE=rockylinux/rockylinux:10
+RHEL_COMPAT_IMAGE=rockylinux/rockylinux:10
+CENTOS_IMAGE=quay.io/centos/centos:stream9