> For the complete documentation index, see [llms.txt](https://tarscloud.gitbook.io/tarsdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tarscloud.gitbook.io/tarsdocs/kai-yuan-ban-kuang-jia-jie-shao/kai-yuan-ban-ben-bu-shu/node.md).

# 框架节点部署

## 目录

> * [TarsNode部署](#chapter-1)
> * [web在线部署](#chapter-2)
> * [节点机脚本部署](#chapter-3)
> * [docker化部署](#chapter-4)

## 1 TarsNode部署

首先我们理解一下tarsnode是什么, 部署完framework以后(通常framework一般部署2台后者3台), 通常还需要部署tarsnode, 在实际环境中tarsnode会部署几十上百台(根据业务规模), 而业务通常部署在tarsnode的节点服务器上.

tarsnode的安装包是在framework上的, 可以通过framework的web平台拉取下来, 当然通常你不需要自己拉取, 后续安装方式会自动拉取并部署在服务器上.

因此我们通常建议tarsnode运行的节点服务器和framework运行服务器是同一个版本, 如果gcc版本不同, 很有可能拉取下来后无法运行!

当完成Tars framework之后, 如果希望业务服务发布到节点服务器, 就需要将节点服务器连接到框架上, 这步操作即在节点服务器上安装tarsnode.

安装Tarsnode有三种模式:

* web平台在线部署
* 节点机脚本部署
* docker化部署

## 2 web在线安装

web(>=1.4.1)提供了在线安装tarsnode的功能, 请在web平台: 运维管理->节点管理 界面进行操作. 安装时需要输入节点机的ip, 密码等信息, 完成自动tarsnode的安装(需要自己增加crontab监控tarsnode)

注意节点服务器需要安装好unzip, curl, wget工具包.

注意:

* tarsnode.tgz安装包是在部署时, 安装脚本自动copy到web/files目录下的
* 如果不存在, 需要自己生成tarsnode.tgz, 如下操作

> - 编译framework, make install

```
cd /usr/local/tars/cpp/framework/servers
tar czf tarsnode.tgz tarsnode
cp tarsnode.tgz yourweb/files
```

在crontab配置一个进程监控，确保TARS框架服务在出现异常后能够重新启动。

```
* * * * * /usr/local/app/tars/tarsnode/util/monitor.sh
```

**注意:节点机需要支持wget命令, 否则无法从web拉取tarsnode到本机**

## 3 节点机脚本安装

节点机上也可以自动去安装tarsnode, 前提是节点机能正常访问web, 且web支持online安装

在节点上运行:

```
wget http://webhost/get_tarsnode?ip=xxx&runuser=root -O get_tarsnode
chmod a+x get_tarsnode
./get_tarsnode
```

参数说明:

* ip: 本机ip
* runuser: 运行tarsnode的用户

通常情况, 执行`get_tarsnode`脚本, tarsnode会安装`/usr/local/app`目录下, 如果你没有root用户, 你可以优先创建好`/usr/local/app`目录, 切换到你的用户, 然后`wget http://webhost/get_tarsnode?ip=xxx&runuser=root -O get_tarsnode`中, 修改runuser=${your user}, 然后再${your user}权限下执行 ./get\_tarsnode

即完成tarsnode的安装, 然后添加监控:

在crontab配置一个进程监控，确保TARS框架服务在出现异常后能够重新启动。

```
* * * * * /usr/local/app/tars/tarsnode/util/monitor.sh
```

tarsnode运行的用户可以不用是root, 可以安装以后, 将目录切换到其他用户, 例如当前是root用户, 希望切换到tars用户下

```
#root用户下, 屏蔽crontab, 注释掉tarsnode的监控
#* * * * * /usr/local/app/tars/tarsnode/util/monitor.sh

#停掉tarsnode(注意crontab监控也要屏蔽, 否则会被自动拉起)
/usr/local/app/tarsnode/util/stop.sh

#修改目录权限
chown -R tars:tars /usr/local/app/tarsnode

#切换到tars用户
su tars

#启动
/usr/local/app/tarsnode/util/start.sh

#增加当前用户的crontab的监控
* * * * * /usr/local/app/tars/tarsnode/util/monitor.sh
```

## 4 docker化安装

*

如果希望业务服务运行在一个docker里面, 可以采用该方式:

```sh
docker pull tarscloud/tars-node:stable
```

```sh
docker run -d --net=host -eINET=eth0 -eWEB_HOST=xxxxx \
        -v/data/tars:/data/tars \
        -v/etc/localtime:/etc/localtime \
        tarscloud/tars-node:stable

#例如:
docker run -d --net=host -eINET=eth0 -eWEB_HOST=http://172.16.0.7:3000 \
        -v/data/tars:/data/tars \
        -v/etc/localtime:/etc/localtime \
        tarscloud/tars-node:stable     
```

**注意: <http://172.16.0.7:3000> 是TarsWeb的访问地址**

tarsnode docker的制作脚本参考[Dockerfile](https://github.com/TarsCloud/TarsDocker/blob/master/tarsnode/Dockerfile)

该Docker内置了java, nodejs等运行时支持, 即可以把java, nodejs服务发布到docker里面(docker里面安装了jdk, node, php环境)

这种方式通常使用在k8s的部署中, 此时不需要--net=host, docker被k8s管理.