Liquibase Hub Auto-Registration and Report Links
Liquibase Hub is a free central site to help you organize and monitor your local Liquibase database change activity in real-time, which increases team collaboration and deployment success. Starting with Liquibase 4.3, you can use two new capabilities of Liquibase Hub:
- Become a registered user of Liquibase Hub in one step
- Receive a clickable link to immediately see the Liquibase Hub report of your activity
You can run
liquibase update or any other Liquibase Hub-enabled command in the CLI (see Using Commands in Liquibase Hub ), and this will give you the option to start sending data to Liquibase Hub. If you accept the option and provide your email address, then a Liquibase Hub User, Organization, Project, Target, and API key are created automatically, and your changelog is registered to your Project. The API key and
changelogID will be stored in the existing
liquibase.properties file, or if you don’t have the
liquibase.properties file, Liquibase will create a new one in the current working directory.
Your command will be run, after which a link to the operation report on Liquibase Hub is written to the console. When you open the link in a browser, you can see that operation’s report.
Note: If you just auto-registered, please complete your initial sign-in using the one-time password sent to your email.
The use of capabilities is currently limited to CLI and will be extended to additional integrations in future releases.
If you use earlier versions of Liquibase, to register your Liquibase Hub account, sign up to Liquibase Hub, retrieve an API key, and copy it to the
liquibase.properties file. Next, run the registerChangeLog command and your other commands to start sending data and receiving reports.
If you use CI/CD tools and run in automation, the prompt is skipped and the automation continues. In this case, Liquibase uses Java’s internal methods (or you can set
liquibase.headless="true") to detect when running commands without interaction.
Liquibase Hub Report
If you use Liquibase and a Liquibase Hub API key, you can use Liquibase Hub to monitor your changes through reports. When you run a successful Hub-enabled command, a link to your Liquibase Hub report will be shown on the console.