|
1 | | -# What is Liquibase? |
| 1 | +# 🚨 Important: Liquibase 5.0 Changes 🚨 |
| 2 | + |
| 3 | +## Liquibase Community vs Liquibase Secure |
| 4 | + |
| 5 | +Starting with **Liquibase 5.0**, we have introduced a clear separation between our open source Community edition and our commercial Secure offering: |
| 6 | + |
| 7 | +- **`liquibase/liquibase`** (Community Edition): Community version under the Functional Source License (FSL) |
| 8 | +- **`liquibase/liquibase-secure`** (Secure Edition): Commercial version with enterprise features |
| 9 | + |
| 10 | +**If you have a valid Liquibase License Key, you should now use `liquibase/liquibase-secure` instead of `liquibase/liquibase`.** |
| 11 | + |
| 12 | +## 🚨 Breaking Change: Drivers and Extensions No Longer Included |
| 13 | + |
| 14 | +As of **Liquibase 5.0**, the Community edition (`liquibase/liquibase`) and the official Docker Community liquibase image **no longer include database drivers or extensions by default**. |
| 15 | + |
| 16 | +**What this means for you:** |
| 17 | + |
| 18 | +- You must now explicitly add database drivers using the Liquibase Package Manager (LPM) |
| 19 | +- Extensions must be manually installed or mounted into the container |
| 20 | +- MySQL driver installation via `INSTALL_MYSQL=true` environment variable is still supported |
| 21 | + |
| 22 | +**Learn more:** [Liquibase 5.0 Release Announcement](https://www.liquibase.com/blog/liquibase-5-0-release) |
| 23 | + |
| 24 | +## Adding Drivers with LPM |
| 25 | + |
| 26 | +```dockerfile |
| 27 | +FROM liquibase/liquibase:latest |
| 28 | +# Add database drivers as needed |
| 29 | +RUN lpm add mysql --global |
| 30 | +RUN lpm add postgresql --global |
| 31 | +RUN lpm add mssql --global |
| 32 | +``` |
| 33 | + |
| 34 | +--- |
| 35 | + |
| 36 | +## What is Liquibase? |
2 | 37 |
|
3 | 38 | Liquibase is DevOps for your database. More information about Liquibase can be found at [http://www.liquibase.org](http://www.liquibase.org). |
4 | 39 |
|
5 | 40 | Liquibase compares the contents of a Change Log to the database to determine which, if any, changes need to be applied to the database. For example, you can create tables, add columns, and many more with Liquibase. Liquibase is delivered via a Docker container to assist users that are leveraging Docker for their CI/CD solution. |
6 | 41 |
|
7 | 42 | %%LOGO%% |
8 | 43 |
|
9 | | -# How to use this image |
| 44 | +## How to use this image |
10 | 45 |
|
11 | 46 | If you are executing Liquibase via the command line today, you are probably doing it like so: |
12 | 47 |
|
|
0 commit comments