User Role: Administrator, Editor
A Project contains your Workflows which contain your database connections, changelog connections, secret vaults, workflow properties, and all Actions that run against the database. Actions can include Liquibase Commands and Policy Checks.
Before you configure a workflow, you must create a project, create a connection, and configure your workflow.
Configure Actions
1. Navigate to the Projects section in Liquibase.io.
2. Select the Project that needs Actions.
3. Select the Click to add new action card to begin configuring your Actions.
Click to add a new action.
Add a Liquibase Command to your Workflow
3. Select Liquibase Command as your Action type.
Select Liquibase Command as your Action type.
4. Name the command, select the desired command from the list, and fill in all required fields and any optional fields desired.
Tip! Some commands require configuring command-specific parameters.
This example shows the command parameters for diff. The parameters with an asterisk (*) are required.
Name the command
Select the desired command
Fill in all required fields and any optional fields desired
5. Select the Create button.
Add a Policy Check to your Workflow
6. Select the plus button (+) to add an Action to the Workflow.
7. Select Policy Check as the Action type, name the Policy Check, select the desired command from the list, and fill in all required and any optional fields desired.
Select the Run Policy Checks workflow type.
Select the policy check you want to add to your workflow.
Name the policy check.
8. Set the attributes necessary to your Policy Check.
Tip!
Set the severity of a policy check to trigger the appropriate warning when the check fails. The warnings help determine whether the job should proceed or stop and provide an exit code for automation tools.
Valid values are INFO (0), MINOR (1), MAJOR (2), CRITICAL (3), and BLOCKER (4), from least severe to most severe.
Learn more about this concept here: Use Policy Checks in Automation: Severity and Exit Code
9. Select the Create button to add the check to the Workflow.
The policy check appears in the Actions card.
Tip: To add an Action in the middle of the list, hover over the line connecting two actions until a plus button (+) appears between them.
You can add Actions to the workflow in any order. This is helpful if you want to add Actions later.
10. Toggle the Enable switch on.
11. Once the Enable switch is toggled on, the Run button will become active.
Select the Run button to execute the Workflow and create a Job.
Tip: Some actions, checks, and additional properties can be affected when Liquibase.io updates in the background.
You receive a warning alerting you about the new available options when you add an optional parameter in an update to an action, check, or additional property configured in an existing workflow.
You receive an error alerting you about the new required options when you add a required parameter in an update to an action, check, or additional property configured in an existing workflow. That workflow is disabled until an option is selected for the required parameter.