mirror of
https://github.com/rocky-linux/peridot.git
synced 2024-11-18 19:31:25 +00:00
ad0f7a5305
Upgrade to Go 1.20.5, Hydra v2 SDK, rules-go v0.44.2 (with proper resolves), protobuf v25.3 and mass upgrade of Go dependencies.
94 lines
5.1 KiB
Markdown
94 lines
5.1 KiB
Markdown
# Go gRPC Middleware
|
|
|
|
[](https://travis-ci.org/grpc-ecosystem/go-grpc-middleware)
|
|
[](https://goreportcard.com/report/github.com/grpc-ecosystem/go-grpc-middleware)
|
|
[](https://godoc.org/github.com/grpc-ecosystem/go-grpc-middleware)
|
|
[](https://sourcegraph.com/github.com/grpc-ecosystem/go-grpc-middleware/?badge)
|
|
[](https://codecov.io/gh/grpc-ecosystem/go-grpc-middleware)
|
|
[](LICENSE)
|
|
[](#status)
|
|
[](https://gophers.slack.com/archives/CNJL30P4P)
|
|
|
|
[gRPC Go](https://github.com/grpc/grpc-go) Middleware: interceptors, helpers, utilities.
|
|
|
|
## ⚠️ Status
|
|
|
|
Version [v2](https://github.com/grpc-ecosystem/go-grpc-middleware/tree/v2) is about to be released, with migration guide, which will replace v1. Try v2 and give us feedback!
|
|
|
|
Version v1 is currently in deprecation mode, which means only critical and safety bug fixes will be merged.
|
|
|
|
|
|
## Middleware
|
|
|
|
[gRPC Go](https://github.com/grpc/grpc-go) recently acquired support for
|
|
Interceptors, i.e. [middleware](https://medium.com/@matryer/writing-middleware-in-golang-and-how-go-makes-it-so-much-fun-4375c1246e81#.gv7tdlghs)
|
|
that is executed either on the gRPC Server before the request is passed onto the user's application logic, or on the gRPC client around the user call. It is a perfect way to implement
|
|
common patterns: auth, logging, message, validation, retries, or monitoring.
|
|
|
|
These are generic building blocks that make it easy to build multiple microservices easily.
|
|
The purpose of this repository is to act as a go-to point for such reusable functionality. It contains
|
|
some of them itself, but also will link to useful external repos.
|
|
|
|
`grpc_middleware` itself provides support for chaining interceptors, here's an example:
|
|
|
|
```go
|
|
import "github.com/grpc-ecosystem/go-grpc-middleware"
|
|
|
|
myServer := grpc.NewServer(
|
|
grpc.StreamInterceptor(grpc_middleware.ChainStreamServer(
|
|
grpc_ctxtags.StreamServerInterceptor(),
|
|
grpc_opentracing.StreamServerInterceptor(),
|
|
grpc_prometheus.StreamServerInterceptor,
|
|
grpc_zap.StreamServerInterceptor(zapLogger),
|
|
grpc_auth.StreamServerInterceptor(myAuthFunction),
|
|
grpc_recovery.StreamServerInterceptor(),
|
|
)),
|
|
grpc.UnaryInterceptor(grpc_middleware.ChainUnaryServer(
|
|
grpc_ctxtags.UnaryServerInterceptor(),
|
|
grpc_opentracing.UnaryServerInterceptor(),
|
|
grpc_prometheus.UnaryServerInterceptor,
|
|
grpc_zap.UnaryServerInterceptor(zapLogger),
|
|
grpc_auth.UnaryServerInterceptor(myAuthFunction),
|
|
grpc_recovery.UnaryServerInterceptor(),
|
|
)),
|
|
)
|
|
```
|
|
|
|
## Interceptors
|
|
|
|
_Please send a PR to add new interceptors or middleware to this list_
|
|
|
|
#### Auth
|
|
|
|
- [`grpc_auth`](auth) - a customizable (via `AuthFunc`) piece of auth middleware
|
|
|
|
#### Logging
|
|
|
|
- [`grpc_ctxtags`](tags/) - a library that adds a `Tag` map to context, with data populated from request body
|
|
- [`grpc_zap`](logging/zap/) - integration of [zap](https://github.com/uber-go/zap) logging library into gRPC handlers.
|
|
- [`grpc_logrus`](logging/logrus/) - integration of [logrus](https://github.com/sirupsen/logrus) logging library into gRPC handlers.
|
|
- [`grpc_kit`](logging/kit/) - integration of [go-kit/log](https://github.com/go-kit/log) logging library into gRPC handlers.
|
|
- [`grpc_grpc_logsettable`](logging/settable/) - a wrapper around `grpclog.LoggerV2` that allows to replace loggers in runtime (thread-safe).
|
|
|
|
#### Monitoring
|
|
|
|
- [`grpc_prometheus`⚡](https://github.com/grpc-ecosystem/go-grpc-prometheus) - Prometheus client-side and server-side monitoring middleware
|
|
- [`otgrpc`⚡](https://github.com/grpc-ecosystem/grpc-opentracing/tree/master/go/otgrpc) - [OpenTracing](http://opentracing.io/) client-side and server-side interceptors
|
|
- [`grpc_opentracing`](tracing/opentracing) - [OpenTracing](http://opentracing.io/) client-side and server-side interceptors with support for streaming and handler-returned tags
|
|
- [`otelgrpc`](https://github.com/open-telemetry/opentelemetry-go-contrib/tree/main/instrumentation/google.golang.org/grpc/otelgrpc) - [OpenTelemetry](https://opentelemetry.io/) client-side and server-side interceptors
|
|
|
|
#### Client
|
|
|
|
- [`grpc_retry`](retry/) - a generic gRPC response code retry mechanism, client-side middleware
|
|
|
|
#### Server
|
|
|
|
- [`grpc_validator`](validator/) - codegen inbound message validation from `.proto` options
|
|
- [`grpc_recovery`](recovery/) - turn panics into gRPC errors
|
|
- [`ratelimit`](ratelimit/) - grpc rate limiting by your own limiter
|
|
|
|
|
|
## License
|
|
|
|
`go-grpc-middleware` is released under the Apache 2.0 license. See the [LICENSE](LICENSE) file for details.
|