Ansible Role: Xvfb

Ansible role to install Xvfb (X virtual framebuffer) on UNIX-like platforms.

For project facts and architecture mindmap, see FACTS.mmd. For execution flows and logic diagrams, see FLOWS.mmd.

Requirements

This role requires:

• Ansible
• Python
• Administrative/root access on target hosts
• One of the following operating systems:
  • Alpine Linux
  • Debian/Ubuntu
  • NixOS or systems with Nix package manager

Install

Install from Ansible Galaxy

To install this role from Ansible Galaxy, run the following command:

ansible-galaxy install ea31337.xvfb

Install from GitHub

To install this role, you can use the following terminal command:

ansible-galaxy install git+https://github.com/EA31337/ansible-role-xvfb.git

Role Variables

For available variables, check defaults/main.yml.

Testing

Docker

Steps to test role on Docker containers.

1. Install the current role by running the following commands in shell:

   ansible-galaxy install -r requirements.yml
   jinja2 requirements-local.yml.j2 -D "pwd=$PWD" -o requirements-local.yml
   ansible-galaxy install -r requirements-local.yml

   Alternatively, for development purposes, you can consider using symbolic link, e.g.

   ln -vs "$PWD" ~/.ansible/roles/ea31337.xvfb

2. Ensure Docker service (e.g. Docker Desktop) is running.

3. Run playbook from tests/:

   ansible-playbook -i tests/inventory/docker-containers.yml tests/playbooks/docker-containers.yml

Molecule

To test using Molecule, run:

molecule test

Docker Image

The Docker image is automatically built and pushed to the GitHub Container Registry (GHCR) on every merge to master and on new tags.

To pull the latest image:

docker pull ghcr.io/ea31337/ansible-role-xvfb:latest

Supported Tags

The following tags are available for ghcr.io/ea31337/ansible-role-xvfb:

• latest: Latest version (based on ubuntu-latest).
• alpine-latest: Based on alpine:latest.
• debian-latest: Based on debian:latest.
• nixos-latest: Based on nixos/nix:latest.
• ubuntu-jammy: Based on ubuntu:jammy.
• ubuntu-noble: Based on ubuntu:noble.
• ubuntu-latest: Based on ubuntu:latest.
• v1.0.4: Release v1.0.4.

License

GNU GPL v3

See: LICENSE

References

• Project facts: FACTS.mmd
• Project flows: FLOWS.mmd