info resume open source posts
gRPC API Gateway
github link
  • gRPC Gateway is a versatile tool that bridges the gap between gRPC services and HTTP-based APIs, including RESTful or WebSockets. It enables clients that do not support gRPC natively to communicate with gRPC servers using familiar HTTP and JSON formats. This capability is particularly valuable for integrating gRPC services into existing systems or for clients operating in environments where gRPC is not directly supported.
  • The gateway seamlessly translates incoming HTTP/JSON requests into corresponding gRPC calls, facilitating the integration of gRPC services into a wide range of applications. It offers additional functionalities such as request/response transformation, JSON request validation, and customizable error handling, enhancing the flexibility and robustness of the integration process.
  • Additionally, there is a versatile plugin that can generate a corresponding OpenAPI v3.1 document for the resulting HTTP API. However, since OpenAPI is generally meant to capture RESTful APIs, it does not automatically generate documentation for WebSocket bindings.
  • In essence, gRPC Gateway streamlines the exposure of gRPC services to clients that require HTTP-based interfaces, simplifying the development and deployment of services that cater to diverse client environments. This capability is especially beneficial for clients operating in web browsers, where direct gRPC support may be limited.
gRPC API Gateway Diagram
Go Shutdown
github link
  • Often, when looking to improve reliability of a service, I have found that health checks and shutdown processes are either not at all set up or not really thought through.
  • There are probably many other packages that can help setup shutdown process and signal handling.
  • I have tried to follow the golden rule to implement something small but really well and expandable. This package allows you to conveniently define shutdown procedures. If you have components that rely on each other, you can put them in sequence or run them in parallel and failure in one spot will not stop the rest of the shutdown processes.