You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicecomb.apache.org by ni...@apache.org on 2019/06/29 03:15:06 UTC
[servicecomb-toolkit] branch master updated: [SCB-1332] Update the
README of toolkit
This is an automated email from the ASF dual-hosted git repository.
ningjiang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/servicecomb-toolkit.git
The following commit(s) were added to refs/heads/master by this push:
new 80f0ff8 [SCB-1332] Update the README of toolkit
80f0ff8 is described below
commit 80f0ff8bef1863b23dfb10f4c8f0f3e5e8bd2983
Author: MabinGo <bi...@huawei.com>
AuthorDate: Fri Jun 28 21:31:37 2019 +0800
[SCB-1332] Update the README of toolkit
Signed-off-by: MabinGo <bi...@huawei.com>
---
README-ZH.md | 42 ++++++++++++++++++++++-------------------
README.md | 26 ++++++++++++++-----------
images/architecture-en.png | Bin 11377 -> 16094 bytes
images/architecture-zh.png | Bin 9821 -> 14847 bytes
images/scene-en.png | Bin 0 -> 34189 bytes
images/scene-zh.png | Bin 0 -> 35309 bytes
images/workingprinciple-en.png | Bin 52892 -> 51874 bytes
images/workingprinciple-zh.png | Bin 48813 -> 46524 bytes
8 files changed, 38 insertions(+), 30 deletions(-)
diff --git a/README-ZH.md b/README-ZH.md
index 4dce64c..8f65b21 100755
--- a/README-ZH.md
+++ b/README-ZH.md
@@ -1,36 +1,38 @@
-# toolkit
+# Toolkit | [English](./README.md) [](https://www.apache.org/licenses/LICENSE-2.0.html) [](https://gitter.im/ServiceCombUsers/Lobby)
-基于契约的微服务开发工具套件
-
-[Introduction to English](./README.md)
+Apache ServiceComb Toolkit 是基于契约的微服务开发工具套件
## 1 简介
### 1.1 目标
-* 快速构建基于流行微服务框架和编程模型的微服务工程，并提供服务契约、代码、文档的一体化制作能力，帮助基于服务契约开发的用户在微服务转型阶段，降低微服务入门成本，聚焦业务开发，提升遗留系统重构、开发效率。
+* 提供契约、代码、文档相互转换及校验的能力，帮助用户一键式快速构建基于流行微服务框架和流行编程模型的微服务工程，降低微服务入门成本，使用户聚焦业务开发，提升遗留系统重构、开发效率。
+
+
### 1.2 特性
-* 代码提取服务契约
+* 遗留应用提取契约文件
- 在基于SpringMVC/POJO/JAX-RS模型开发的应用中，一键生成符合OpenAPI规范的服务契约文件。
+ 在基于SpringMVC/POJO/JAX-RS模型开发的应用中，一键提取符合OpenAPI规范的服务契约文件。
-* 服务契约生成微服务工程
+* 契约文件生成微服务工程
输入符合OpenAPI规范的服务契约，一键生成以ServiceComb/SpringCloud/Swagger为底座，以及以SpringMVC/POJO/JAX-RS或SpringBoot为开发模型的微服务项目。
-* 服务契约与代码一致性校验
+* 契约与代码一致性校验
校验应用的实际实现（如数据和服务API）是否与达成共识的服务契约描述一致。
-* 服务契约/代码生成文档
+* 契约/代码生成文档
- 输入符合OpenAPI规范的服务契约，一键生成html/word/pdf格式的文档。
+ 输入符合OpenAPI规范的服务契约，一键生成html格式的文档。
* Todo List
- * 支持契约一键制作以SpringCloud等流行微服务框架为底座的微服务工程。
+ * 支持一键生成以SpringCloud为底座的微服务工程。
+
+ * 支持一键从遗留应用代码生成微服务工程。
* 支持基于gradle的契约开发插件。
@@ -40,7 +42,7 @@
* 支持契约增量生成代码。
- * 支持生成“Hello World”微服务演示项目。
+ * 工具能力服务化。
### 1.3 适用场景
@@ -76,7 +78,7 @@
```shell
# 从github获取toolkit最新源码
-$ git clone https://github.com/MabinGo/toolkit.git
+$ git clone https://github.com/apache/servicecomb-toolkit.git
$ cd toolkit
# 构建打包
@@ -123,7 +125,7 @@ $ java -jar toolkit-cli-{version}.jar docgenerate -i swagger.yaml -o ./document
例：-i http://petstore.swagger.io/v2/swagger.json
* -o, --output : 文档输出路径
例：-o ./document
-* -f, --format : 指定输出文档风格,现支持swagger-ui
+* -f, --format : 指定输出文档风格,现支持swagger-ui
例：-f swagger-ui
### 3.3 使用toolkit-maven-plugin插件
@@ -131,7 +133,7 @@ $ java -jar toolkit-cli-{version}.jar docgenerate -i swagger.yaml -o ./document
在maven项目的pom文件中配置
```xml
<plugin>
- <groupId>org.apache.servicecomb</groupId>
+ <groupId>org.apache.servicecomb.toolkit</groupId>
<artifactId>toolkit-maven-plugin</artifactId>
<version>0.1.0-SNAPSHOT</version>
<configuration>
@@ -191,10 +193,12 @@ mvn toolkit:verifyContracts
<sourceContractsDir>./sourceContracts</sourceContractsDir>
```
-## 4 反馈问题
+## 4 社区互动
-Bugs: [issues](https://github.com/MabinGo/toolkit/issues)
+* [提交issues](https://issues.apache.org/jira/browse/SCB)
+* [gitter聊天室](https://gitter.im/ServiceCombUsers/Lobby)
+* 邮件列表: [订阅](mailto:dev-subscribe@servicecomb.apache.org) [浏览](https://lists.apache.org/list.html?dev@servicecomb.apache.org)
## 5 参与开发
-PR: [Pull request](https://github.com/MabinGo/toolkit/pulls)
+See [Pull Request Guide](http://servicecomb.apache.org/developers/submit-codes/) for details.
diff --git a/README.md b/README.md
index bc449cd..175a39c 100755
--- a/README.md
+++ b/README.md
@@ -1,14 +1,14 @@
-# toolkit
+# Toolkit | [中文](./README-ZH.md) [](https://www.apache.org/licenses/LICENSE-2.0.html) [](https://gitter.im/ServiceCombUsers/Lobby)
-Contract-based microservice development toolkit
-
-[中文简介](./README-ZH.md)
+Apache ServiceComb Toolkit is a contract-based microservice development toolkit
## 1 Introduction
### 1.1 Conceptions
-* A contract-based microservice development toolkit with the goal of rapidly building microservices projects based on popular microservices frameworks and programming models, and supporting the automatic generation of contracts,code and documentation to help users reduce micro-service entry costs, focus on business development, and improve legacy system reconfiguration and development efficiency during the microservice transformation phase.
+* Provides the ability to convert and verify contracts, code, and documents, helping users quickly build microservice projects based on popular microservices frameworks and popular programming models, reducing the cost of microservices entry, enabling users to focus on business development, enhance refactoring and development efficiency.
+
+
### 1.2 Features
@@ -26,12 +26,14 @@ Contract-based microservice development toolkit
* Service contract/code generation document
- Enter a service contract that conforms to the OpenAPI specification, one-click generation of a document in html/word/pdf format.
+ Enter a service contract that conforms to the OpenAPI specification, one-click generation of a document in html format.
* Todo List
* Support contract one-click production microservice engineering based on popular microservice framework such as SpringCloud.
+ * Support one-click generation of micro-service engineering from legacy application code
+
* Support gradle-based contract development plugin.
* Support plugins to embed eclipse.
@@ -40,7 +42,7 @@ Contract-based microservice development toolkit
* Support contract incremental generation code.
- * Support for generating "Hello World" microservice demo project.
+ * make capability as a service.
### 1.3 Applicable Scene
@@ -75,7 +77,7 @@ Contract-based microservice development toolkit
```shell
# Get the latest source code for toolkit from github
-$ git clone https://github.com/MabinGo/toolkit.git
+$ git clone https://github.com/apache/servicecomb-toolkit.git
$ cd toolkit
# Build package
@@ -130,7 +132,7 @@ $ java -jar toolkit-cli-{version}.jar docgenerate -i swagger.yaml -o ./document
Configured in the pom file of the maven project
```xml
<plugin>
- <groupId>org.apache.servicecomb</groupId>
+ <groupId>org.apache.servicecomb.toolkit</groupId>
<artifactId>toolkit-maven-plugin</artifactId>
<version>0.1.0-SNAPSHOT</version>
<configuration>
@@ -190,9 +192,11 @@ example
<sourceContractsDir>./sourceContracts</sourceContractsDir>
```
-## 4 Contact
+## 4 Contact us
-Bugs: [issues](https://github.com/MabinGo/toolkit/issues)
+* [issues](https://issues.apache.org/jira/browse/SCB)
+* [gitter](https://gitter.im/ServiceCombUsers/Lobby)
+* mailing list: [subscribe](mailto:dev-subscribe@servicecomb.apache.org) [view](https://lists.apache.org/list.html?dev@servicecomb.apache.org)
## 5 Contribute
diff --git a/images/architecture-en.png b/images/architecture-en.png
index edd2320..8797672 100755
Binary files a/images/architecture-en.png and b/images/architecture-en.png differ
diff --git a/images/architecture-zh.png b/images/architecture-zh.png
index 180baa7..142dede 100755
Binary files a/images/architecture-zh.png and b/images/architecture-zh.png differ
diff --git a/images/scene-en.png b/images/scene-en.png
new file mode 100755
index 0000000..bb3a98b
Binary files /dev/null and b/images/scene-en.png differ
diff --git a/images/scene-zh.png b/images/scene-zh.png
new file mode 100755
index 0000000..e29922a
Binary files /dev/null and b/images/scene-zh.png differ
diff --git a/images/workingprinciple-en.png b/images/workingprinciple-en.png
index 463fb3d..6eb2590 100755
Binary files a/images/workingprinciple-en.png and b/images/workingprinciple-en.png differ
diff --git a/images/workingprinciple-zh.png b/images/workingprinciple-zh.png
index 7766b83..c34ca0f 100755
Binary files a/images/workingprinciple-zh.png and b/images/workingprinciple-zh.png differ