Skip to content

Commit

Permalink
docs: update readme and changelog
Browse files Browse the repository at this point in the history
  • Loading branch information
WineChord committed Sep 27, 2023
1 parent 6d89e3d commit b3891b3
Show file tree
Hide file tree
Showing 17 changed files with 2 additions and 95 deletions.
9 changes: 0 additions & 9 deletions filterextensions/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,9 +0,0 @@
# Changelog

## [0.1.0](https://git.woa.com/trpc-go/trpc-filter/tree/filterextensions/v0.1.0) (2022-07-25)

### Features

- 扩展了 `trpc_go.yaml` 的解析方式,以「插件」+「拦截器」的方式实现了 method 粒度的拦截器
- 新增 CHANGELOG.md 文件
- 升级 trpc-go 到 v0.9.4,适配新版本 filter 签名
4 changes: 0 additions & 4 deletions filterextensions/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,3 @@
[![BK Pipelines Status](https://api.bkdevops.qq.com/process/api/external/pipelines/projects/pcgtrpcproject/p-7c6d21257da948469e47d9ed3b4845ff/badge?X-DEVOPS-PROJECT-ID=pcgtrpcproject)](http://devops.oa.com/process/api-html/user/builds/projects/pcgtrpcproject/pipelines/p-7c6d21257da948469e47d9ed3b4845ff/latestFinished?X-DEVOPS-PROJECT-ID=pcgtrpcproject)
[![Coverage](https://tcoverage.woa.com/api/getCoverage/getTotalImg/?pipeline_id=p-7c6d21257da948469e47d9ed3b4845ff)](http://macaron.oa.com/api/coverage/getTotalLink/?pipeline_id=p-7c6d21257da948469e47d9ed3b4845ff)
[![GoDoc](https://img.shields.io/badge/API%20Docs-GoDoc-green)](http://godoc.oa.com/trpc.group/trpc-go/trpc-filter/filter_extensions)

## tRPC-Go 拦截器扩展

tRPC-Go 支持在 `trpc_go.yaml` 中配置拦截器,但是拦截器的精度只到 service 层,无法作更细粒度的配置,如为 method 配置拦截器。
Expand Down
9 changes: 0 additions & 9 deletions hystrix/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,9 +0,0 @@
# Changelog

## [0.1.0](https://git.woa.com/trpc-go/trpc-filter/tree/hystrix/v0.1.0) (2022-07-25)

### Features

- Based on Netflix open source hystrix components.
- Add CHANGELOG.md file.
- Upgrade trpc-go to v0.9.4 to adapt to the new version filter signature.
1 change: 0 additions & 1 deletion hystrix/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
## tRPC-Go [hystrix] fuse protection plugin
[![BK Pipelines Status](https://api.bkdevops.qq.com/process/api/external/pipelines/projects/pcgtrpcproject/p-942764d8bdb64eb1ad280822bfc78e97/badge?X-DEVOPS-PROJECT-ID=pcgtrpcproject)](http://devops.oa.com:/ms/process/api-html/user/builds/projects/pcgtrpcproject/pipelines/p-942764d8bdb64eb1ad280822bfc78e97/latestFinished?X-DEVOPS-PROJECT-ID=pcgtrpcproject)[![Coverage](https://tcoverage.woa.com/api/getCoverage/getTotalImg/?pipeline_id=p-942764d8bdb64eb1ad280822bfc78e97)](http://macaron.oa.com/api/coverage/getTotalLink/?pipeline_id=p-942764d8bdb64eb1ad280822bfc78e97)[![GoDoc](https://img.shields.io/badge/API%20Docs-GoDoc-green)](http://godoc.oa.com/trpc.group/trpc-go/trpc-filter/hystrix)
### hystrix plugin introduction

The plugin is based on Netflix's open source hystrix component, see https://github.com/afex/hystrix-go
Expand Down
12 changes: 0 additions & 12 deletions jwt/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,12 +0,0 @@
# Change Log

## [0.2.0](https://git.woa.com/trpc-go/trpc-filter/tree/jwt/v0.2.0) (2022-06-27)

### Features
- server filter 签名升级,适配 trpc-go 0.9.0 版本

## [0.1.0](https://git.woa.com/trpc-go/trpc-filter/tree/jwt/v0.1.0) (2021-09-02)

### Features

- jwt 用户身份验证拦截器
2 changes: 0 additions & 2 deletions jwt/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# tRPC-Go [jwt] 用户身份验证拦截器

[![BK Pipelines Status](https://api.bkdevops.qq.com/process/api/external/pipelines/projects/pcgtrpcproject/p-5351dee5801b4df98c03692007da4c5f/badge?X-DEVOPS-PROJECT-ID=pcgtrpcproject)](http://devops.oa.com/process/api-html/user/builds/projects/pcgtrpcproject/pipelines/p-5351dee5801b4df98c03692007da4c5f/latestFinished?X-DEVOPS-PROJECT-ID=pcgtrpcproject) [![Coverage](https://badge.tcoverage.woa.com/api/getCoverage/getTotalImg/?pipeline_id=p-5351dee5801b4df98c03692007da4c5f)](http://macaron.oa.com/api/coverage/getTotalLink/?pipeline_id=p-5351dee5801b4df98c03692007da4c5f) [![GoDoc](https://img.shields.io/badge/API%20Docs-GoDoc-green)](http://godoc.oa.com/trpc.group/trpc-go/trpc-filter/jwt)

## jwt 插件使用说明

### I. 必要条件
Expand Down
2 changes: 0 additions & 2 deletions masking/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,6 @@ server:

## 编写proto协议文件

更加详细指引可参考:https://git.woa.com/devsec/protoc-gen-secv

```
syntax = "proto3";
Expand Down
7 changes: 0 additions & 7 deletions mock/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +0,0 @@
# Change Log

## [0.1.0](https://git.woa.com/trpc-go/trpc-filter/tree/mock/v0.1.0) (2022-07-19)

### Features

- Upgrade trpc-go to v0.9.4, adapt to new filter signature version.
1 change: 0 additions & 1 deletion mock/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
# mock

[![BK Pipelines Status](https://api.bkdevops.qq.com/process/api/external/pipelines/projects/pcgtrpcproject/p-39d43cbb08d847a799ef26493deea97f/badge?X-DEVOPS-PROJECT-ID=pcgtrpcproject)](http://devops.oa.com:/ms/process/api-html/user/builds/projects/pcgtrpcproject/pipelines/p-39d43cbb08d847a799ef26493deea97f/latestFinished?X-DEVOPS-PROJECT-ID=pcgtrpcproject)[![Coverage](https://tcoverage.woa.com/api/getCoverage/getTotalImg/?pipeline_id=p-39d43cbb08d847a799ef26493deea97f)](http://macaron.oa.com/api/coverage/getTotalLink/?pipeline_id=p-39d43cbb08d847a799ef26493deea97f)[![GoDoc](https://img.shields.io/badge/API%20Docs-GoDoc-green)](http://godoc.oa.com/trpc.group/trpc-go/trpc-filter/mock)
It implement back-end dependency interface mock calls via interceptors.

## Instructions for use
Expand Down
7 changes: 0 additions & 7 deletions referer/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +0,0 @@
# Change Log

## [0.1.0](https://git.woa.com/trpc-go/trpc-filter/tree/referer/v0.1.0) (2022-07-21)

### Features

- 升级 trpc-go 到 v0.9.4,适配新版本 filter 签名
6 changes: 1 addition & 5 deletions referer/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# referer

[![BK Pipelines Status](https://api.bkdevops.qq.com/process/api/external/pipelines/projects/pcgtrpcproject/p-a437407d143f42f6b408ec8f23874fd5/badge?X-DEVOPS-PROJECT-ID=pcgtrpcproject)](http://devops.oa.com:/ms/process/api-html/user/builds/projects/pcgtrpcproject/pipelines/p-a437407d143f42f6b408ec8f23874fd5/latestFinished?X-DEVOPS-PROJECT-ID=pcgtrpcproject) [![Coverage](https://tcoverage.woa.com/api/getCoverage/getTotalImg/?pipeline_id=p-a437407d143f42f6b408ec8f23874fd5)](http://macaron.oa.com/api/coverage/getTotalLink/?pipeline_id=p-a437407d143f42f6b408ec8f23874fd5) [![GoDoc](https://img.shields.io/badge/API%20Docs-GoDoc-green)](http://godoc.oa.com/trpc.group/trpc-go/trpc-filter/referer)

http referer 安全验证

## 使用说明
Expand All @@ -10,7 +8,7 @@ http referer 安全验证

```golang
import (
_ "trpc.group/trpc-go/trpc-filter/referer"
_ "trpc.group/trpc-go/trpc-filter/referer"
)
```

Expand All @@ -27,10 +25,8 @@ plugins:
- qq.com
path1:
- qq.com
- oa.com
path2:
- NULL

```
## 配置说明
Expand Down
7 changes: 0 additions & 7 deletions transinfo-blocker/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +0,0 @@
# Change Log

## [0.1.0](https://git.woa.com/trpc-go/trpc-filter/tree/transinfo-blocker/v0.1.0) (2022-07-21)

### Features

- 升级 trpc-go 到 v0.9.4,适配新版本 filter 签名
7 changes: 0 additions & 7 deletions tvar/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +0,0 @@
# Change Log

## [0.1.0](https://git.woa.com/trpc-go/trpc-filter/tree/tvar/v0.1.0) (2022-07-21)

### Features

- 升级 trpc-go 到 v0.9.4,适配新版本 filter 签名
12 changes: 1 addition & 11 deletions tvar/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@

## 插件简介

实现serverside、clientside RPC等监控项的统计上报,具体要支持的监控项,详见:
https://git.woa.com/trpc/trpc-proposal/blob/master/A6-tvar.md。
实现serverside、clientside RPC等监控项的统计上报

注册admin接口:/cmds/stats/rpc 接口可查询监控项,及支持情况

Expand Down Expand Up @@ -40,13 +39,6 @@ https://git.woa.com/trpc/trpc-proposal/blob/master/A6-tvar.md。
| rpc_client_xxx_latency_999 | 必须 | client p999延时 ||
| rpc_client_xxx_latency_avg/max/min | 必须 | client延时的avg/max/min ||

后续PR中可以继续完善的:

- version 提案中未说明指的是什么版本,以及从哪里获取
- req/rsp包尺寸 外部依赖:https://git.woa.com/trpc-go/trpc-go/issues/716
- service协议错误 在filter中也无法做统计,可用框架metrics打点代替
- latency的avg\max\min 在已经有百分位数支持的前提下,这些价值不大,otel metrics/histogram sdk不支持记录最小、最大

## 使用方式

1. 代码中导入包:`import _ "trpc.group/trpc-go/trpc-filter/tvar"
Expand All @@ -63,5 +55,3 @@ https://git.woa.com/trpc/trpc-proposal/blob/master/A6-tvar.md。
```
3. 查询:`curl http://ip:adminport/cmds/stats/rpc`

详见iwiki使用说明:https://iwiki.woa.com/pages/viewpage.action?pageId=1226665829
4 changes: 0 additions & 4 deletions tvar/filter.go
Original file line number Diff line number Diff line change
Expand Up @@ -34,10 +34,6 @@ func RPCServerFilter(
serviceReqActiveNum.Add(ctx, 1, attr)
serviceQWin.Record()

// TODO req包尺寸依赖:https://git.woa.com/trpc-go/trpc-go/issues/716
// rsp包尺寸filter里不方便统计
// serviceReqSize.Record()

begin := time.Now()
defer func() {
serviceReqActiveNum.Add(ctx, -1, attr)
Expand Down
5 changes: 0 additions & 5 deletions validation/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,11 +59,6 @@ plugins:

## Writing Proto Protocol Files

<<<<<<< HEAD
=======
For more detailed instructions, please refer to: https://git.woa.com/devsec/protoc-gen-secv

>>>>>>> 6cf84d8 (Translate readme for debuglog, recovery and validation. (merge request !334))
```protobuf
syntax = "proto3";
Expand Down
2 changes: 0 additions & 2 deletions validation/README_ZH.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,8 +59,6 @@ plugins:
## 编写proto协议文件
更加详细的指引请参考:<https://git.woa.com/devsec/protoc-gen-secv>
```protobuf
syntax = "proto3";

Expand Down

0 comments on commit b3891b3

Please sign in to comment.