This is an automated email from the ASF dual-hosted git repository. ppalaga pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git
commit 34440418bcf55a46c714ec195fc64331d55cff43 Author: Peter Palaga <[email protected]> AuthorDate: Tue Jun 2 16:08:48 2020 +0200 Improve MySQL Debezium docs --- .../debezium-mysql/runtime/src/main/doc/usage.adoc | 21 +++++++++++++++------ integration-tests/debezium/README.adoc | 3 +++ integration-tests/debezium/pom.xml | 2 +- 3 files changed, 19 insertions(+), 7 deletions(-) diff --git a/extensions/debezium-mysql/runtime/src/main/doc/usage.adoc b/extensions/debezium-mysql/runtime/src/main/doc/usage.adoc index 4d2ea36..8dd3462 100644 --- a/extensions/debezium-mysql/runtime/src/main/doc/usage.adoc +++ b/extensions/debezium-mysql/runtime/src/main/doc/usage.adoc @@ -1,8 +1,17 @@ -We can not add driver as a compile scope dependency for legal reasons. +We cannot add the MySQL JDBC driver as a compile scope dependency of this extension because it is GPL2 licensed and it +would be against the policy of the Apache Software Foundation. -To use extension, you have to add runtime dependency to mysql driver. Suggested version and driver is -`mysql:mysql-connector-java:8.0.20`. (It is the transitive dependency from `o.quarkus:quarkus-jdbc-mysql:1.5.0.CR1`) +Therefore you have to add the dependency to your project yourself, as long as you are able to comply with its license +terms. -To execute integration tests you have to add driver jar into the specific folder in the module. Name of the file (which -also specifies version) is defined as property `mysql.driver.file` with default value -`libs/mysql-connector-java-8.0.20.jar` \ No newline at end of file +`quarkus-bom` (transitively included by `camel-quakrus-bom` and `quarkus-universe-bom`) manages a version +of `mysql:mysql-connector-java` compatible with Camel Quarkus. So you do not need specify the version of the +driver if you import any of the mentioned BOMs. The following should be sufficient for Maven: + +[source,xml] +---- +<dependency> + <groupId>mysql</groupId> + <artifactId>mysql-connector-java</artifactId> +</dependency> +---- diff --git a/integration-tests/debezium/README.adoc b/integration-tests/debezium/README.adoc new file mode 100644 index 0000000..5f0d7c8 --- /dev/null +++ b/integration-tests/debezium/README.adoc @@ -0,0 +1,3 @@ +To run the MySQL Debezium integration tests you have to store the driver jar under +`libs/mysql-connector-java.jar` in the current Maven module. The path can be changed by setting the +`mysql.driver.file` property on the command line. \ No newline at end of file diff --git a/integration-tests/debezium/pom.xml b/integration-tests/debezium/pom.xml index 2e273d4..19d0cbb 100644 --- a/integration-tests/debezium/pom.xml +++ b/integration-tests/debezium/pom.xml @@ -40,7 +40,7 @@ <mvnd.builder.rule>camel-quarkus-debezium-postgres-deployment,camel-quarkus-debezium-mysql-deployment,camel-quarkus-support-policy-deployment</mvnd.builder.rule> <!-- You need to download the driver yourself. We cannot add a compile scope dependency for legal reasons. --> <!-- See https://camel.apache.org/camel-quarkus/latest/extensions/debezium-myslq.html#_usage for more details --> - <mysql.driver.file>libs/mysql-connector-java-8.0.20.jar</mysql.driver.file> + <mysql.driver.file>libs/mysql-connector-java.jar</mysql.driver.file> </properties> <dependencyManagement>
