doc: add usage for dubbo-samples-migration
diff --git a/dubbo-samples-migration/README.md b/dubbo-samples-migration/README.md
new file mode 100644
index 0000000..ed95960
--- /dev/null
+++ b/dubbo-samples-migration/README.md
@@ -0,0 +1,34 @@
+## Compatibility Testing Scenario Usage
+Pre-requirements: Both provider and consumer can not use the same `POM`, because you cannot guarantee that all the codes you write Dubbo 2.0 and 3.0 support at the same time, they must be divided into two independent projects. This is also applicable in daily business compatibility testing
+
+Add new grammar to `case-versions.conf`:
+```yaml
+# 原常规配置
+# dubbo.version=2.7*, 3.*
+spring.version=4.*, 5.*
+
+# 支持不同的 servcie 应用，配置不同的 dubbo 版本依赖，与 dubbo.version 二选一
+# 为防止构建用例倍级增长，不建议配置多个版本
+# dubbo.{service}.verison 中的 service 可以任意自定义
+dubbo.provider.version=3.*
+dubbo.consumer.version=2.7.*
+```
+And then in each consumer and provider project, you can configure `POM`'s properties as follows:
+```xml
+# consumer side
+<properties>
+ <dubbo.consumer.version>2.7.13</dubbo.consumer.version>
+</properties>
+
+# provider side
+<properties>
+ <dubbo.provider.version>2.7.13</dubbo.provider.version>
+</properties>
+```
+
+When the Integration Tests trigger, these properties will be overwritten by maven, for example:
+```shell
+mvn -Ddubbo.provider.version=3.0.3-SNAPSHOT -Ddubbo.consumer.version=2.7.13 -Dspring.version=4.3.16.RELEASE
+```
+
+
diff --git a/dubbo-samples-migration/case-configuration.yml b/dubbo-samples-migration/dubbo-samples-migration-case-default/case-configuration.yml
similarity index 95%
rename from dubbo-samples-migration/case-configuration.yml
rename to dubbo-samples-migration/dubbo-samples-migration-case-default/case-configuration.yml
index ab66946..c87fe01 100644
--- a/dubbo-samples-migration/case-configuration.yml
+++ b/dubbo-samples-migration/dubbo-samples-migration-case-default/case-configuration.yml
@@ -24,7 +24,7 @@
services:
${app_provider}:
type: app
- basedir: ${app_provider}
+ basedir: ../${app_provider}
mainClass: ${app_provider_main_class}
systemProps:
- dubbo.current.protocol=dubbo
@@ -37,7 +37,7 @@
${app_consumer}-test:
type: test
- basedir: ${app_consumer}
+ basedir: ../${app_consumer}
tests:
- "**/*IT.class"
systemProps:
diff --git a/dubbo-samples-migration/case-versions.conf b/dubbo-samples-migration/dubbo-samples-migration-case-default/case-versions.conf
similarity index 100%
rename from dubbo-samples-migration/case-versions.conf
rename to dubbo-samples-migration/dubbo-samples-migration-case-default/case-versions.conf
diff --git a/dubbo-samples-migration/dubbo-samples-migration-case-default/pom.xml b/dubbo-samples-migration/dubbo-samples-migration-case-default/pom.xml
new file mode 100644
index 0000000..6c9a501
--- /dev/null
+++ b/dubbo-samples-migration/dubbo-samples-migration-case-default/pom.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ <modelVersion>4.0.0</modelVersion>
+
+ <artifactId>dubbo-samples-migration-case-default</artifactId>
+ <groupId>org.apache.dubbo</groupId>
+ <version>1.0-SNAPSHOT</version>
+ <packaging>pom</packaging>
+
+ <modules>
+ <module>../dubbo-samples-migration-api</module>
+ <module>../dubbo-samples-migration-provider</module>
+ <module>../dubbo-samples-migration-consumer</module>
+ </modules>
+</project>
\ No newline at end of file
diff --git a/dubbo-samples-migration/pom.xml b/dubbo-samples-migration/pom.xml
index 543e835..6be8a68 100644
--- a/dubbo-samples-migration/pom.xml
+++ b/dubbo-samples-migration/pom.xml
@@ -13,5 +13,6 @@
<module>dubbo-samples-migration-api</module>
<module>dubbo-samples-migration-provider</module>
<module>dubbo-samples-migration-consumer</module>
+ <module>dubbo-samples-migration-case-default</module>
</modules>
</project>
\ No newline at end of file
