[07/51] incubator-servicecomb-website git commit: Devide FAQ to independent module, and add faqs

Mon, 11 Dec 2017 23:06:06 -0800 

Devide FAQ to independent module, and add faqs

Signed-off-by: Zen Lin <[email protected]>


Project: 
http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/repo
Commit: 
http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/commit/455450a0
Tree: 
http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/tree/455450a0
Diff: 
http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/diff/455450a0

Branch: refs/heads/asf-site
Commit: 455450a0ff08dedc8ee5b6f69b05233171265053
Parents: b76908d
Author: Zen Lin <[email protected]>
Authored: Sun Oct 29 19:40:03 2017 +0800
Committer: Eric Lee <[email protected]>
Committed: Sun Oct 29 21:42:32 2017 +0800

----------------------------------------------------------------------
 _config.yml                   |  13 ++
 _data/navigation.yml          |  30 +--
 _data/ui-text.yml             |   2 +
 _faqs/cn/faq.md               | 424 +++++++++++++++++++++++++++++++++++++
 _faqs/cn/huawei-cloud-faq.md  |  41 ++++
 _faqs/faq.md                  |  59 ++++++
 _faqs/huawei-cloud-faq.md     |  41 ++++
 _users/cn/faq.md              | 415 ------------------------------------
 _users/cn/huawei-cloud-faq.md |  41 ----
 9 files changed, 596 insertions(+), 470 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_config.yml
----------------------------------------------------------------------
diff --git a/_config.yml b/_config.yml
index 4a8c4e3..6a25b62 100644
--- a/_config.yml
+++ b/_config.yml
@@ -117,6 +117,7 @@ include:
   - _developers
   - _docs
   - _users
+  - _faqs
 exclude:
   - "*.sublime-project"
   - "*.sublime-workspace"
@@ -237,6 +238,18 @@ defaults:
       comments: false
       sidebar:
         nav: "docs"
+  # _faqs
+  - scope:
+      path: "_faqs"
+      type: pages
+    values:
+      layout: single
+      read_time: false
+      author_profile: false
+      share: false
+      comments: false
+      sidebar:
+        nav: "faqs"
 
 # Sass/SCSS
 sass:

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_data/navigation.yml
----------------------------------------------------------------------
diff --git a/_data/navigation.yml b/_data/navigation.yml
index 54d7fd1..97fce9f 100755
--- a/_data/navigation.yml
+++ b/_data/navigation.yml
@@ -10,6 +10,8 @@ t:
         url: /developers/
       - title: "Blogs"
         url: /year-archive/
+      - title: "FAQ"
+        url: /faqs/
 
     docs:
       - title: "Quick Start"
@@ -37,8 +39,6 @@ t:
             url: /users/
           - title: Setup Environment
             url: /users/setup-environment/
-          - title: FAQ
-            url: /users/faq/
 
       - title: Develop Service Provider
         children:
@@ -102,11 +102,6 @@ t:
           - title: Use TLS
             url: /users/use-tls/
 
-      - title: Huawei Public Cloud
-        children:
-          - title: FAQ
-            url: /users/huawei-cloud-faq/
-
     developers:
       - title: "Developer Guide"
         url: /developers/
@@ -115,6 +110,12 @@ t:
       - title: "Code Submit Guide"
         url: /developers/submit-codes/
 
+    faqs:
+      - title: "FAQ"
+        url: /faqs/
+      - title: "FAQ of Huawei Cloud"
+        url: /faqs/faqs-huawei-cloud/
+
   cn:
     main:
       - title: "快速入门"
@@ -125,6 +126,8 @@ t:
         url: /cn/developers/
       - title: "博文"
         url: /cn/year-archive/
+      - title: "常见问题"
+        url: /cn/faqs/
 
     docs:
       - title: "快速入门"
@@ -152,8 +155,6 @@ t:
             url: /cn/users/
           - title: 环境配置
             url: /cn/users/setup-environment/
-          - title: 常见问题
-            url: /cn/users/faq/
 
       - title: 开发服务提供者
         children:
@@ -217,11 +218,6 @@ t:
           - title: 使用TLS通信
             url: /cn/users/use-tls/
 
-      - title: 华为公有云
-        children:
-          - title: 常见问题
-            url: /cn/users/huawei-cloud-faq/
-
     developers:
       - title: "开发者指南"
         url: /cn/developers/
@@ -229,3 +225,9 @@ t:
         url: /cn/developers/setup-develop-environment/
       - title: "代码提交指南"
         url: /cn/developers/submit-codes/
+    
+    faqs:
+      - title: "常见问题"
+        url: /cn/faqs/
+      - title: "华为公有云常见问题"
+        url: /cn/faqs/faqs-huawei-cloud/

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_data/ui-text.yml
----------------------------------------------------------------------
diff --git a/_data/ui-text.yml b/_data/ui-text.yml
index f8b7018..64af9bb 100644
--- a/_data/ui-text.yml
+++ b/_data/ui-text.yml
@@ -7,6 +7,7 @@ en: &DEFAULT_EN
   quick_start               : "Quick Start"
   user_guide                : "User Guide"
   blogs                      : "Blogs"
+  faqs                       : "FAQ"
   faq                       : "Common Questions"
   contribute                : "Contribute"
   report_issue              : "Report a Doc Issue"
@@ -367,6 +368,7 @@ zh: &DEFAULT_ZH
   quick_start               : "快速入门"
   user_guide                : "用户指南"
   blogs                      : "博客"
