【云官网体验版】客户端节点接入使用 👏欢迎体验！

[mapyJJJ]

1，TCA云官网体验版

---

如果还没有部署开源版TCA，可以先选择使用我们的云官网，快速体验TCA的相关功能

云官网传送门：点击传送👈

点击下方的 【立即体验】即可申请体验！

2，什么是客户端节点？

---

2.1，什么是客户端节点？

部署并体验过开源版TCA的同学，应该知道TCA中有一个 常驻节点分析 的概念，也就是在机器上启动一个常驻的服务进程，接收Server端下发代码扫描的任务，并执行任务，返回结果，这样的机器可以看作是一个客户端节点，同样也是一个分布式分析节点

2.2，为什么建议接入客户端节点？

云官网体验版中，提供了一些公共的节点，可以使用这些节点进行执行代码分析

同样也可以为团队接入专有的客户端节点，专门用来执行团队内的分析任务（也可以称为专机）

之所以建议专机接入，主要有以下几点原因:

• 效率：云官网提供的公共节点资源有限，在公用的情况下，会导致任务排队，降低扫描速度，使用专机可以保证机器资源，同时多台专机也可以实现并行执行，来提高扫描效率
• 安全性：从代码安全性考虑，一些私有(内部)项目最好在自主可控的机器节点上执行分析
• 编译型工具：对于一些编译型的代码分析工具，需要先对项目进行编译，而这个过程可能会对公共节点造成一些安全性的问题，目前暂时不支持，所以需要自行接入专机来执行扫描

3，客户端节点接入步骤

---

3.1 准备一台机器：

支持 windows_amd64 , linux_arm64, linux_x86_64, Mac_x86_64

这里使用一台linux(x86_64，centos)机器来演示

3.2 添加节点标签：

体验版 团队申请 通过后，我们可以进入到团队的工作台页面，在 【节点管理】==> 【标签列表】==> 【添加标签】，点击按钮添加一个新的标签，如下所示：

这里添加了一个名为 "团队专机" 的标签

3.3 接入节点

切换到 ”节点列表“ tab，点击添加节点，如下所示：

这里创建一个名为 "专机-1" 的节点，选择标签为 “团队专机” ，点击 "ok" 完成创建，创建的节点已经在列表中展示：

然后点击 “启动命令” 按钮，可以看到有两种启动命令的方式，二进制 和 docker镜像启动：

两种方式的目的都是为了在机器上启动一个常驻进程，可以自行选择一种方式部署，这里将两种启动方式都演示一遍：

二进制启动方式：

• 客户端下载：根据不同系统平台下载对应的版本，这里使用的是 "Linux_x86_64", 点击下载, 下载完成后，使用 unzip 命令对其进行解压缩，可以看到解压到了 codedog/目录下：

• 下载 config.ini 文件：这里选择的 "Linux/Mac" , 点击下载，将下载得到的config.ini 文件直接替换上一步解压到codedog/中的config.ini 文件

• 执行客户端工具： 进入到 codedog/目录，然后复制提供的启动命令到命令行运行：

查看启动日志(tail -f nohup.out):

​ 通过日志看到，客户端已经成功启动

docker方式启动：

• 拉取客户端镜像：

  docker pull tencenttca/tca-client-trial:latest

• 创建本地缓存路径，并下载config.ini文件放到此路径中， 注意填写第2步中的文件夹路径，这里填写的是 /root/tca_data：

  mkdir -p /root/tca_data
  # 将下载后的config.ini 放到 codedog/tca_data 中

• 复制第6步中的命令到命令行中执行:

​ 可以看到，已经启动成功

3.4 刷新工作台页面，重新查看节点列表

刷新工作台页面，重新查看节点列表：

可以看到，节点状态已变为 在线，到这里已经成功给团队接入了一个扫描节点！

4，使用专机来进行代码扫描

---

可以在执行分析任务时，指定由专机来执行分析工作，具体操作如下：

4.1 新建一个【 代码分析方案】：

在下 【运行环境】一栏，下拉选择 “团队专机” ，点击ok创建完成（或者更改一个已有的分析方案，同样将【运行环境】一栏改为 “团队专机” 标签）

4.2 添加分析项目：

选择我们上一步新建的 分析方案：

新建完成后，启动分析，此时我们的扫描任务会被分发到对应的专机节点上执行

在对应的任务执行情况页面中，可以看到，任务执行成功，执行标签为：”团队专机“

关注我们，持续为您的代码助力！

公众号（腾讯云静态分析）大量干货，欢迎关注。

活跃的开源交流群，可痛快畅谈技术&高效解答问题，欢迎进群！