isabella232 / ff4j-extension

Liquibase extension to allow use of FF4J feature flags in changelogs and changesets

FF4J Feature Flags Extension

Precondition to control the execution of a changelog or changeset based on the state of feature flags from FF4J.

Supported Editions

Installation

The easiest way to install this extension is with lpm liquibase package manager.

lpm update
lpm add ff4j

Setup

The ff4j_url is required for the extension to know where the FF4J server is located.

--ff4j-url=PARAM
     URL for FF4J Server
     (liquibase.ff4j.url)
     (LIQUIBASE_FF4J_URL)
     [deprecated: --ff4jUrl]

Usage

To use this extension, add the ff4jFeatureFlag precondition to your Changelog or Changeset with an enabledFlags attribute. The value for enabledFlags is either a string with one feature flag key or a comma separated string with multiple feature flag keys. All feature flags must be enabled for the precondition to pass.

Example

databaseChangeLog:
  -  preConditions:
     -  ff4jFeatureFlag:
          enabledFlags: changelog-testing

<changeSet id="1" author="example">
    <preConditions>
        <ext:ff4jFeatureFlag enabledFlags="changelog-testing"/>
    </preConditions>
    ...
</changeSet>

Feedback and Issues

Please submit all feedback and issues to this idea board.