+  faqs                       : "常见问题"
   faq                       : "常见问题"
   contribute                : "贡献"
   report_issue              : "报告本网页问题"

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_faqs/cn/faq.md
----------------------------------------------------------------------
diff --git a/_faqs/cn/faq.md b/_faqs/cn/faq.md
new file mode 100644
index 0000000..fc50549
--- /dev/null
+++ b/_faqs/cn/faq.md
@@ -0,0 +1,424 @@
+---
+title: "常见问题"
+lang: cn
+ref: faq
+permalink: /cn/faqs/
+excerpt: "常见问题"
+last_modified_at: 2017-10-29T15:01:43-04:00
+redirect_from:
+  - /theme-setup/
+---
+
+* **Q: ServiceComb和SpringCloud是什么关系，å…
·ä½“的应用场景是什么？**
+   
+   A: ServiceComb是华为基于内
部多个大型IT系统实践提炼出来的一套微服务开发框架，在开发态基于最佳实践封è£
…了一套微服务运行模型，这些能力对用户完å…
¨é€æ˜Žï¼Œå¯ä»¥é€šè¿‡é…ç½®å¼•å…¥åŠŸèƒ½å’Œå¯¹å…
¶è¿›è¡Œè°ƒæ•´ã€‚在运维阶段充
分考虑了微服务运维，提供了丰富的监控指æ 
‡å’ŒåŠ¨æ€æ²»ç†èƒ½åŠ›ã€‚      
+   B: 
ServiceComb的这套能力可以作为一个单独的开发框架，在需要轻量级微服务解决方案的的场景中单独使用，也可以建立在SpringCloud上，与SpringCloud提供的å
…¶ä»–组件一起工作，在重量级场景中和SpringCloud一起产生 
“1+1大于2”的效果。
+
+* **Q: 用IntelliJ的免费版开发，有什么问题？**   
+    
+   A: 没有问题，使用IntelliJ 开发，可参考 [Setup Developer 
Environment](/cn/developers/setup-develop-environment/) 进行相应的环境é…
ç½®ã€‚    
+   
+* **Q: 使用Java-Chassis这个框架时有什么需要注意的地方？**
+
+   A: 使用Java-Chassis有以下这些限制：
+   (1) 0.3.0-SNAPSHOT之前的版本不支持类似`@GetMapping`这样的æ 
‡æ³¨ã€‚
+   (2) 所用到的HTTP请求方法一æ 
·æ—¶ï¼Œå¦‚GET，则方法名不能重载。这是由于生成契约时方法名会作为å
…¶Operation ID，所以要保证其唯一性。
+   (3) 方法和类必须是public的。
+
+* **Q: 
使用*spring-boot-starter-provider*这个依赖时，在*application.yml*文件中声明的`spring.main.web-application`属性并没有生效？**
+
+   A: 
使用*starter-provider*这个依赖时，如果用到了servlet这种方式时，需要在*application.properties*这个文件引å
…¥`spring.main.web-application=true`这样的属性或者
在*application.yml*文件中声明，但是此时需要新建一个*application.properties*的文件，å
…¶å†…容可以为空。
+
+* **Q: 网关依赖的jar和其他微服务的一样吗？**
+
+   ```xml
+   <groupId>io.servicecomb</groupId>
+   <artifactId>spring-boot-starter-provider</artifactId>
+   ```
+
+   A: 网å…
³é™¤äº†è¦ä¾èµ–`spring-boot-starter-provider`之外还要依赖`spring-boot-starter-discovery`，可以参考[LinuxCon-Beijing-Workshop](https://github.com/ServiceComb/LinuxCon-Beijing-WorkShop)中manager的实现。
+
+* **Q: 网关需要像其他微服务一样配置assembly吗？å…
¶ä¸­çš„/maven/gateway这个路径是docker maven plugin默认的吗？**
+
+   A: 需要，由于项目现在使用的是spring-boot的打包
方式，docker maven plugin也是依赖打包
生成的文件来生成docker镜像的。/maven这个路径是docker maven 
plugin指定的，而gateway这个路径是在assembly中指定的。
+
+* **Q: 服务接口的返回类型可以是任意类型吗？还是必
须是responseEntity？**
+
+   A: 可以，å…
·ä½“可以参考java-chassis的[integration-test的实现](https://github.com/ServiceComb/java-chassis/blob/master/integration-tests/springmvc-tests/src/test/java/io/servicecomb/demo/springmvc/tests/SpringMvcIntegrationTestBase.java#L145)。
+
+* **Q: 微服务启动后，无法正确调用接口，使用的代码为：**
+
+   ```java
+   @RestController
+   @RestSchema(schemaId = "worker")
+   public class WorkerController {
+     @RequestMapping(value="/count", method=RequestMethod.GET)
+     public int getWorkerNumbers() {
+       ...
+     }
+   }
+   ```
+
+   A: 在没有指明根路径的情况下，默认会使用类名作为其æ 
¹è·¯å¾„，即上述代ç 
ä¸­å¯è®¿é—®çš„路径应为`/WorkerController/count`。如果想要实现`/count`这æ
 ·çš„访问，则要指明根路径：
+
+   ```java
+   @RequestMapping(value = "/")
+   public class WorkerController {}
+   ```
+
+* **Q: 如果没有指定RequestMapping这个æ 
‡æ³¨çš„value时，默认的基本路径是什么？**
+
+   A: 假设你
的Controller类名为*HelloController*，那么基本路径就是/HelloController。
+
+* **Q: 在eclipse下修改了microservice.yamlé…
ç½®æ–‡ä»¶ä¸‹çš„端口号，启动程序后，端口号没生效？**
+
+   A: 需要单独导入sample项目，如果导å…
¥æ•´ä¸ªServiceComb-Java-Chassis项目，由于sample目录不在ServiceComb-Java-Chassis模块中，IDE不会对sample进行编译,eclipse下并没有提示错误信息，IDEA下会有提示信息。å›
 æ­¤eclipse启动sample的demo会发现修改了端口没有生效。
+
+* **Q: 如何自定义某个Java方法对应的REST接口里的HTTP Status 
Code？**
+
+   A: 
对于正常的返回值，可以通过SwaggerAnnotation实现，例如：
+
+   ```java
+   @ApiResponse(code = 300, response = String.class, message = "")
+   public int test(int x) {
+     return 100;
+   }
+   ```
+   
+   
对于异常的返回值，可以通过抛出自定义的InvocationException实现，例如：、
+   
+   ```java
+   public String testException(int code) {
+     String strCode = String.valueOf(code);
+       switch (code) {
+         case 200:
+           return strCode;
+         case 456:
+           throw new InvocationException(code, strCode, strCode + " error");
+         case 556:
+           throw new InvocationException(code, strCode, Arrays.asList(strCode 
+ " error"));
+         case 557:
+           throw new InvocationException(code, strCode, 
Arrays.asList(Arrays.asList(strCode + " error")));
+         default:
+           break;
+       }
+   
+     return "not expected";
+   }
+   ```
+
+
+* **Q: 如何定制自己微服务的日志配置?**
+
+   A: 
ServiceComb不绑定日志器，只是使用了slf4j，用户可以自由选择log4j/log4j2/logback等等。ServiceComb提供了一个log4j的扩展，在æ
 ‡å‡†log4j的基础上，支持log4j的properties文件的增量配置。
+   * 默认以规则："classpath\*:config/log4j.properties"加载配置文件
+   * 实际
会搜索出classpath中所有的```config/log4j.properties和config/log4j.*.properties```,
 
从搜索出的文件中切出```\*```的部分，进行alpha排序，然后按顺序åŠ
 è½½ï¼Œæœ€åŽåˆæˆçš„文件作为log4j的配置文件。
+   * 
如果要使用ServiceComb的log4j扩展，则需要调用Log4jUtils.init，否则完å
…¨æŒ‰æ ‡å‡†çš„日志器的规则使用。
+
+* **Q: 当服务é…
ç½®äº†å¤šä¸ªtransport的时候，在运行时是怎么选择使用哪个transport的？**
+
+   A: 
+   * 
ServiceComb的consumer、transport、handler、producer之间是解耦的，各功能之间通过契约定义联合在一起工作的，即：
+      
consumer使用透明rpc，还是springmvc开发与使用highway，还是RESTful在网络上ä¼
 è¾“没有关系与producer是使用透明rpc，还是jaxrs，或者
是springmvc开发，也没有å…
³ç³»handler也不感知，业务开发方式以及传输方式
+   
+   * 
consumer访问producer，在运行时的transport选择上，总规则为：
+      
consumer的transport与producer的endpoint取交集，如果交集后，还有多个transport可选择，则轮流使用
+   
+      分解开来，存在以下场景：
+   
+   * 当一个微服务producer同时开放了highway以及RESTful的endpoint
+      * consumer进程中只部署了highway transport 
jar，则只会访问producer的highway endpoint
+      * consumer进程中只部署了RESTful transport 
jar，则只会访问producer的RESTful endpoint
+      * consumer进程中，同时部署了highway和RESTful transport 
jar，则会轮流访问producer的highway、RESTful endpoint
+   
+      
如果，此时consumer想固定使用某个transport访问producer，可以在consumer进程的microservice.yaml中é
…ç½®ï¼ŒæŒ‡å®štransport的名称:
+
+      ```yaml
+      servicecomb:
+        references:
+          <service_name>:
+            transport: highway
+      ```
+   
+   * 当一个微服务producer只开放了highway的endpoint
+      * consumer进程只部署了highway transport 
jar，则正常使用highway访问
+      * consumer进程只部署了RESTful transport jar，则无法访问
+      * consumer进程同时部署了highway和RESTful transport 
jar，则正常使用highway访问
+   
+   * 当一个微服务producer只开放了RESTful的endpoint
+      * consumer进程只部署了highway transport jar，则无法访问
+      * consumer进程只部署了RESTful transport 
jar，则正常使用RESTful访问
+      * consumer进程同时部署了highway和RESTful transport 
jar，则正常使用RESTful访问
+
+* **Q: swagger body参数类型定义错误，导致服务中心注册的内
容没有类型信息**
+
+   **现象描述:**
+   
+   定义如下接口，将参数放到body传递
+   
+   ```yaml
+   /testInherate:
+       post:
+         operationId: "testInherate"
+         parameters:
+         - in: "body"
+           name: "xxxxx"
+           required: false
+           type: string
+         responses:
+           200:
+             description: "response of 200"
+             schema:
+               $ref: "#/definitions/ReponseImpl"
+   ```
+   
+   
采用上面方式定义接口。在服务注册以后，从服务中心查询下来的接口type:
 string 丢失，变成了：
+   
+   ```yaml
+   /testInherate:
+       post:
+         operationId: "testInherate"
+         parameters:
+         - in: "body"
+           name: "xxxxx"
+           required: false
+         responses:
+           200:
+             description: "response of 200"
+             schema:
+               $ref: "#/definitions/ReponseImpl"
+   ```
+   
+   如果客户端没有放置swagger，还会报告如下异常：
+   
+   ```text
+      Caused by: java.lang.ClassFormatError: Method "testInherate" in class ? 
has illegal signature "
+   ```
+   
+   
A：定义body参数的类型的时候，需要使用schema，不能直接使用type。
+   
+   ```yaml
+   /testInherate:
+       post:
+         operationId: "testInherate"
+         parameters:
+         - in: "body"
+           name: "request"
+           required: false
+           schema:
+             type: string
+         responses:
+           200:
+             description: "response of 200"
+             schema:
+               $ref: "#/definitions/ReponseImpl"
+   ```
+
+* **Q: ServiceComb微服务框架服务调用是否使用长连接?**
+
+   A: http使用的是长连接（有超
时时间），highway方式使用的是长连接（一直保持）。
+   
+* **Q: 服务断连服务中心注册信息是否自动删除**
+
+   A: 
服务中心心跳检测到服务实例不可用，只会移除服务实例信息，服务的静态数据不会移除。
+
+* **Q: 
如果使用tomcat方式集成ServiceComb微服务框架，如何实现服务注册**
+
+   A: 如果使用cse sdk 
servlet方式（使用transport-rest-servlet依赖）制作为war包
部署到tomcat，需要保证，服务描述文件（microservice.yaml）中rest端口é
…ç½®å’Œå¤–置容器一致才能实现该服务的正确注册。否则无
法感知tomcat开放端口。
+
+* **Q: 
如果使用tomcat方式集成CSE微服务框架，服务注册的时候如何将waråŒ
…部署的上下文注册到服务中心**
+
+   A: 发布服务接口的时候需要将war包
部署的上下文（context）放在baseurl最前面，这æ 
·æ‰èƒ½ä¿è¯æ³¨å†Œåˆ°æœåŠ¡ä¸­å¿ƒçš„路径是完整的路径（包
含了上下文）。实例：
+
+   ```java
+   @path(/{context}/xxx)
+   class ServiceA
+   ```
+   
+* **Q: ServiceComb微服务框架如何实现数据多个微服务间透传**
+
+   A:
+   透传数据塞入：
+   
+   ```java
+   CseHttpEntity<xxxx.class> httpEntity = new CseHttpEntity<>(xxx);
+   //透传内容
+   httpEntity.addContext("contextKey","contextValue");
+   ResponseEntity<String> responseEntity = 
RestTemplateBuilder.create().exchange("cse://springmvc/springmvchello/sayhello",HttpMethod.POST,httpEntity,String.class);
+   ```
+   
+   透传数据获取：
+   
+   ```java
+   @Override
+   @RequestMapping(path="/sayhello",method = RequestMethod.POST)
+   public String sayHello(@RequestBody Person person,InvocationContext 
context){
+     //透传数据获取
+     context.getContext();
+     return "Hello person " + person.getName();
+   }
+   ```
+
+* **Q: ServiceComb微服务框架服务如何自定义返回状态码?**
+
+   A:
+   ```java
+   @Override
+   @RequestMapping(path = "/sayhello",method = RequestMethod.POST)
+   public String sayHello(@RequestBody Person person){
+     InvocationContext context = ContextUtils.getInvocationContext();
+     //自定义状态码
+     context.setStatus(Status.CREATED);
+     return "Hello person "+person.getName();
+   }
+   ```
+   
+* **Q: ServiceComb body Model部分暴露**
+
+   A: 一个接口对应的body对象中，可能有一些属性是内
部的，不想开放出去，生成schema的时候不要带出去，使用：
+   
+   ```java
+   @ApiModelProperty(hidden = true)
+   ```
+   
+* **Q: ServiceComb框架获取远端consumer的地址**
+
+   A: 如果使用http 
rest方式（使用transport-rest-vertx依赖）可以用下面这种方式获取：
+
+   ```java
+   AbstractProducerContextArgMapper httpRequestCreator = 
(AbstractProducerContextArgMapper)invocation.getHandlerContext().get(RestConst.HTTP_REQUEST_CREATOR);
+   if(httpRequestCreator != null){
+     HttpServletRequest req = 
(HttpServletRequest)httpRequestCreator.createContextArg(invocation);
+     System.out.println(req.getRemoteHost());
+   }
+   ```
+   
+   实际场景是拿最外层的地址，所以应该是LBä¼ å…
¥åˆ°edgeservice，edgeService再放到context外下传递。
+   
+* **Q: ServiceComb不支持泛型**
+
+   A: 
明确不支持，需要修改接口，接口修改后需要修改版本号，以å
…consumer还是使用旧的版本。
+
+* **Q: ServiceComb对handler描述**
+
+   A: consumer默认的handler是simpleLB，没有é…
ç½®çš„时候handler链会使用这个，如果é…
ç½®äº†handler，里面一定要包
含lb的handler，否则调用报错，需要在文档里面进行说明。
+
+* **Q: ServiceComb日志替换**
+
+   A: CSE 
java-chassis日志推荐方式是在启动的时候使用Log4jUtils.init\(\)，直接使用推荐的Log4j来做日志管理，但是有些场景不想用log4j，比如想使用log4j2或è€
…logback，下面以log4j2为例简单介绍下步骤：
+
+   1. 在代码里面不要使用Log4jUtils.init\(\)；
+   2. 去掉log4j的配置文件（不删掉也没关系，因
为不会使用）；
+   3. exclude掉CSE框架引入的log4j，例如：
+      ```xml
+      <dependency>
+          <groupId>io.servicecomb</groupId>
+          <artifactId>provider-springmvc</artifactId>
+          <exclusions>
+              <exclusion>
+                  <groupId>log4j</groupId>
+                  <artifactId>log4j</artifactId>
+              </exclusion>
+          </exclusions>
+      </dependency>
+      ```
+   4. 引入log4j2的依赖
+   
+      ```xml
+      <dependency>    
+          <groupId>org.apache.logging.log4j</groupId>
+          <artifactId>log4j-slf4j-impl</artifactId>
+      </dependency>
+      <dependency>
+          <groupId>org.apache.logging.log4j</groupId>
+          <artifactId>log4j-api</artifactId>
+      </dependency>
+      <dependency>
+          <groupId>org.apache.logging.log4j</groupId>
+          <artifactId>log4j-core</artifactId>
+      </dependency>
+      ```
+   
+      如果没有版本依赖管理，还需要填写上版本号。
+   
+   5. 加入log4j2的配置文件log4j2.xml，å…
³äºŽè¿™ä¸ªè¯·æŸ¥çœ‹å®˜æ–¹è¯´æ˜Žï¼Œä¾‹å¦‚：
+   
+      ```xml
+       <?xml version="1.0" encoding="UTF-8"?>
+       <!--日志级别以及优先级排序: OFF > FATAL > ERROR > WARN > 
INFO > DEBUG > TRACE > ALL -->
+       <!--Configuration后面的status，这个用于设置log4j2自身内
部的信息输出，可以不设置，当设置成trace时，你
会看到log4j2内部各种详细输出-->
+       <!--monitorInterval：Log4j能够自动检测修改配置 
文件和重新配置本身，设置间隔秒数-->
+       <configuration status="WARN" monitorInterval="30">
+           <!--先定义所有的appender-->
+           <appenders>
+           <!--这个输出控制台的配置-->
+               <console name="Console" target="SYSTEM_OUT">
+               <!--输出日志的格式-->
+                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
+               </console>
+               
<!--文件会打印出所有信息，这个log每次运行程序会自动清
空，由append属性决定，这个也挺有用的，适合临时测试用-->
+               <File name="log" fileName="log/test.log" append="false">
+                  <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} 
%L %M - %msg%xEx%n"/>
+               </File>
+               <!-- 
这个会打印出所有的info及以下级别的信息，每次大小超
过size，则这size大小的日志会自动存å…
¥æŒ‰å¹´ä»½-月份建立的文件夹下面并进行压缩，作为存档-->
+               <RollingFile name="RollingFileInfo" 
fileName="${sys:user.home}/logs/info.log"
+                            
filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log">
+                   
<!--控制台只输出level及以上级别的信息（onMatch），å…
¶ä»–的直接拒绝（onMismatch）-->
+                   <ThresholdFilter level="info" onMatch="ACCEPT" 
onMismatch="DENY"/>
+                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
+                   <Policies>
+                       <TimeBasedTriggeringPolicy/>
+                       <SizeBasedTriggeringPolicy size="100 MB"/>
+                   </Policies>
+               </RollingFile>
+               <RollingFile name="RollingFileWarn" 
fileName="${sys:user.home}/logs/warn.log"
+                            
filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/warn-%d{yyyy-MM-dd}-%i.log">
+                   <ThresholdFilter level="warn" onMatch="ACCEPT" 
onMismatch="DENY"/>
+                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
+                   <Policies>
+                       <TimeBasedTriggeringPolicy/>
+                       <SizeBasedTriggeringPolicy size="100 MB"/>
+                   </Policies>
+                   <!-- 
DefaultRolloverStrategy属性如不设置，则默认为最多同一文件夹下7个文件，这里设置了20
 -->
+                   <DefaultRolloverStrategy max="20"/>
+               </RollingFile>
+               <RollingFile name="RollingFileError" 
fileName="${sys:user.home}/logs/error.log"
+                            
filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log">
+                   <ThresholdFilter level="error" onMatch="ACCEPT" 
onMismatch="DENY"/>
+                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
+                   <Policies>
+                       <TimeBasedTriggeringPolicy/>
+                       <SizeBasedTriggeringPolicy size="100 MB"/>
+                   </Policies>
+               </RollingFile>
+           </appenders>
+           <!--然后定义logger，只有定义了logger并引å…
¥çš„appender，appender才会生效-->
+           <loggers>
+               <!--过滤掉spring和mybatis的一些无用的DEBUG信息-->
+               <logger name="org.springframework" level="INFO"></logger>
+               <logger name="org.mybatis" level="INFO"></logger>
+               <root level="all">
+                   <appender-ref ref="Console"/>
+                   <appender-ref ref="RollingFileInfo"/>
+                   <appender-ref ref="RollingFileWarn"/>
+                   <appender-ref ref="RollingFileError"/>
+               </root>
+           </loggers>
+       </configuration>
+      ```
+   
+   6. 启动服务进行验证
+
+* **Q: netty版本问题**
+
+   A: netty3和netty4是完全不同的三方件，因为坐æ 
‡è·Ÿpackage都不相同，所以可以å…
±å­˜ï¼Œä½†æ˜¯è¦æ³¨æ„å°ç‰ˆæœ¬é—®é¢˜ï¼Œå°ç‰ˆæœ¬å¿…须使用CSE的版本。
+
+* **Q: 服务超时设置**
+
+   A: 在微服务描述文件（microservice.yaml）中添加如下配置：
+
+   ```yaml
+   cse:
+     request:
+       timeout: 30000
+   ```

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_faqs/cn/huawei-cloud-faq.md
----------------------------------------------------------------------
diff --git a/_faqs/cn/huawei-cloud-faq.md b/_faqs/cn/huawei-cloud-faq.md
new file mode 100644
index 0000000..e66a69e
--- /dev/null
+++ b/_faqs/cn/huawei-cloud-faq.md
@@ -0,0 +1,41 @@
+---
+title: "华为公有云常见问题"
+lang: cn
+ref: huawei-cloud-faq
+permalink: /cn/faqs/faqs-huawei-cloud/
+excerpt: "华为公有云常见问题"
+last_modified_at: 2017-10-29T15:01:43-04:00
+redirect_from:
+  - /theme-setup/
+---
+
+1. **Q: 在使用华为公有云时，设置镜像的æ 
‡ç­¾åªéœ€è¦å’Œä¸Šä¸€æ¬¡çš„标签不一样还是要和之前的都不一æ 
·ï¼Ÿ**
+
+   A: 
由于Docker本身的机制中并没有实现每次都从远端拉取镜像的功能，å›
 
此，只要本地中有一个版本的镜像存在而且每次都通过该版本的æ
 ‡ç­¾æ¥è®¿é—®é•œåƒæ—¶ï¼Œè¯»å–的镜像则为最开始上传
的镜像，后续对该标签镜像的更新并不会在本地生效。因
此现有两种解决方案：
+
+   (1) 新上传的镜像的标签和之前的都不一样。
+
+   (2) 登录到后台去将原版本标签的镜像删除。
+
+   拓展：如果使用了华为å…
¬æœ‰äº‘上面的编排功能，则可以通过设置imagePullPolicy为Always避å
…è¯¥é—®é¢˜ã€‚
+   
+2. **Q: 华为公有云运行时报错：WARN 
com.huawei.paas.monitor.DataFactory: Upload monitor data error. 使用的é…
ç½®ä¸ºï¼š**
+
+   ```yaml
+   cse:
+     monitor:
+       handler:
+         chain:
+           Provider:
+             default: bizkeeper-provider
+   ```
+
+   A: 这个是é…
ç½®æ–‡ä»¶çš„错误，handler应该是在cse的下一级而不是monitor的下一级，正确的é
…ç½®æ˜¯ï¼š
+
+   ```yaml
+   cse:
+     handler:
+       chain:
+         Provider:
+           default: bizkeeper-provider
+   ```

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_faqs/faq.md
----------------------------------------------------------------------
diff --git a/_faqs/faq.md b/_faqs/faq.md
new file mode 100644
index 0000000..9738dab
--- /dev/null
+++ b/_faqs/faq.md
@@ -0,0 +1,59 @@
+---
+title: "FAQ"
+lang: en
+ref: common-faq
+permalink: /faqs/ 
+excerpt: "FAQ"
+last_modified_at: 2017-10-29T10:01:43-04:00
+---
+
+1. **Q: What need to be cautious when using Java-Chassis?**
+
+   A: There are a few restrictions when using Java-Chassis:
+   * Before version 0.3.0-SNAPSHOT, it does not support annotations like 
`@GetMapping`.
+   * When using the same HTTP request method, e.g. GET, the method name need 
to be unique as it will become operation ID when swagger generates contracts.
+   * Class and method name need to be public.
+
+2. **Q: When using the *spring-boot-starter-provider* dependency, property 
like `spring.main.web-environment` not working in *application.yml* file.**
+
+   A: When you need both the starter provider dependency and the servlet, you 
need to declare `spring.main.web-environment` in *application.properties* file 
or declare it in *application.yml* file and create an empty 
*application.properties* file.
+
+3. **Q: What's the dependency differences between gateway and other 
microservices?**
+
+   ```xml
+   <groupId>io.servicecomb</groupId>
+   <artifactId>spring-boot-starter-provider</artifactId>
+   ```
+
+   A: Gateway depends on not only the `spring-boot-starter-provider`, but also 
the `spring-boot-starter-discovery`. This can refer to the *manger* 
implementation of 
[LinuxCon-Beijing-Workshop](https://github.com/ServiceComb/LinuxCon-Beijing-WorkShop).
+
+4. **Q: Do gateway need to configure assembly like the other microservices? Is 
*/maven/gateway* the default path of the docker maven plugin?**
+
+   A: Yes. Docker maven plugin relies on the assembly files to generate docker 
image. */maven* is the default path of docker maven plugin and */gateway* is 
the path defined in the assembly file.
+
+5. **Q: Are there any restrictions of the return type of our API? Should it be 
the type of ResponseEntity?**
+
+   A: No, examples can refer to [the implementation of 
integration-test](https://github.com/ServiceComb/java-chassis/blob/master/integration-tests/springmvc-tests/src/test/java/io/servicecomb/demo/springmvc/tests/SpringMvcIntegrationTestBase.java#L145)
 in java-chassis.
+
+6. **Q: Our API can not be accessed after microservices are up. It just 
returns *404 Not Found*. The codes we use is as follows:**
+
+   ```java
+   @RestController
+   @RestSchema(schemaId = "worker")
+   public class WorkerController {
+     @RequestMapping(value="/count", method=RequestMethod.GET)
+     public int getWorkerNumbers() {
+       ...
+     }
+   }
+   ```
+
+   A: Without specifying the base path, ServiceComb will use the classname as 
the base path. Hence, the path should be `/WorkerController/count` in the 
previous code. If you want to access path like `/count`, you need to specify 
base path as `/` as follows:
+   ```java
+   @RequestMapping(value = "/")
+   public class WorkerController {}
+   ```
+
+7. **Q: What\'s the default base path if I have not declared the value of 
RequestMapping annotation?**
+
+   A: Supposed the class name of your controller is *HelloController*, the 
base path is /HelloController.

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_faqs/huawei-cloud-faq.md
----------------------------------------------------------------------
diff --git a/_faqs/huawei-cloud-faq.md b/_faqs/huawei-cloud-faq.md
new file mode 100644
index 0000000..d93d971
--- /dev/null
+++ b/_faqs/huawei-cloud-faq.md
@@ -0,0 +1,41 @@
+---
+title: "Huawei Cloud FAQ"
+lang: en
+ref: huawei-cloud-faq
+permalink: /faqs/faqs-huawei-cloud/
+excerpt: "Huawei Cloud FAQ"
+last_modified_at: 2017-10-29T10:01:43-04:00
+redirect_from:
+  - /theme-setup/
+---
+
+1. **Q: When we push images to Huawei Public Cloud, what needs to be careful 
about the image tag?**
+
+   A:  It needs to be different with all uploaded images. As Docker does not 
pull image from remote every time it starts up a container. Hence, the Docker 
does not know whether the image updated or not. There are two solutions for 
this:
+
+   (1) Use different image tag every time you upload a image.
+
+   (2) Delete the image in the backend manually.
+
+   P.S. If you use the Huawei Cloud's orchestration, you can avoid this by 
setting *imagePullPolicy* to *Always*.
+
+2. **Q: We encountered this error when using Huawei Public Cloud: *WARN 
com.huaewi.paas.monitor.DataFactory: Upload monitor data error.* The 
configuration we use is as follows:**
+
+   ```yaml
+   cse:
+     monitor:
+       handler:
+         chain:
+           Provider:
+             default: bizkeeper-provider
+   ```
+
+   A: There are mistakes in your configuration files. `handler` should be the 
child of `cse` instead of `monitor`. The right configuration should be as 
follows:
+
+   ```yaml
+   cse:
+     handler:
+       chain:
+         Provider:
+           default: bizkeeper-provider
+   ```

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_users/cn/faq.md
----------------------------------------------------------------------
diff --git a/_users/cn/faq.md b/_users/cn/faq.md
deleted file mode 100644
index bc00ef6..0000000
--- a/_users/cn/faq.md
+++ /dev/null
@@ -1,415 +0,0 @@
----
-title: "常见问题"
-lang: cn
-ref: faq
-permalink: /cn/users/faq/
-excerpt: "常见问题"
-last_modified_at: 2017-08-15T15:01:43-04:00
-redirect_from:
-  - /theme-setup/
----
-
-* **Q: 使用Java-Chassis这个框架时有什么需要注意的地方？**
-
-   A: 使用Java-Chassis有以下这些限制：
-   (1) 0.3.0-SNAPSHOT之前的版本不支持类似`@GetMapping`这样的æ 
‡æ³¨ã€‚
-   (2) 所用到的HTTP请求方法一æ 
·æ—¶ï¼Œå¦‚GET，则方法名不能重载。这是由于生成契约时方法名会作为å
…¶Operation ID，所以要保证其唯一性。
-   (3) 方法和类必须是public的。
-
-* **Q: 
使用*spring-boot-starter-provider*这个依赖时，在*application.yml*文件中声明的`spring.main.web-application`属性并没有生效？**
-
-   A: 
使用*starter-provider*这个依赖时，如果用到了servlet这种方式时，需要在*application.properties*这个文件引å
…¥`spring.main.web-application=true`这样的属性或者
在*application.yml*文件中声明，但是此时需要新建一个*application.properties*的文件，å
…¶å†…容可以为空。
-
-* **Q: 网关依赖的jar和其他微服务的一样吗？**
-
-   ```xml
-   <groupId>io.servicecomb</groupId>
-   <artifactId>spring-boot-starter-provider</artifactId>
-   ```
-
-   A: 网å…
³é™¤äº†è¦ä¾èµ–`spring-boot-starter-provider`之外还要依赖`spring-boot-starter-discovery`，可以参考[LinuxCon-Beijing-Workshop](https://github.com/ServiceComb/LinuxCon-Beijing-WorkShop)中manager的实现。
-
-* **Q: 网关需要像其他微服务一样配置assembly吗？å…
¶ä¸­çš„/maven/gateway这个路径是docker maven plugin默认的吗？**
-
-   A: 需要，由于项目现在使用的是spring-boot的打包
方式，docker maven plugin也是依赖打包
生成的文件来生成docker镜像的。/maven这个路径是docker maven 
plugin指定的，而gateway这个路径是在assembly中指定的。
-
-* **Q: 服务接口的返回类型可以是任意类型吗？还是必
须是responseEntity？**
-
-   A: 可以，å…
·ä½“可以参考java-chassis的[integration-test的实现](https://github.com/ServiceComb/java-chassis/blob/master/integration-tests/springmvc-tests/src/test/java/io/servicecomb/demo/springmvc/tests/SpringMvcIntegrationTestBase.java#L145)。
-
-* **Q: 微服务启动后，无法正确调用接口，使用的代码为：**
-
-   ```java
-   @RestController
-   @RestSchema(schemaId = "worker")
-   public class WorkerController {
-     @RequestMapping(value="/count", method=RequestMethod.GET)
-     public int getWorkerNumbers() {
-       ...
-     }
-   }
-   ```
-
-   A: 在没有指明根路径的情况下，默认会使用类名作为其æ 
¹è·¯å¾„，即上述代ç 
ä¸­å¯è®¿é—®çš„路径应为`/WorkerController/count`。如果想要实现`/count`这æ
 ·çš„访问，则要指明根路径：
-
-   ```java
-   @RequestMapping(value = "/")
-   public class WorkerController {}
-   ```
-
-* **Q: 如果没有指定RequestMapping这个æ 
‡æ³¨çš„value时，默认的基本路径是什么？**
-
-   A: 假设你
的Controller类名为*HelloController*，那么基本路径就是/HelloController。
-
-* **Q: 在eclipse下修改了microservice.yamlé…
ç½®æ–‡ä»¶ä¸‹çš„端口号，启动程序后，端口号没生效？**
-
-   A: 需要单独导入sample项目，如果导å…
¥æ•´ä¸ªServiceComb-Java-Chassis项目，由于sample目录不在ServiceComb-Java-Chassis模块中，IDE不会对sample进行编译,eclipse下并没有提示错误信息，IDEA下会有提示信息。å›
 æ­¤eclipse启动sample的demo会发现修改了端口没有生效。
-
-* **Q: 如何自定义某个Java方法对应的REST接口里的HTTP Status 
Code？**
-
-   A: 
对于正常的返回值，可以通过SwaggerAnnotation实现，例如：
-
-   ```java
-   @ApiResponse(code = 300, response = String.class, message = "")
-   public int test(int x) {
-     return 100;
-   }
-   ```
-   
-   
对于异常的返回值，可以通过抛出自定义的InvocationException实现，例如：、
-   
-   ```java
-   public String testException(int code) {
-     String strCode = String.valueOf(code);
-       switch (code) {
-         case 200:
-           return strCode;
-         case 456:
-           throw new InvocationException(code, strCode, strCode + " error");
-         case 556:
-           throw new InvocationException(code, strCode, Arrays.asList(strCode 
+ " error"));
-         case 557:
-           throw new InvocationException(code, strCode, 
Arrays.asList(Arrays.asList(strCode + " error")));
-         default:
-           break;
-       }
-   
-     return "not expected";
-   }
-   ```
-
-
-* **Q: 如何定制自己微服务的日志配置?**
-
-   A: 
ServiceComb不绑定日志器，只是使用了slf4j，用户可以自由选择log4j/log4j2/logback等等。ServiceComb提供了一个log4j的扩展，在æ
 ‡å‡†log4j的基础上，支持log4j的properties文件的增量配置。
-   * 默认以规则："classpath\*:config/log4j.properties"加载配置文件
-   * 实际
会搜索出classpath中所有的```config/log4j.properties和config/log4j.*.properties```,
 
从搜索出的文件中切出```\*```的部分，进行alpha排序，然后按顺序åŠ
 è½½ï¼Œæœ€åŽåˆæˆçš„文件作为log4j的配置文件。
-   * 
如果要使用ServiceComb的log4j扩展，则需要调用Log4jUtils.init，否则完å
…¨æŒ‰æ ‡å‡†çš„日志器的规则使用。
-
-* **Q: 当服务é…
ç½®äº†å¤šä¸ªtransport的时候，在运行时是怎么选择使用哪个transport的？**
-
-   A: 
-   * 
ServiceComb的consumer、transport、handler、producer之间是解耦的，各功能之间通过契约定义联合在一起工作的，即：
-      
consumer使用透明rpc，还是springmvc开发与使用highway，还是RESTful在网络上ä¼
 è¾“没有关系与producer是使用透明rpc，还是jaxrs，或者
是springmvc开发，也没有å…
³ç³»handler也不感知，业务开发方式以及传输方式
-   
-   * 
consumer访问producer，在运行时的transport选择上，总规则为：
-      
consumer的transport与producer的endpoint取交集，如果交集后，还有多个transport可选择，则轮流使用
-   
-      分解开来，存在以下场景：
-   
-   * 当一个微服务producer同时开放了highway以及RESTful的endpoint
-      * consumer进程中只部署了highway transport 
jar，则只会访问producer的highway endpoint
-      * consumer进程中只部署了RESTful transport 
jar，则只会访问producer的RESTful endpoint
-      * consumer进程中，同时部署了highway和RESTful transport 
jar，则会轮流访问producer的highway、RESTful endpoint
-   
-      
如果，此时consumer想固定使用某个transport访问producer，可以在consumer进程的microservice.yaml中é
…ç½®ï¼ŒæŒ‡å®štransport的名称:
-
-      ```yaml
-      servicecomb:
-        references:
-          <service_name>:
-            transport: highway
-      ```
-   
-   * 当一个微服务producer只开放了highway的endpoint
-      * consumer进程只部署了highway transport 
jar，则正常使用highway访问
-      * consumer进程只部署了RESTful transport jar，则无法访问
-      * consumer进程同时部署了highway和RESTful transport 
jar，则正常使用highway访问
-   
-   * 当一个微服务producer只开放了RESTful的endpoint
-      * consumer进程只部署了highway transport jar，则无法访问
-      * consumer进程只部署了RESTful transport 
jar，则正常使用RESTful访问
-      * consumer进程同时部署了highway和RESTful transport 
jar，则正常使用RESTful访问
-
-* **Q: swagger body参数类型定义错误，导致服务中心注册的内
容没有类型信息**
-
-   **现象描述:**
-   
-   定义如下接口，将参数放到body传递
-   
-   ```yaml
-   /testInherate:
-       post:
-         operationId: "testInherate"
-         parameters:
-         - in: "body"
-           name: "xxxxx"
-           required: false
-           type: string
-         responses:
-           200:
-             description: "response of 200"
-             schema:
-               $ref: "#/definitions/ReponseImpl"
-   ```
-   
-   
采用上面方式定义接口。在服务注册以后，从服务中心查询下来的接口type:
 string 丢失，变成了：
-   
-   ```yaml
-   /testInherate:
-       post:
-         operationId: "testInherate"
-         parameters:
-         - in: "body"
-           name: "xxxxx"
-           required: false
-         responses:
-           200:
-             description: "response of 200"
-             schema:
-               $ref: "#/definitions/ReponseImpl"
-   ```
-   
-   如果客户端没有放置swagger，还会报告如下异常：
-   
-   ```text
-      Caused by: java.lang.ClassFormatError: Method "testInherate" in class ? 
has illegal signature "
-   ```
-   
-   
A：定义body参数的类型的时候，需要使用schema，不能直接使用type。
-   
-   ```yaml
-   /testInherate:
-       post:
-         operationId: "testInherate"
-         parameters:
-         - in: "body"
-           name: "request"
-           required: false
-           schema:
-             type: string
-         responses:
-           200:
-             description: "response of 200"
-             schema:
-               $ref: "#/definitions/ReponseImpl"
-   ```
-
-* **Q: ServiceComb微服务框架服务调用是否使用长连接?**
-
-   A: http使用的是长连接（有超
时时间），highway方式使用的是长连接（一直保持）。
-   
-* **Q: 服务断连服务中心注册信息是否自动删除**
-
-   A: 
服务中心心跳检测到服务实例不可用，只会移除服务实例信息，服务的静态数据不会移除。
-
-* **Q: 
如果使用tomcat方式集成ServiceComb微服务框架，如何实现服务注册**
-
-   A: 如果使用cse sdk 
servlet方式（使用transport-rest-servlet依赖）制作为war包
部署到tomcat，需要保证，服务描述文件（microservice.yaml）中rest端口é
…ç½®å’Œå¤–置容器一致才能实现该服务的正确注册。否则无
法感知tomcat开放端口。
-
-* **Q: 
如果使用tomcat方式集成CSE微服务框架，服务注册的时候如何将waråŒ
…部署的上下文注册到服务中心**
-
-   A: 发布服务接口的时候需要将war包
部署的上下文（context）放在baseurl最前面，这æ 
·æ‰èƒ½ä¿è¯æ³¨å†Œåˆ°æœåŠ¡ä¸­å¿ƒçš„路径是完整的路径（包
含了上下文）。实例：
-
-   ```java
-   @path(/{context}/xxx)
-   class ServiceA
-   ```
-   
-* **Q: ServiceComb微服务框架如何实现数据多个微服务间透传**
-
-   A:
-   透传数据塞入：
-   
-   ```java
-   CseHttpEntity<xxxx.class> httpEntity = new CseHttpEntity<>(xxx);
-   //透传内容
-   httpEntity.addContext("contextKey","contextValue");
-   ResponseEntity<String> responseEntity = 
RestTemplateBuilder.create().exchange("cse://springmvc/springmvchello/sayhello",HttpMethod.POST,httpEntity,String.class);
-   ```
-   
-   透传数据获取：
-   
-   ```java
-   @Override
-   @RequestMapping(path="/sayhello",method = RequestMethod.POST)
-   public String sayHello(@RequestBody Person person,InvocationContext 
context){
-     //透传数据获取
-     context.getContext();
-     return "Hello person " + person.getName();
-   }
-   ```
-
-* **Q: ServiceComb微服务框架服务如何自定义返回状态码?**
-
-   A:
-   ```java
-   @Override
-   @RequestMapping(path = "/sayhello",method = RequestMethod.POST)
-   public String sayHello(@RequestBody Person person){
-     InvocationContext context = ContextUtils.getInvocationContext();
-     //自定义状态码
-     context.setStatus(Status.CREATED);
-     return "Hello person "+person.getName();
-   }
-   ```
-   
-* **Q: ServiceComb body Model部分暴露**
-
-   A: 一个接口对应的body对象中，可能有一些属性是内
部的，不想开放出去，生成schema的时候不要带出去，使用：
-   
-   ```java
-   @ApiModelProperty(hidden = true)
-   ```
-   
-* **Q: ServiceComb框架获取远端consumer的地址**
-
-   A: 如果使用http 
rest方式（使用transport-rest-vertx依赖）可以用下面这种方式获取：
-
-   ```java
-   AbstractProducerContextArgMapper httpRequestCreator = 
(AbstractProducerContextArgMapper)invocation.getHandlerContext().get(RestConst.HTTP_REQUEST_CREATOR);
-   if(httpRequestCreator != null){
-     HttpServletRequest req = 
(HttpServletRequest)httpRequestCreator.createContextArg(invocation);
-     System.out.println(req.getRemoteHost());
-   }
-   ```
-   
-   实际场景是拿最外层的地址，所以应该是LBä¼ å…
¥åˆ°edgeservice，edgeService再放到context外下传递。
-   
-* **Q: ServiceComb不支持泛型**
-
-   A: 
明确不支持，需要修改接口，接口修改后需要修改版本号，以å
…consumer还是使用旧的版本。
-
-* **Q: ServiceComb对handler描述**
-
-   A: consumer默认的handler是simpleLB，没有é…
ç½®çš„时候handler链会使用这个，如果é…
ç½®äº†handler，里面一定要包
含lb的handler，否则调用报错，需要在文档里面进行说明。
-
-* **Q: ServiceComb日志替换**
-
-   A: CSE 
java-chassis日志推荐方式是在启动的时候使用Log4jUtils.init\(\)，直接使用推荐的Log4j来做日志管理，但是有些场景不想用log4j，比如想使用log4j2或è€
…logback，下面以log4j2为例简单介绍下步骤：
-
-   1. 在代码里面不要使用Log4jUtils.init\(\)；
-   2. 去掉log4j的配置文件（不删掉也没关系，因
为不会使用）；
-   3. exclude掉CSE框架引入的log4j，例如：
-      ```xml
-      <dependency>
-          <groupId>io.servicecomb</groupId>
-          <artifactId>provider-springmvc</artifactId>
-          <exclusions>
-              <exclusion>
-                  <groupId>log4j</groupId>
-                  <artifactId>log4j</artifactId>
-              </exclusion>
-          </exclusions>
-      </dependency>
-      ```
-   4. 引入log4j2的依赖
-   
-      ```xml
-      <dependency>    
-          <groupId>org.apache.logging.log4j</groupId>
-          <artifactId>log4j-slf4j-impl</artifactId>
-      </dependency>
-      <dependency>
-          <groupId>org.apache.logging.log4j</groupId>
-          <artifactId>log4j-api</artifactId>
-      </dependency>
-      <dependency>
-          <groupId>org.apache.logging.log4j</groupId>
-          <artifactId>log4j-core</artifactId>
-      </dependency>
-      ```
-   
-      如果没有版本依赖管理，还需要填写上版本号。
-   
-   5. 加入log4j2的配置文件log4j2.xml，å…
³äºŽè¿™ä¸ªè¯·æŸ¥çœ‹å®˜æ–¹è¯´æ˜Žï¼Œä¾‹å¦‚：
-   
-      ```xml
-       <?xml version="1.0" encoding="UTF-8"?>
-       <!--日志级别以及优先级排序: OFF > FATAL > ERROR > WARN > 
INFO > DEBUG > TRACE > ALL -->
-       <!--Configuration后面的status，这个用于设置log4j2自身内
部的信息输出，可以不设置，当设置成trace时，你
会看到log4j2内部各种详细输出-->
-       <!--monitorInterval：Log4j能够自动检测修改配置 
文件和重新配置本身，设置间隔秒数-->
-       <configuration status="WARN" monitorInterval="30">
-           <!--先定义所有的appender-->
-           <appenders>
-           <!--这个输出控制台的配置-->
-               <console name="Console" target="SYSTEM_OUT">
-               <!--输出日志的格式-->
-                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
-               </console>
-               
<!--文件会打印出所有信息，这个log每次运行程序会自动清
空，由append属性决定，这个也挺有用的，适合临时测试用-->
-               <File name="log" fileName="log/test.log" append="false">
-                  <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} 
%L %M - %msg%xEx%n"/>
-               </File>
-               <!-- 
这个会打印出所有的info及以下级别的信息，每次大小超
过size，则这size大小的日志会自动存å…
¥æŒ‰å¹´ä»½-月份建立的文件夹下面并进行压缩，作为存档-->
-               <RollingFile name="RollingFileInfo" 
fileName="${sys:user.home}/logs/info.log"
-                            
filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log">
-                   
<!--控制台只输出level及以上级别的信息（onMatch），å…
¶ä»–的直接拒绝（onMismatch）-->
-                   <ThresholdFilter level="info" onMatch="ACCEPT" 
onMismatch="DENY"/>
-                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
-                   <Policies>
-                       <TimeBasedTriggeringPolicy/>
-                       <SizeBasedTriggeringPolicy size="100 MB"/>
-                   </Policies>
-               </RollingFile>
-               <RollingFile name="RollingFileWarn" 
fileName="${sys:user.home}/logs/warn.log"
-                            
filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/warn-%d{yyyy-MM-dd}-%i.log">
-                   <ThresholdFilter level="warn" onMatch="ACCEPT" 
onMismatch="DENY"/>
-                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
-                   <Policies>
-                       <TimeBasedTriggeringPolicy/>
-                       <SizeBasedTriggeringPolicy size="100 MB"/>
-                   </Policies>
-                   <!-- 
DefaultRolloverStrategy属性如不设置，则默认为最多同一文件夹下7个文件，这里设置了20
 -->
-                   <DefaultRolloverStrategy max="20"/>
-               </RollingFile>
-               <RollingFile name="RollingFileError" 
fileName="${sys:user.home}/logs/error.log"
-                            
filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log">
-                   <ThresholdFilter level="error" onMatch="ACCEPT" 
onMismatch="DENY"/>
-                   <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - 
%m%n"/>
-                   <Policies>
-                       <TimeBasedTriggeringPolicy/>
-                       <SizeBasedTriggeringPolicy size="100 MB"/>
-                   </Policies>
-               </RollingFile>
-           </appenders>
-           <!--然后定义logger，只有定义了logger并引å…
¥çš„appender，appender才会生效-->
-           <loggers>
-               <!--过滤掉spring和mybatis的一些无用的DEBUG信息-->
-               <logger name="org.springframework" level="INFO"></logger>
-               <logger name="org.mybatis" level="INFO"></logger>
-               <root level="all">
-                   <appender-ref ref="Console"/>
-                   <appender-ref ref="RollingFileInfo"/>
-                   <appender-ref ref="RollingFileWarn"/>
-                   <appender-ref ref="RollingFileError"/>
-               </root>
-           </loggers>
-       </configuration>
-      ```
-   
-   6. 启动服务进行验证
-
-* **Q: netty版本问题**
-
-   A: netty3和netty4是完全不同的三方件，因为坐æ 
‡è·Ÿpackage都不相同，所以可以å…
±å­˜ï¼Œä½†æ˜¯è¦æ³¨æ„å°ç‰ˆæœ¬é—®é¢˜ï¼Œå°ç‰ˆæœ¬å¿…须使用CSE的版本。
-
-* **Q: 服务超时设置**
-
-   A: 在微服务描述文件（microservice.yaml）中添加如下配置：
-
-   ```yaml
-   cse:
-     request:
-       timeout: 30000
-   ```

http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/455450a0/_users/cn/huawei-cloud-faq.md
----------------------------------------------------------------------
diff --git a/_users/cn/huawei-cloud-faq.md b/_users/cn/huawei-cloud-faq.md
deleted file mode 100644
index 42cba46..0000000
--- a/_users/cn/huawei-cloud-faq.md
+++ /dev/null
@@ -1,41 +0,0 @@
----
-title: "华为公有云常见问题"
-lang: cn
-ref: huawei-cloud-faq
-permalink: /cn/users/huawei-cloud-faq/
-excerpt: "华为公有云常见问题"
-last_modified_at: 2017-08-15T15:01:43-04:00
-redirect_from:
-  - /theme-setup/
----
-
-1. **Q: 在使用华为公有云时，设置镜像的æ 
‡ç­¾åªéœ€è¦å’Œä¸Šä¸€æ¬¡çš„标签不一样还是要和之前的都不一æ 
·ï¼Ÿ**
-
-   A: 
由于Docker本身的机制中并没有实现每次都从远端拉取镜像的功能，å›
 
此，只要本地中有一个版本的镜像存在而且每次都通过该版本的æ
 ‡ç­¾æ¥è®¿é—®é•œåƒæ—¶ï¼Œè¯»å–的镜像则为最开始上传
的镜像，后续对该标签镜像的更新并不会在本地生效。因
此现有两种解决方案：
-
-   (1) 新上传的镜像的标签和之前的都不一样。
-
-   (2) 登录到后台去将原版本标签的镜像删除。
-
-   拓展：如果使用了华为å…
¬æœ‰äº‘上面的编排功能，则可以通过设置imagePullPolicy为Always避å
…è¯¥é—®é¢˜ã€‚
-   
-2. **Q: 华为公有云运行时报错：WARN 
com.huawei.paas.monitor.DataFactory: Upload monitor data error. 使用的é…
ç½®ä¸ºï¼š**
-
-   ```yaml
-   cse:
-     monitor:
-       handler:
-         chain:
-           Provider:
-             default: bizkeeper-provider
-   ```
-
-   A: 这个是é…
ç½®æ–‡ä»¶çš„错误，handler应该是在cse的下一级而不是monitor的下一级，正确的é
…ç½®æ˜¯ï¼š
-
-   ```yaml
-   cse:
-     handler:
-       chain:
-         Provider:
-           default: bizkeeper-provider
-   ```

Reply via email to