Table of contents
Updated at 2020-03-20 16:00:22


1 Deploy TarsNode

After the tars framework is deployed, if you want the business service to be published to the node server, you need to connect the node server to the framework. This step is to install tarsnode on the node server.

There are three modes to install tarsnode:

  • Web platform online deployment
  • Script deployment in node machine
  • Docker deployment

The user running tarsnode may not be root. After installation, you can switch the directory to another user, for example, the current user is root, and you want to switch to the tars user.

#Under root, mask crontab and comment out tarsnode monitoring
#* * * * * /usr/local/app/tars/tarsnode/util/

#Stop tarsnode (note that crontab monitoring should also be shielded, otherwise it will be automatically pulled up)

#Modify directory permissions
chown -R tars:tars /usr/local/app/tarsnode

##Switch to tars users
su tars


#Add crontab monitor
* * * * * /usr/local/app/tars/tarsnode/util/

2 Web platform online deployment

Web provides the function of online installation of tarsnode. When installing, you need to input the IP, password and other information of the node machine to complete the installation of automatic tarsnode (you need to add crontab to monitor tarsnode)

  • When the tarsnode.tgz installation package is deployed, the installation script is automatically copied to the web/files directory
  • If not, you need to generate tarsnode.tgz yourself, as follows >- compile framework, make install
    cd /usr/local/tars/cpp/framework/servers
    tar czf tarsnode.tgz tarsnode
    cp tarsnode.tgz yourweb/files

Configure a process monitoring in crontab to ensure that the tars framework service can be restarted after an exception occurs.

* * * * * /usr/local/app/tars/tarsnode/util/

Note: the node machine needs to support the wget command, otherwise the tarsnode cannot be pulled from the web to the local machine

3 Script deployment in node machine

Tarsnode can also be installed automatically on the node machine, provided that the node can access the web normally and the web supports online installation.

Run on node machine:

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

Parameter description:

  • ip: local node machine ip
  • runuser: Users running tarsnode

Complete the installation of tarsnode, and then add monitoring:

Configure a process monitoring in crontab to ensure that the tars framework service can be restarted after an exception occurs.

* * * * * /usr/local/app/tars/tarsnode/util/

4 Docker deployment

If you want the business service to run in a docker, you can use this method:

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

#for example:
docker run -d --net=host -eINET=eth0 -eWEB_HOST= \
        -v/data/tars:/data/tars \
        -v/etc/localtime:/etc/localtime \

Note: is the access address of web

Script of making tarsnode docker refer to Dockerfile

The docker has built-in Java, nodejs and other runtime support, that is, Java, nodejs services can be published to the docker (the docker has installed JDK, node, PHP environment)

This method is usually used in k8s deployment. At this time, --net=host is not needed, and docker is managed by k8s