编译&运行

前言

如果想要为TIS贡献代码，首先需要为在本地环境中将TIS运行起来。本文向大家介绍从克隆代码仓库中代码，到编译并且运行TIS的每个步骤。

步骤

克隆代码

一个完整的TIS应用，是由三部分构成：

1. TIS主干逻辑 https://github.com/qlangtech/tis
2. TIS插件 https://github.com/qlangtech/plugins
3. 前端逻辑 https://github.com/qlangtech/ng-tis

分别将他们clone到本地目录中

    git clone git@github.com:qlangtech/tis.git
    
    git clone git@github.com:qlangtech/plugins.git
    
    git clone git@github.com:qlangtech/ng-tis.git

编译&构建

Maven setting.xml 修改

由于TIS对DataX项目进行Fork单独Deploy到TIS的Maven仓库中，另外依赖了Jenkins仓库的代码，在编译项目之前需要将本地maven仓库中 MAVEN_HOME/config/setting.xml 文件配置进行修改，

详细请参照：https://github.com/qlangtech/tis-ansible/blob/master/template/settings.xml.j2 ,开发者只需将示例中的 qlangtech ， jenkins 两个profile相关的配置拷贝到本地maven配置中即可。

TIS使用的Maven推荐使用v3.8.1 版本

编译 qlangtech/tis 项目

cd tis
mvn clean install -Dmaven.test.skip=true 

编译 qlangtech/plugins 项目

cd plugins
mvn clean package -Dmaven.test.skip=true -Dappname=all

构建 qlangtech/ng-tis

为了加速ng-tis构建速度，需要先执行下载tis-console-ng-node-modules.tar.gz,已经事先对本地项目中node_modules中npm依赖打包在其中

cd ng-tis
wget http://tis-release.oss-cn-beijing.aliyuncs.com/tis-console-ng-node-modules.tar.gz
tar xvf tis-console-ng-node-modules.tar.gz

安装Angular cli工具（具体版本要与ng-tis/package.json中Angular的依赖版本相一致）

npm install -g @angular/cli@12.2.13

如果之前已经安装了其他版本的@angular/cli，可以先将其删除再安装

npm uninstall -g @angular/cli 

启动&调试

安装数据库

1. 需要准备一个MySQL5.7节点

2. 执行Sql脚本https://github.com/qlangtech/tis-ansible/blob/master/tis_console_mysql.sql进行tis_console数据库初始化

3. 本地项目中配置数据库连接信息 配置文件路径：/tis/tis-web-config/config.properties

    tis.datasource.type=mysql
    tis.datasource.url=192.168.28.1
    tis.datasource.port=3306
    tis.datasource.username=root
    tis.datasource.password=111111
    tis.datasource.dbname=tis_console
    zk.host=192.168.28.1:2181/tis/cloud
       
    assemble.host=192.168.28.1
    tis.host=192.168.28.1
   

   以上配置文件中IP相关都可以配置成本地IP地址

plugin软链接

由于TIS启动会默认到本地目录/opt/data/tis/libs/plugins中加载插件，所以需要将之前plugins项目打包之后生成的plugins软链到 /opt/data/tis/libs/plugins

具体执行命令为：

for f in `find ./plugins  -name '*.tpi' -print`
do
   echo " ln -s $f "
   ln -s $f /opt/data/tis/libs/plugins/${f##*/}
done ;

启动TIS Console

1. cd tis/tis-console/src/test/java/

2. 运行 StartTISWeb 单元测试

   mvn compile test -Dtest=StartTISWeb
   

   启动过程需要指定以下JVM参数：

     -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=50001 -Dtis.launch.port=8080
   

   开启50001的远程调试端口，并且以8080端口运行http servlet

启动TIS Web

1. cd ng-tis
2. 运行 npm run ng:serve-jit --scripts-prepend-node-path=auto

启动Assemble Web

Assemble节点负责执行TIS Console提交过来批量执行任务

1. cd tis/tis-assemble/src/test/java/
2. 运行 StartAssembleWeb 单元测试