https://github.com/containerd/ttrpc

GRPC for low-memory environments
https://github.com/containerd/ttrpc

go golang golang-library golang-package grpc protocol rpc stream

Last synced: 3 months ago
JSON representation

GRPC for low-memory environments

• Host: GitHub
• URL: https://github.com/containerd/ttrpc
• Owner: containerd
• License: apache-2.0
• Created: 2017-11-13T22:12:46.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2024-06-20T14:23:46.000Z (5 months ago)
• Last Synced: 2024-07-20T02:36:25.286Z (4 months ago)
• Topics: go, golang, golang-library, golang-package, grpc, protocol, rpc, stream
• Language: Go
• Size: 404 KB
• Stars: 531
• Watchers: 26
• Forks: 79
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-grpc - ttrpc - GRPC for low-memory environments (Language-Specific / Go)

README

        
# ttrpc

[![Build Status](https://github.com/containerd/ttrpc/actions/workflows/ci.yml/badge.svg)](https://github.com/containerd/ttrpc/actions/workflows/ci.yml)

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.

# Protocol

See the [protocol specification](./PROTOCOL.md).

# Usage

Create a gogo vanity binary (see

[`cmd/protoc-gen-gogottrpc/main.go`](cmd/protoc-gen-gogottrpc/main.go) for an

example with the ttrpc plugin enabled.

It's recommended to use [`protobuild`](https://github.com/containerd/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.

# Status

TODO:

- [ ] 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](./LICENSE).

As a containerd sub-project, you will find the:

 * [Project governance](https://github.com/containerd/project/blob/main/GOVERNANCE.md),

 * [Maintainers](https://github.com/containerd/project/blob/main/MAINTAINERS),

 * and [Contributing guidelines](https://github.com/containerd/project/blob/main/CONTRIBUTING.md)

information in our [`containerd/project`](https://github.com/containerd/project) repository.