Umami distribution testing automation with and Diffy

Yuriy Gerasimov
Jun 19 · 3 min read

One of the big things that drive Drupal 8 adoption is an easy ability to “try it out”. That is a fantastic Umami distribution project.

Lately, we were working on automating visual regression testing so maintainers have an easy way to check the patches.

The only thing that is needed right now is to copy patch’s URL, paste it into one of the test branches in GitHub project — and in 5–10 minutes you’ll get a report with all visual changes that this patch brings. And even more — visual testing covers both anonymous users view and an admin as well.

GitHub set up

As you could see it is fairly standard composer based Drupal setup.

Main logic resides in composer.json file. It uses latest Drupal 8.7 dev branch and whenever you like to test the patch there — you simply add it in “patches” section: set up

Once any commit lands (i.e. testing a patch) related environment gets rebuild. All logic resides in file.

Here are the hooks that get triggered on each deployment

So you can see that we:

  • reinstall the site from scratch by using umami distribution
  • run cron
  • set up some debugging information
  • trigger visual regression testing

Visual regression testing with Diffy

  • gets all the credentials from variables
  • checks if the current branch is master or one of the test branches
  • if it is a master branch — simply create screenshots
  • if it is a test branch — create screenshots and compare them with latest screenshots from master branch environment (production in terms of Diffy)

Once jobs are completed we send an email with notification. Also, the diff gets renamed based on the branch name. So it is easy to track what environment was tested and when.

Diff report for test branch

As we are testing Umami with authenticated user — Diffy is configured to have two separate projects. The one that covers admin user tests layout builder URL only, but it can cover any other pages that need to be tested.

Admin authenticated user

Security and passing variables from to Diffy

The way we solved it is we have set up HTTP basic authentication in and passed credentials to our script that triggers jobs. allows passing variables to your build scripts

So then even with having GitHub repository open nobody without passwords would be able to access our builds and login.

Other use cases, visual regression testing platform

Deployments free of visual bugs