README_ZH.md

# Dubbo控制台

[![Build Status](https://travis-ci.org/apache/incubator-dubbo-ops.svg?branch=master)](https://travis-ci.org/apache/incubator-dubbo-ops)
[![codecov](https://codecov.io/gh/apache/incubator-dubbo-ops/branch/master/graph/badge.svg)](https://codecov.io/gh/apache/incubator-dubbo-ops)
![license](https://img.shields.io/github/license/apache/incubator-dubbo-ops.svg)

English version goes [here](README.md).

### 页面截图

![index](https://raw.githubusercontent.com/apache/incubator-dubbo-ops/develop/doc/images/index.png)

### 前端部分

- 使用[Vue.js](https://vuejs.org)作为javascript框架，[Vuetify](https://vuetifyjs.com)作为UI框架
- [dubbo-admin-frontend/README.md](dubbo-admin-frontend/README.md)中有更详细的介绍

### 后端部分

* 配置文件  

> - `application.properties`  
>   公共配置文件
> - `application-production.properties` (默认配置)  
>   生产环境的配置文件
> - `application-develop.properties`  
>   开发环境的配置文件
> 


### 生产环境配置  

1. 下载代码: `git clone https://github.com/apache/incubator-dubbo-ops.git`
2. 在 `dubbo-admin-backend/src/resources/application-production.properties`中指定注册中心地址
3. 构建   

    * 通过命令行来指定maven active file  
    
    > - `mvn clean package -Pproduction` 激活生产环境的配置文件(`application-production.properties`)
4. 启动 `mvn --projects dubbo-admin-backend spring-boot:run`
5. 访问 `http://localhost:8080`


### 开发环境配置
* IDE设置  

   * 在Intellij Idea中选择maven profile配置文件 

      1. 在引入项目时选择配置文件  
         1. 在 **Import from Maven** 页面，激活`develop`配置文件: 
      ![profile](https://raw.githubusercontent.com/apache/incubator-dubbo-ops/develop/doc/images/profile-idea.jpg)
         2. 选择 **Next** 完成项目引入

      2.  在Maven项目工具窗口中选择需要激活的maven profile文件。
          1. 打开Maven项目工具窗口。  
          2. 点击`Profiles`节点。  
          3. 点击选择`develop`配置文件。
      
    * 在Eclipse中选择maven profile配置文件
        1. 引入项目
        2. 在 **Project Explorer**视图中, 右键单击 `dubbo-admin-backend`模块。
        3. 选择 **Maven**->**Select Maven Profiles**。
        4. 选择`develop`配置文件。
        ![profile-eclipse](https://raw.githubusercontent.com/apache/incubator-dubbo-ops/develop/doc/images/profile-eclipse.jpg)
* 运行`dubbo admin backend`  
   `dubbo admin backend`是一个标准的spring boot项目, 可以在任何java IDE中运行它
* 运行`dubbo admin frontend`  
  `dubbo admin frontend`由npm管理和构建，在开发环境中，可以单独运行: `npm run dev`
* 页面访问
  访问 `http://localhost:8081`, 由于前后端分开部署，前端支持热加载，任何页面的修改都可以实时反馈，不需要重启应用。             
 * 跨域问题
    为了方便开发，我们提供了这种前后端分离的部署模式，主要的好处是支持前端热部署，在这种模式下，前端会通过8080端口访问后端的restful api接口，获取数据, 这将导致跨域访问的问题。因此我们在`I18nConfig.java`添加了支持跨域访问的配置。这些配置只在**develop** 模式中生效，因此在开发环境中，请选择`develop`配置文件。

### Swagger 支持

部署完成后，可以访问 http://localhost:8080/swagger-ui.html 来查看所有的restful api