Skip to content
GRPC for low-memory environments
Go
Branch: master
Clone or download
Latest commit 92c8520 Aug 28, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd/protoc-gen-gogottrpc Add apache license to files Jun 27, 2018
example metadata as KeyValue type Jun 13, 2019
plugin Add apache license to files Jun 27, 2018
.gitignore Initial commit Nov 13, 2017
.travis.yml Update to go 1.12x on travis Aug 26, 2019
LICENSE Initial commit Nov 13, 2017
README.md Add common check scripts and project references Oct 1, 2018
channel.go Refactor close handling for ttrpc clients Jun 13, 2019
channel_test.go Refactor close handling for ttrpc clients Jun 13, 2019
client.go Handle ok status Aug 28, 2019
codec.go Add apache license to files Jun 27, 2018
config.go Add godocs for interceptors Jun 12, 2019
handshake.go Add apache license to files Jun 27, 2018
interceptor.go Add godocs for interceptors Jun 12, 2019
metadata.go metadata as KeyValue type Jun 13, 2019
metadata_test.go metadata as KeyValue type Jun 13, 2019
server.go
server_test.go Merge pull request #42 from crosbymichael/client Jun 13, 2019
services.go Fix method full name generation Aug 23, 2019
services_test.go Fix method full name generation Aug 23, 2019
types.go metadata as KeyValue type Jun 13, 2019
unixcreds_linux.go Add apache license to files Jun 27, 2018

README.md

ttrpc

Build Status

GRPC for low-memory environments.

The existing grpc-go project requires a lot of memory overhead for importing packages and at runtime. While this is great for many services with low density requirements, this can be a problem when running a large number of services on a single machine or on a machine with a small amount of memory.

Using the same GRPC definitions, this project reduces the binary size and protocol overhead required. We do this by eliding the net/http, net/http2 and grpc package used by grpc replacing it with a lightweight framing protocol. The result are smaller binaries that use less resident memory with the same ease of use as GRPC.

Please note that while this project supports generating either end of the protocol, the generated service definitions will be incompatible with regular GRPC services, as they do not speak the same protocol.

Usage

Create a gogo vanity binary (see cmd/protoc-gen-gogottrpc/main.go for an example with the ttrpc plugin enabled.

It's recommended to use protobuild to build the protobufs for this project, but this will work with protoc directly, if required.

Differences from GRPC

  • The protocol stack has been replaced with a lighter protocol that doesn't require http, http2 and tls.
  • The client and server interface are identical whereas in GRPC there is a client and server interface that are different.
  • The Go stdlib context package is used instead.
  • No support for streams yet.

Status

Very new. YMMV.

TODO:

  • Plumb error codes and GRPC status
  • Remove use of any type and dependency on typeurl package
  • Ensure that protocol can support streaming in the future
  • Document protocol layout
  • Add testing under concurrent load to ensure
  • Verify connection error handling

Project details

ttrpc is a containerd sub-project, licensed under the Apache 2.0 license. As a containerd sub-project, you will find the:

information in our containerd/project repository.

You can’t perform that action at this time.