Skip to content

Commit ef422bb

Browse files
committed
提交文档修改,主要修改部署相关和首次分析相关
1 parent 59b1ba8 commit ef422bb

23 files changed

Lines changed: 547 additions & 378 deletions

doc/.vuepress/configs/navbar/zh.ts

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ import type { NavbarConfig } from '@vuepress/theme-default'
22

33
export const zh: NavbarConfig = [
44
{
5-
text: '快速入门',
6-
link: '/zh/quickStarted/deploySever.md',
5+
text: '快速部署',
6+
link: '/zh/quickStarted/',
77
},
88
{
99
text: '帮助文档',
@@ -19,14 +19,17 @@ export const zh: NavbarConfig = [
1919
{
2020
text: '深入',
2121
children: [
22-
'/zh/advanced/任务分布式执行.md',
2322
'/zh/advanced/集成代码分析工具.md',
2423
],
2524
},
2625
{
27-
text: '文章',
26+
text: '依赖安装参考',
2827
children: [
29-
28+
'/zh/quickStarted/references/install_python37_on_centos.md',
29+
'/zh/quickStarted/references/install_python37_on_ubuntu.md',
30+
'/zh/quickStarted/references/install_mysql_on_centos.md',
31+
'/zh/quickStarted/references/install_redis_from_source.md',
32+
'/zh/quickStarted/references/install_redis_on_centos.md',
3033
],
3134
},
3235
]

doc/.vuepress/configs/sidebar/zh.ts

Lines changed: 8 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ export const zh: SidebarConfig = {
1818
]
1919
},
2020
{
21-
text: '代码检查',
21+
text: '分析结果',
2222
children: [
2323
'/zh/guide/代码检查/分析结果查看.md',
2424
'/zh/guide/代码检查/添加规则配置.md',
@@ -66,9 +66,9 @@ export const zh: SidebarConfig = {
6666
{
6767
text: '客户端',
6868
children: [
69-
'/zh/guide/客户端/配置说明.md',
7069
'/zh/guide/客户端/本地分析.md',
7170
'/zh/guide/客户端/常驻节点分析.md',
71+
'/zh/guide/客户端/其他配置.md',
7272
]
7373
},
7474
{
@@ -123,36 +123,20 @@ export const zh: SidebarConfig = {
123123
'/zh/quickStarted/': [
124124
{
125125
text: '快速入门',
126-
link: '/zh/quickStarted/deploySever.md',
127-
// children: [
128-
// {
129-
// text: '快速入门',
130-
// link: '/zh/quickStarted/deploySever.md',
131-
// },
132-
// ],
133-
},
134-
{
135-
text: '依赖安装参考',
136-
// collapsible: true,
137126
children: [
138-
'/zh/quickStarted/references/install_python37_on_centos.md',
139-
'/zh/quickStarted/references/install_python37_on_ubuntu.md',
140-
'/zh/quickStarted/references/install_mysql_on_centos.md',
141-
'/zh/quickStarted/references/install_redis_on_centos.md',
142-
'/zh/quickStarted/references/install_redis_from_source.md',
143-
'/zh/quickStarted/references/install_nginx_from_source.md',
144-
],
127+
'/zh/quickStarted/README.md',
128+
'/zh/quickStarted/dockerDeploy.md',
129+
'/zh/quickStarted/dockercomposeDeploy.md',
130+
'/zh/quickStarted/codeDeploy.md',
131+
]
145132
},
146133
{
147134
text: '其他',
148135
// collapsible: true,
149136
children: [
150-
'/zh/quickStarted/intro.md',
137+
'/zh/quickStarted/enhanceDeploy.md',
151138
'/zh/quickStarted/tools.md',
152139
'/zh/quickStarted/FAQ.md',
153-
'/zh/quickStarted/codeDeploy.md',
154-
'/zh/quickStarted/dockercomposeDeploy.md',
155-
'/zh/quickStarted/enhanceDeploy.md',
156140
],
157141
},
158142
],

doc/README.md

Lines changed: 2 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ home: true
33
title: 腾讯云代码分析文档
44
heroImage: /images/Logo.svg
55
actions:
6-
- text: 快速入门
7-
link: /zh/quickStarted/deploySever.html
6+
- text: 快速部署
7+
link: /zh/quickStarted/
88
type: primary
99
- text: 帮助文档
1010
link: /zh/guide/
@@ -35,48 +35,3 @@ footer: MIT Licensed | Copyright © 1998-present Tencent. All Rights Reserved.
3535

3636
[https://git.code.tencent.com/Tencent_Open_Source/CodeAnalysis.git](https://git.code.tencent.com/Tencent_Open_Source/CodeAnalysis.git)
3737

38-
### 腾讯云代码分析简介
39-
40-
腾讯云代码分析(Tencent Cloud Code Analysis,简称TCA,内部曾用研发代号 **CodeDog** )是集众多分析工具的云原生、分布式、高性能的代码综合分析跟踪平台,包含服务端、Web端和客户端三个组件,已集成一批自研工具,同时也支持动态集成业界各编程语言的分析工具。
41-
42-
代码分析是通过词法分析、语法分析、控制流、数据流分析等技术对程序代码进行扫描,对代码进行综合分析,验证代码是否满足规范性、安全性、可靠性、可维护性等指标的一种代码分析技术。
43-
44-
使用TCA可以帮助团队用代码分析技术查找代码中的规范性、结构性、安全漏洞等问题,持续监控项目代码质量并进行告警。同时TCA开放API,支持与上下游系统对接,从而集成代码分析能力,为代码质量提供保障,更有益于传承优良的团队代码文化。
45-
46-
![组件图](https://tencent.github.io/CodeAnalysis/media/Components.png)
47-
48-
![流程图](https://tencent.github.io/CodeAnalysis/media/Flow.png)
49-
50-
### 体验
51-
52-
[官方版本](http://tca.tencent.com)
53-
54-
### 快速入门
55-
56-
- [快速入门](./zh/quickStarted/intro.md)
57-
- [如何在本地部署Server与Web](./zh/quickStarted/deploySever.md#通过源代码)
58-
- [如何通过Docker-Compose部署Server与Web](./zh/quickStarted/deploySever.md#通过docker-compose)
59-
- [如何使用客户端](./zh/quickStarted/deployClient.md)
60-
- [部署常见问题与解决方式](./zh/quickStarted/FAQ.md)
61-
62-
## 社区
63-
64-
- 微信公众号:「腾讯云静态分析」,关注并发送“进群”即可加入官方开源交流微信群
65-
- QQ交流群:361791391
66-
- [GitHub讨论区](https://github.com/Tencent/CodeAnalysis/discussions)
67-
- [Wiki](https://github.com/Tencent/CodeAnalysis/wiki)
68-
- [腾讯云代码分析白皮书](https://github.com/Tencent/CodeAnalysis/tree/main/腾讯云代码分析白皮书.pdf)
69-
70-
## 更新日志
71-
72-
[Changelog](https://github.com/Tencent/CodeAnalysis/tree/main/CHANGELOG.md)
73-
74-
## 贡献
75-
76-
- 查看我们的[贡献说明](https://github.com/Tencent/CodeAnalysis/tree/main/CONTRIBUTING.md)
77-
- [腾讯开源摘星计划2022](https://github.com/weopenprojects/WeOpen-Star/issues/19#issue-1228583868)(活动时间:2022年5月~12月)
78-
- [腾讯开源激励计划](https://opensource.tencent.com/contribution) 鼓励开发者的参与和贡献,期待你的加入
79-
80-
### License
81-
82-
[MIT licensed](https://github.com/Tencent/CodeAnalysis/tree/main/LICENSE)

doc/images/codelint_04.png

312 KB
Loading

doc/images/create_team_group.png

-18.2 KB
Loading

doc/zh/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
<!-- 未使用,直接使用的是doc目录下的README.md -->
1+
<!-- 未使用,直接使用的是doc目录下的README.md -->

doc/zh/advanced/集成代码分析工具.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 集成代码分析工具
1+
# 在TCA源码中集成代码分析工具
22

33
## 初识TCA任务执行机制
44

doc/zh/community/changelog.md

Lines changed: 117 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,61 +1,154 @@
11
# 更新日志
2+
## V1.4.1 (2022-7-28)
3+
### Features
4+
- 【服务端】统一部署脚本,封装local、docker、docker-compose部署方式启动server&web&client
5+
- 【服务端】支持源码安装Redis与Nginx
6+
- 【服务端】macOS启动docker desktop
7+
- 【服务端】完善github action脚本
8+
- 【工具】更新工具列表
29

3-
## V1.2.0 (2022-4-27)
10+
### Docs
11+
- 上传新版本白皮书
12+
- 调整快速入门指引文档
13+
14+
15+
16+
## V1.4.0 (2022-7-18)
17+
### Features
18+
- 【客户端】jenkins插件增加分析方案模版ID和分析方案名称参数
19+
- 【服务端】增加扫描方案模板API
20+
- 【服务器】优化文件服务器鉴权交互
21+
- 【客户端】QuickScan支持指定分析方案模板进行扫描;支持从环境变量读取文件服务器url和token
22+
- 【Web端】升级moment依赖
23+
### Docs
24+
- 更新插件使用说明书和启动参数说明
25+
26+
27+
28+
## V1.3.3 (2022-6-29)
29+
### Features
30+
- 【服务端】支持团队、项目组禁用,支持代码库、分支项目删除
31+
- 【服务端】扫描方案支持分支过滤
32+
- 【Web端】支持禁用团队、项目,代码库登记支持ssh_url
33+
- 【Web端】支持分支过滤配置,修复代码统计文件选中效果,支持工具、依赖凭证移除
34+
- 【工具】增加tca_ql工具
35+
- 【客户端】节点模式不再由客户端加载编译工具的环境变量,避免覆盖机器原有环境变量
36+
- 【客户端】QuickScan模式,异常时输出task.log方便排查问题
37+
- 【客户端】.code.yml支持.yaml后缀
38+
### Bugfixes
39+
- 【客户端】tool_scheme和ini配置共用时,可能出现工具重复,需要对工具库去重后再拉取
40+
### Docs
41+
- 更新TCA Action相关文档
42+
- 更新Jenkins插件文档;增加环境依赖说明
43+
- 更新自定义工具文档,使用工具依赖
44+
- 更新CLS readme
45+
46+
47+
48+
## V1.3.2 (2022-6-16)
49+
### Features
50+
- 【客户端】QuickScan根据语言执行不同的任务
51+
### Docs
52+
- docker-compose部署文档中数据库注意事项
53+
54+
55+
56+
## V1.3.1 (2022-6-14)
57+
### Features
58+
- 【客户端】新增merge quest分支增量扫描
59+
- 【客户端】新增Quickscan模式
60+
- 【客户端】localscan支持工具并发
61+
- 【工具】新增二进制文件依赖分析工具
62+
- 【服务端】server调整服务监控探测脚本:celery状态判断
63+
- 【服务端】增加子任务接口,完善部署脚本
64+
- 【服务端】更新CLS版本v20220613.1
65+
- 【服务端】基于 CentOS7.9.2009(已测)的运行环境一键安装脚本,并已安装及配置命令 gunicorn 和 celery
66+
- 【Web端】调整OAuth显示
67+
68+
69+
70+
## V1.3.0 (2022-6-7)
71+
### Features
72+
- 【工具】新增独立工具Loong
73+
- 【工具】新增Java、JS基础安全规则包
74+
- 【工具】增加Go和Python技术安全规则包
75+
- 【服务端】新增oauth授权及工具依赖管理
76+
- 【服务端】docker-compose部署支持挂载本地日志目录
77+
- 【客户端】支持工具依赖管理
78+
- 【Web端】支持工具依赖管理设置和Git OAuth设置
79+
- 【Web端】团队列表支持滚动加载
480

81+
### Bugfixes
82+
- 【服务端】补充scmproxy缺失依赖
83+
- 【服务端】修复issue入库忽略处理操作
84+
85+
### Docs
86+
- 更新工具目录readme
87+
- 更新client README.md
88+
89+
90+
91+
## V1.2.1 (2022-5-24)
592
### Features
93+
- 【工具】新增Collie/Compass(测试版)工具
94+
- 【工具】添加tscancode系列工具
95+
- 【工具】工具区分编译型和非编译型
96+
- 【客户端】更新cmdscm二进制文件,调整获取ssh端口号方式
97+
- 【客户端】增加腾讯工蜂作为工具拉取源,支持选用
98+
- 【服务端】调整工程配置和文档,支持https克隆
99+
- 【Web端】前端页面优化
100+
101+
### Docs
102+
- 添加集成工具说明文档
103+
- readme增加微信公众号和腾讯开源摘星计划的说明及链接
104+
- 修改帮助文档的脚本名称;修改工蜂镜像仓库链接位置
105+
- 调整自定义规则文档
106+
- 调整doc,优化部署、使用文档
107+
6108

109+
110+
## V1.2.0 (2022-4-27)
111+
### Features
7112
- 【Web端】增加工具管理
8113
- 【工具】增加logback检查的安全规则
9114
- 【服务端】增加TCA server&web 一键部署脚本
10115
- 【服务端】删除main部分异步任务;调整server nginx启动位置
11116
- 【服务端】增加server健康监测
12-
13117
### Docs
14-
15118
- 完善部署和Q&A文档
16119
- 上传工具列表
17120

18-
## V1.1.3 (2022-4-18)
19121

122+
## V1.1.3 (2022-4-18)
20123
### Features
21-
22124
- 【工具】上传开源合规检查规则
23125
- 【工具】新增PHP安全相关规则
24126
- 【服务端】上线license鉴权
25127
- 【客户端】支持对工具license校验
26-
27128
### Docs
28-
29129
- 更新文档内的工具默认路径
30130
- 增加任务分布式执行能力操作文档
31131
- 增加PR操作流程
32132

33-
## V1.1.2 (2022-4-2)
34133

134+
## V1.1.2 (2022-4-2)
35135
### Features
36-
37-
- 【服务端】优化部署构建脚本
38-
136+
- 【服务端】优化部署构建脚本
39137
### Docs
40-
41-
- 简化前端部署脚本&文档
138+
- 简化前端部署脚本&文档
42139
- 优化指引文档
43140

44-
## V1.1.1 (2022-3-31)
45141

142+
## V1.1.1 (2022-3-31)
46143
### Features
47-
48144
- 【工具】增加0daychecker工具
49145
- 【工具】增加Log4j、LogBack漏洞检查规则包
50146

51147
### Docs
52-
53148
- 完善部署文档说明,推荐使用Docker-Compose 2.3.3版本
54149

55150
## V1.1.0 (2022-3-29)
56-
57151
### Features
58-
59152
- 【客户端】client支持arm64架构执行环境
60153
- 【客户端】client新增分布式节点模式
61154
- 【客户端】修改参数isTotal(是否开启全量扫描)判断方式及参数startCommand(启动客户端命令)拼接方式
@@ -65,21 +158,17 @@
65158
- 【Web端】web模块部署脚本问题修复及优化
66159
- 【Web端】增加管理后台、增加在线分析
67160
- 【Web端】调整前端部署脚本,支持传递nginx配置地址、前端资源部署地址
68-
69161
### Bugfixes
70-
71162
- Jenkins插件命令拼装逻辑修正
72-
73163
### Docs
74-
75164
- 调整pypi下载失败提示
76165
- 调整前端部署文档及脚本
77166
- 更新License
78167

79-
## V1.0.1 (2022-03-01)
80168

81-
### Features
82169

170+
## V1.0.1 (2022-03-01)
171+
### Features
83172
- feat: 【服务端】调整代码库登记ssh url链接格式适配
84173
- feat: 【工具】上线支持PHP安全工具-Rips
85174
- feat: 【工具】调整androidlint部分规则描述
@@ -90,17 +179,16 @@
90179
- feat: 【客户端】增加在docker中快速使用client的方式
91180

92181
### Bugfixes
93-
94182
- fix: 【服务端】补充缺失的依赖
95183
- fix: 【Web端】修复下载codedog.ini失败提示
96-
184+
97185
### Docs
98-
99186
- doc: 上线部署文档Q&A
100187
- doc: 优化部署文档、帮助文档说明
101188
- doc: 增加产品白皮书
102189
- doc: 补充redis和nginx源码安装参考文档
103190

104-
## V1.0.0
105191

106-
初始发布
192+
193+
## V1.0.0
194+
初始发布

0 commit comments

Comments
 (0)