proxy.golang.org : github.com/bufbuild/httplb

Package httplb provides http.Client instances that are suitable for use for server-to-server communications, like RPC. This adds features on top of the standard net/http library for name/address resolution, health checking, and load balancing. It also provides more suitable defaults and much simpler support for HTTP/2 over plaintext. To create a new client use the NewClient function. This function accepts numerous options, many for configuring the behavior of the underlying transports. It also provides options for using a custom name resolver or a custom load balancing policy and for enabling active health checking. The returned client also has a notion of "closing", via its Close method. This step will wait for outstanding requests to complete and then close all connections and also teardown any other goroutines that it may have started to perform name resolution and health checking. The client cannot be used after it has been closed. Without any options, the returned client behaves differently than http.DefaultClient in the following key ways: The client will re-resolve addresses in DNS every 5 minutes. The http.DefaultClient does not re-resolve predictably. The client will route requests in a round-robin fashion to the addresses returned by the DNS system, preferring A records if present (but using AAAA records if no A records are present), even with HTTP/2. This differs from the http.DefaultClient, which will use only a single connection if it can, even if DNS resolves many addresses. With HTTP 1.1, an http.DefaultClient will create additional connections to handle multiple concurrent requests (since an HTTP 1.1 connection can only service one request at a time). But with HTTP/2, it likely will *never* use additional connections: it only creates another connection if the concurrency limit exceeds the server's "max concurrent streams" (which the server provides when the connection is initially established and is typically on the order of 100). The above behavior alone should make the httplb.Client distribute load to backends in a much more appropriate way, especially when using HTTP/2. But the real power of a client returned by this package is that it can be customized with different name resolution and load balancing policies, via the WithResolver and WithPicker options. Active health checking can be enabled via the WithHealthChecks option. Note that the behavior regarding A and AAAA records differs from the http.DefaultClient. In http.DefaultClient, the underlying connections use net.Dial directly on the provided hostname from the URL, and net.Dial in turn implements an RFC 6555 fallback to ensure that connections can be established even in the face of broken IPv6 configurations. Meanwhile, httplb.Client defaults to resolving the name eagerly and treating the resolved addresses as individual targets instead. In order to ensure maximum compatibility out of the box, the default behavior is to prefer IPv4 addresses whenever they are available: if DNS resolution returns both IPv4 and IPv6 addresses, only the IPv4 addresses will be used. Meanwhile, if DNS resolution only returns IPv6 addresses, those will be used instead. To override this behavior, use WithResolver and instantiate the DNS resolver with a different resolver.AddressFamilyPolicy value. For example, to prefer IPv6 addresses instead, one could use: The clients created by this function use a transport implementation that is actually a hierarchy of three layers: One of the options in this package, WithTransport, allows users to implement custom transports and select them using custom URL schemes. This could be used, for example, to enable HTTP/3 with a URL such as "http3://...". This package even uses this capability to provide simple use of HTTP/2 over plaintext, also called "h2c". In addition to supporting "http" and "https" URL schemes, this package also supports "h2c" as a URL scheme.

Registry - Source - Documentation - JSON
purl: pkg:golang/github.com/bufbuild/httplb
Keywords: connectrpc , golang , http , load-balancer
License: Apache-2.0
Latest release: 5 months ago
First release: over 1 year ago
Namespace: github.com/bufbuild
Dependent packages: 1
Dependent repositories: 1
Stars: 36 on GitHub
Forks: 2 on GitHub
See more repository details: repos.ecosyste.ms
Last synced: 4 days ago

• Readme
• Versions 5
• Dependent Packages 1
• Maintainers 0