# dubbo-admin

**Repository Path**: devin-alan/dubbo-admin

## Basic Information

- **Project Name**: dubbo-admin
- **Description**: dubbo官方版本的dubbo-admin部署包
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2019-06-05
- **Last Updated**: 2022-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

dubbo-admin 2.7+ ，在打包过程中考虑到某一些部署场景可能不通外网，因此已经官方基于cdn加载的js改为本地加载。

# 一、dubbo-admin内网改造
内网改造就是在一些特定的场景网络场景下无法范围外部网络，导致dubbo-admin的中从cdn加载的js加载失败。
因此需要下载官方源码独立的对部署包做处理，即将依赖cdn加载的一些静态js通过下载后直接放入部署包。修改步骤如下。

## 1.1 修改index.html
编辑`dubbo-admin-ui/index.html`。
```
<script src="https://cdn.bootcss.com/echarts/4.0.4/echarts-en.min.js"></script>
//上面cdn引用修改为
<script src="/static/echarts-en.min.js"></script>
```
通过修改后的js引入便知，我们需要将`echarts-en.min.js`从cnd下载后放入`dubbo-admin-ui`
模块的`static`中。然后即可构建。
## 1.2 构建步骤
参考官方文档，待续...

# 二、环境要求

jdk版本：jdk 1.8

系统：linux /windows

推荐部署在linux

# 三、项目部署

打包后的项目部署比较简单，开箱即可启动
```
//解压tar.gz包
tar -zxvf dubbo-admin-1.0.tar.gz
//解压后启动脚本在项目的bin目录中，项目配置文件在config中，日志文件在logs目录中
```
解压后的项目大致结构
```
├─bin
│      dump.sh
│      server.sh
│      setenv.sh
│      start.bat
│      start.sh
│      stop.sh
│      yaml.sh   
├─config
│      application.properties
├─docs
│      DEPLOY.md
├─lib
│      dubbo-admin.jar  
└─logs
```

# 四、启动应用

第一种通过start.sh来启动
```
# 简单启动应用
./start.sh

# 使用目录隔离的多配置环境，可以用--env启动时指定环境，如用开发环境启动。
# 开发中可能会有其他配置文件，因此可以采用文件夹来隔离多环境，
./start.sh --env dev
# 以debug方式启动，此处debug为jvm环境的debug
./start.sh debug

# 启动并开启jmx监控

./start.sh jmx
# 获取应用当前的运行状态
./start.sh status
```
第二种通过server.sh来启动

```
# 启动应用

./server.sh

# 启动时指定环境，如用开发环境启动
./start.sh --env dev
# 以debug方式启动，此处debug为jvm环境的debug
./server.sh debug

# 启动任务并开启jmx监控

./server.sh jmx
# 获取当前的运行状态
./server.sh status

```
# 五、停止应用
```
./stop.sh
或
./server.sh stop
```
**注意：** 以上脚本如果不能正常执行请先检查脚本的用户权限
# 六、启动日志

启动日志在应用的logs下
## 6.1 日志调整
目前默认开启的日志是debug，对于生产环境需要将日志关闭，修改日志只需要在config中的log4j2.xml修改日志级别即可

```
<!-- 级别依次为【从高到低】：FATAL > ERROR > WARN > INFO > DEBUG > TRACE  -->
<!--TRACE、DEBUG、INFO、WARN、ERROR、上FATAL-->
<Root level="ERROR">
    <AppenderRef ref="Console"/>
</Root>
```


# 七、jvm参数调整

服务启动的jvm参数设置是在setenv.sh中，目前设置比较小，但是如果setenv.sh不存在，应用使用start.sh中默认的
jvm参数，强力推荐不要在start.sh中去修改jvm，设置也相对麻烦，因此推荐在setenv.sh中去设置jvm参数.
```
# set jvm params

export JAVA_OPTS="$JAVA_OPTS -Xms512m"
export JAVA_OPTS="$JAVA_OPTS -Xmx512m"
export JAVA_OPTS="$JAVA_OPTS -Xss256K"

# The hotspot server JVM has specific code-path optimizations
# which yield an approximate 10% gain over the client version.
export JAVA_OPTS="$JAVA_OPTS -server"

# Basically tell the JVM not to load awt libraries
export JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true"

# set encoding
export JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf-8"

# set garbage collector
# export java_OPTS="$JAVA_OPTS -XX:+UseConcMarkSweepGC"

# only for jdk 1.7
#export JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize="256m
```


# 八、配置修改
## 8.1 应用端口号修改
端口号在config/application.properties
```
server.port=8089
```

##  8.2 注册中心配置

一般使用zookeeper，配置zookeeper地址时需要根据zookeeper安装方式的不同来配置。对于集群式的zookeeper配置参考如下：

```
# centers in dubbo2.7
admin.registry.address=zookeeper://192.168.237.22:2181?backup=192.168.237.23:2181,192.168.237.24:2181
admin.config-center=zookeeper://192.168.237.22:2181?backup=192.168.237.23:2181,192.168.237.24:2181
admin.metadata-report.address=zookeeper://192.168.237.22:2181?backup=192.168.237.23:2181,192.168.237.24:2181
```
对于单点的zookeeper，则配置参考如下：
```
# centers in dubbo2.7
admin.registry.address=zookeeper://192.168.237.22:2181
admin.config-center=zookeeper://192.168.237.22:2181
admin.metadata-report.address=zookeeper://192.168.237.22:2181
```