Configure and Run Test Harness
Overview
Ensuring snapshot and change types work requires going through each specific change type and through each specific object type, then ensuring they execute correctly for all the different argument permutations that are valid for your database.
To automate this process, Liquibase provides a Test Harness to help you find everywhere the default logic isn't compatible with your database.
Test Harness Configuration
Configure your project using the steps in the Test Harness 'extension' setup docs.
When completed, you should have a harness-config.yml
file that specifies how to connect to the database and a new ExtensionHarnessTest
class that will run all the tests.
Running the Tests
The Test Harness 'Framework' documentation describes how the tests work and how to run them.
At the most basic level, you can run the tests using mvn test
using the configuration options defined in the test-harness framework documentation such as -DchangeObjects
.
If you are using an IDE, you can run your ExtensionHarnessTest
class directly and pass along the same settings as system properties.
Next Step
The first time you run the tests, you will get failures from missing files. See Milestone 2: Fix & Restest to continue.
Created: January 9, 2023