Ansible Collection - agnosticd.showroom

An Ansible collection for deploying Showroom lab instruction environments to OpenShift clusters and VM-based infrastructure.

Showroom is a web-based lab instruction platform for the Red Hat Demo Platform. It combines rendered Antora/AsciiDoc content with embedded terminals, consoles, and interactive tools — giving workshop and demo participants everything they need in a single browser tab.

Tip	Full documentation: https://rhpds.github.io/showroom_template_nookbag The docs site covers everything from quick-start guides to full role references, content authoring, AgnosticV configuration, and architecture deep dives.

Roles

Role	Description
ocp4_workload_showroom	Deploys Showroom to OpenShift 4+ clusters using Helm charts. Supports single-user and multi-user deployments with integrated terminals, content rendering, and optional VNC access.
vm_workload_showroom	Deploys Showroom on VM-based infrastructure (RHEL/Fedora) using rootless Podman containers with TLS, systemd lifecycle management, and tab service support.
ocp4_workload_showroom_ocp_integration	Enables OpenShift web console embedding in Showroom iframes by removing security headers.
ocp4_workload_ocp_console_embed	Deploys a webhook proxy to allow OCP console embedding without modifying global cluster config.
ocp4_workload_showroom_user_data_seed	Seeds structured data into AgnosticD user_data for multi-user workshops.

Installation

ansible-galaxy collection install git+https://github.com/agnosticd/showroom.git

Or in a requirements.yml:

collections:
  - name: https://github.com/agnosticd/showroom.git
    type: git
    version: v1.4.0

Dependencies

• kubernetes.core (OpenShift deployments)

• containers.podman (VM deployments)

• ansible.posix (VM deployments)

• community.crypto (optional, SSH key generation)

• agnosticd.core (AgnosticD integration)

Related Projects

• showroom_template_nookbag — content repo template

• showroom-deployer — Helm charts for OpenShift

• showroom-images — container images

• nookbag — zero-touch UI bundle

Support

• Issues: https://github.com/agnosticd/showroom/issues

• Discussions: https://github.com/agnosticd/showroom/discussions