Update module google.golang.org/grpc to v1.63.2
This MR contains the following updates:
Package | Type | Update | Change |
---|---|---|---|
google.golang.org/grpc | require | minor |
v1.31.0 -> v1.63.2
|
Release Notes
grpc/grpc-go
v1.63.2
Bugs
- Fix the user agent string
v1.63.1
Bugs
- grpc: fixed subchannel log messages to properly reference the parent channel (#7101)
- Special thanks: @daniel-weisse
API Changes
- grpc: remove Deprecated tag from Dial and DialContext; these will be deprecated in v1.64 instead (#7103)
v1.63.0
Behavior Changes
- grpc: Return canonical target string from
resolver.Address.String()
(experimental) (#6923) - client & server: when using write buffer pooling, use input value for buffer size instead of size*2 (#6983)
- Special Thanks: @raghav-stripe
New Features
- grpc: add
ClientConn.CanonicalTarget()
to return the canonical target string. (#7006) - xds: implement LRS named metrics support (gRFC A64) (#7027)
- Special Thanks: @danielzhaotongliu
- grpc: introduce
grpc.NewClient
to allow users to create new clients in idle mode and with "dns" as the default resolver (#7010)- Special Thanks: @bruuuuuuuce
API Changes
- grpc: stabilize experimental method
ClientConn.Target()
(#7006)
Bug Fixes
- xds: fix an issue that would cause the client to send an empty list of resources for LDS/CDS upon reconnecting with the management server (#7026)
- server: Fix some errors returned by a server when using a
grpc.Server
as anhttp.Handler
with the Go stdlib HTTP server (#6989) - resolver/dns: add
SetResolvingTimeout
to allow configuring the DNS resolver's global timeout (#6917)- Special Thanks: @and1truong
- Set the security level of Windows named pipes to NoSecurity (#6956)
- Special Thanks: @irsl
v1.62.2
Dependencies
- Update http2 library to address vulnerability CVE-2023-45288
v1.62.1
Bug Fixes
- xds: fix a bug that results in
no matching virtual host found
RPC errors due to a difference between the target and LDS resource names (#6997) - server: fixed stats handler data
InPayload.Length
for unary RPC calls (#6766)- Special Thanks: @hueypark
- grpc: the experimental
RecvBufferPool
DialOption
andServerOption
are now active during unary RPCs with compression (#6766)- Special Thanks: @hueypark
- grpc: trim whitespaces in
accept-encoding
header before determining compressors- Special Thanks: @sercand
v1.62.0
New Features
- grpc: Add StaticMethod CallOption as a signal to stats handler that a method is safe to use as an instrument key (#6986)
Behavior Changes
- grpc: Return canonical target string from ClientConn.Target() and resolver.Address.String() (#6923)
Bug Fixes
- server: wait to close connection until incoming socket is drained (with timeout) to prevent data loss on client-side (#6977)
- Special Thanks: @s-matyukevich for discovering the root cause
Performance Improvements
- *: Allow building without
x/net/trace
by usinggrpcnotrace
to enable dead code elimination (#6954)- Special Thanks: @hugelgupf
- rand: improve performance and simplify implementation of
grpcrand
by adoptingmath/rand
's top-level functions for go version 1.21.0 and newer. (#6925)- Special Thanks: @kmirzavaziri
Dependencies
- *: Use google.golang.org/protobuf/proto instead of github.com/golang/protobuf. (#6919)
- Special Thanks: @Clement-Jean
[!NOTE] The above change in proto library usage introduces a minor behavior change within those libraries. The old
github.com/golang/protobuf
library would error if given anil
message toMarshal
, while the newgoogle.golang.org/protobuf
library will successfully output zero bytes in this case. This means server method handlers that didreturn nil, nil
will now return an empty message and no error, while it used to return an error. This also affects the client side, where clients sendingnil
messages used to fail without sending the RPC, and now they will send an empty message.
v1.61.2
Dependencies
- Update http2 library to address vulnerability CVE-2023-45288
v1.61.1
Bug Fixes
- server: wait to close connection until incoming socket is drained (with timeout) to prevent data loss on client-side (#6977)
- Special Thanks: @s-matyukevich for discovering the root cause
v1.61.0
New Features
- resolver: provide method,
AuthorityOverrider
, to allow resolver.Builders to override the default authority for aClientConn
. (EXPERIMENTAL) (#6752)- Special Thanks: @Aditya-Sood
- xds: add support for mTLS Credentials in xDS bootstrap (gRFC A65) (#6757)
- Special Thanks: @atollena
- server: add
grpc.WaitForHandlers
ServerOption
to causeServer.Stop
to block until method handlers return. (EXPERIMENTAL) (#6922)
Performance Improvements
- grpc: skip compression of empty messages as an optimization (#6842)
- Special Thanks: @jroper
- orca: use atomic pointer to improve performance in server metrics recorder (#6799)
- Special Thanks: @danielzhaotongliu
Bug Fixes
- client: correctly enable TCP keepalives with OS defaults on windows (#6863)
- Special Thanks: @mmatczuk
- server: change some stream operations to return
UNAVAILABLE
instead ofUNKNOWN
when underlying connection is broken (#6891)- Special Thanks: @mustafasen81
- server: fix
GracefulStop
to block until all method handlers return (v1.60 regression). (#6922) - server: fix two bugs that could lead to panics at shutdown when using
NumStreamWorkers
(EXPERIMENTAL). (#6856) - reflection: do not send invalid descriptors to clients for files that cannot be fully resolved (#6771)
- Special Thanks: @jhump
- xds: don't fail channel/server startup when xds creds is specified, but bootstrap is missing certificate providers (#6848)
- xds: Atomically read and write xDS security configuration client side (#6796)
- xds/server: fix RDS handling for non-inline route configs (#6915)
v1.60.1
Bug Fixes
- server: fix two bugs that could lead to panics at shutdown when using NumStreamWorkers (experimental feature).
v1.60.0
Security
- credentials/tls: if not set, set TLS MinVersion to 1.2 and CipherSuites according to supported suites not forbidden by RFC7540.
- This is a behavior change to bring us into better alignment with RFC 7540.
API Changes
- resolver: remove deprecated and experimental
ClientConn.NewServiceConfig
(#6784) - client: remove deprecated
grpc.WithServiceConfig
DialOption
(#6800)
Bug Fixes
- client: fix race that could cause a deadlock while entering idle mode and receiving a name resolver update (#6804)
- client: always enable TCP keepalives with OS defaults (#6834)
- credentials/alts: fix a bug preventing ALTS from connecting to the metadata server if the default scheme is overridden (#6686)
- Special Thanks: @mjamaloney
Behavior Changes
- server: Do not return from Stop() or GracefulStop() until all resources are released (#6489)
- Special Thanks: @fho
Documentation
- codes: clarify that only codes defined by this package are valid and that users should not cast other values to
codes.Code
(#6701)
v1.59.0
Behavior Changes
- balancer: grpc will switch to case-sensitive balancer names soon; log a warning if a capital letter is encountered in an LB policy name (#6647)
- server: allow applications to send arbitrary data in the
grpc-status-details-bin
trailer (#6662) - client: validate
grpc-status-details-bin
trailer and pass through the trailer to the application directly (#6662)
New Features
- tap (experimental): Add Header metadata to tap handler (#6652)
- Special Thanks: @pstibrany
- grpc: channel idleness enabled by default with an
idle_timeout
of30m
(#6585)
Documentation
- examples: add an example of flow control behavior (#6648)
Bug Fixes
- xds: fix hash policy header to skip "-bin" headers and read content-type header as expected (#6609)
v1.58.3
Security
-
server: prohibit more than MaxConcurrentStreams handlers from running at once (CVE-2023-44487)
In addition to this change, applications should ensure they do not leave running tasks behind related to the RPC before returning from method handlers, or should enforce appropriate limits on any such work.
v1.58.2
Bug Fixes
-
balancer/weighted_round_robin: fix ticker leak on update
A new ticker is created every time there is an update of addresses or configuration, but was not properly stopped. This change stops the ticker when it is no longer needed.
v1.58.1
Bug Fixes
- grpc: fix a bug that was decrementing active RPC count too early for streaming RPCs; leading to channel moving to IDLE even though it had open streams
- grpc: fix a bug where transports were not being closed upon channel entering IDLE
v1.58.0
API Changes
See #6472 for details about these changes.
- balancer: add
StateListener
toNewSubConnOptions
forSubConn
state updates and deprecateBalancer.UpdateSubConnState
(#6481)-
UpdateSubConnState
will be deleted in the future.
-
- balancer: add
SubConn.Shutdown
and deprecateBalancer.RemoveSubConn
(#6493)-
RemoveSubConn
will be deleted in the future.
-
- resolver: remove deprecated
AddressType
(#6451)- This was previously used as a signal to enable the "grpclb" load balancing policy, and to pass LB addresses to the policy. Instead,
balancer/grpclb/state.Set()
should be used to add these addresses to the name resolver's output. The built-in "dns" name resolver already does this.
- This was previously used as a signal to enable the "grpclb" load balancing policy, and to pass LB addresses to the policy. Instead,
- resolver: add new field
Endpoints
toState
and deprecateAddresses
(#6471)-
Addresses
will be deleted in the future.
-
New Features
- balancer/leastrequest: Add experimental support for least request LB policy and least request configured as a custom xDS policy (#6510, #6517)
- Set
GRPC_EXPERIMENTAL_ENABLE_LEAST_REQUEST=true
to enable
- Set
- stats: Add an RPC event for blocking caused by the LB policy's picker (#6422)
Bug Fixes
- clusterresolver: fix deadlock when dns resolver responds inline with update or error at build time (#6563)
- grpc: fix a bug where the channel could erroneously report
TRANSIENT_FAILURE
when actually moving toIDLE
(#6497) - balancergroup: do not cache closed sub-balancers by default; affects
rls
,weightedtarget
andclustermanager
LB policies (#6523) - client: fix a bug that prevented detection of RPC status in trailers-only RPC responses when using
ClientStream.Header()
, and prevented retry of the RPC (#6557)
Performance Improvements
- client & server: Add experimental
[With]SharedWriteBuffer
to improve performance by reducing allocations when sending RPC messages. (Disabled by default.) (#6309)- Special Thanks: @s-matyukevich
v1.57.2
Bug Fixes
- server: fix a bug introduced in v1.57.1 that causes connections to eventually stop processing any RPCs.
v1.57.1
Security
-
server: prohibit more than MaxConcurrentStreams handlers from running at once (CVE-2023-44487)
In addition to this change, applications should ensure they do not leave running tasks behind related to the RPC before returning from method handlers, or should enforce appropriate limits on any such work.
v1.57.0
API Changes
- resolver: remove deprecated
Target.Scheme
andTarget.Authority
. UseURL.Scheme
andURL.Host
instead, respectively (#6363)
Behavior Changes
- client: percent-encode the default authority for the channel (#6428)
- xds: require EDS service name to be set in a CDS cluster with an 'xdstp' resource name (gRFC A47) (#6438)
New Features
- reflection: support the v1 reflection service and update
Register
to register both v1alpha and v1 (#6329) - xds: add support for string matcher in RBAC header matching (#6419)
- alts: add support for
GRPC_ALTS_MAX_CONCURRENT_HANDSHAKES
env var (#6267) - balancer/weightedroundrobin: de-experimentalize name of LB policy (#6477)
Bug Fixes
- status:
status.FromError
now returns an error withcodes.Unknown
when the error implements theGRPCStatus()
method, and callingGRPCStatus()
returnsnil
(#6374)- Special Thanks: @atollena
- server: fix bug preventing TCP user timeout from being set on the connection when TLS is used (#6321)
- Special Thanks: @tobotg
- client: eliminate connection churn during an address update that differs only in balancer attributes (#6439)
- clusterresolver: handle EDS nacks, resource-not-found errors, and DNS Resolver errors correctly (#6436, #6461)
- xds/ringhash: cache connectivity state of subchannels inside picker to avoid rare races (#6351)
v1.56.3
Security
-
server: prohibit more than MaxConcurrentStreams handlers from running at once (CVE-2023-44487)
In addition to this change, applications should ensure they do not leave running tasks behind related to the RPC before returning from method handlers, or should enforce appropriate limits on any such work.
v1.56.2
- status: To fix a panic,
status.FromError
now returns an error withcodes.Unknown
when the error implements theGRPCStatus()
method, and callingGRPCStatus()
returnsnil
. (#6374)
v1.56.1
- client: handle empty address lists correctly in addrConn.updateAddrs
v1.56.0
New Features
- client: support channel idleness using
WithIdleTimeout
dial option (#6263)- This feature is currently disabled by default, but will be enabled with a 30 minute default in the future.
- client: when using pickfirst, keep channel state in TRANSIENT_FAILURE until it becomes READY (gRFC A62) (#6306)
- xds: Add support for Custom LB Policies (gRFC A52) (#6224)
- xds: support pick_first Custom LB policy (gRFC A62) (#6314) (#6317)
- client: add support for pickfirst address shuffling (gRFC A62) (#6311)
- xds: Add support for String Matcher Header Matcher in RDS (#6313)
- xds/outlierdetection: Add Channelz Logger to Outlier Detection LB (#6145)
- Special Thanks: @s-matyukevich
- xds: enable RLS in xDS by default (#6343)
- orca: add support for application_utilization field and missing range checks on several metrics setters
- balancer/weightedroundrobin: add new LB policy for balancing between backends based on their load reports (gRFC A58) (#6241)
- authz: add conversion of json to RBAC Audit Logging config (#6192)
- authz: add support for stdout logger (#6230 and #6298)
- authz: support customizable audit functionality for authorization policy (#6192 #6230 #6298 #6158 #6304 and #6225)
Bug Fixes
- orca: fix a race at startup of out-of-band metric subscriptions that would cause the report interval to request 0 (#6245)
- xds/xdsresource: Fix Outlier Detection Config Handling and correctly set xDS Defaults (#6361)
- xds/outlierdetection: Fix Outlier Detection Config Handling by setting defaults in ParseConfig() (#6361)
API Changes
- orca: allow a ServerMetricsProvider to be passed to the ORCA service and ServerOption (#6223)
v1.55.1
- status: To fix a panic,
status.FromError
now returns an error withcodes.Unknown
when the error implements theGRPCStatus()
method, and callingGRPCStatus()
returnsnil
. (#6374)
v1.55.0
Behavior Changes
- xds: enable federation support by default (#6151)
- status:
status.Code
andstatus.FromError
handle wrapped errors (#6031 and #6150)- Special Thanks: @psyhatter
New Features
- xds/xdsclient: support
ignore_resource_deletion
server feature as per gRFC A53 (#6035) - security/advancedtls: add min/max TLS version selection options (#6007)
- Special Thanks: @joeljeske
Bug Fixes
- xds: stop routing RPCs to deleted clusters (#6125)
- client: fix race between stream creation and GOAWAY receipt, which could lead to spurious UNAVAILABLE stream errors (#6142)
Performance Improvements
- server: improve stream handler goroutine worker allocation when
NumStreamWorkers
is used (#6004)- Special Thanks: @SaveTheRbtz
v1.54.1
Bug Fixes
- credentials/alts: revert a change that causes a crash in the handshaker
v1.54.0
Behavior Changes
- xds: remove support for xDS v2 transport API (#6013)
New Features
- server: expose
SetSendCompressor
API to set send compressor name (#5744)- Special Thanks: @jronak
- xdsclient: include
Node
proto only in the first discovery request message, to improve performance (#6078)
Bug Fixes
- metadata: fix validation logic and properly validate metadata appended via
AppendToOutgoingContext
(#6001)- Special Thanks: @ktalg
- transport: do not close connections when we encounter I/O errors until after all data is consumed (#6110)
- ringhash: ensure addresses are consistently hashed across updates (#6066)
- xds/clusterimpl: fix a bug causing unnecessary closing and re-opening of LRS streams (#6112)
- xds: NACK route configuration if sum of weights of weighted clusters exceeds uint32_max (#6085)
Documentation
- resolver: update
Resolver.Scheme()
docstring to mention requirement of lowercase scheme names (#6014) - resolver: document expected error handling of
UpdateState
errors (#6002)- Special Thanks: @fho
- examples: add example for ORCA load reporting (#6114)
- examples: add an example to illustrate authorization (authz) support (#5920)
- Special Thanks: @KenxinKun
v1.53.0
API Changes
- balancer: support injection of per-call metadata from LB policies (#5853)
- resolver: remove deprecated field
resolver.Target.Endpoint
and replace withresolver.Target.Endpoint()
(#5852)- Special Thanks: @kylejb
New Features
- xds/ringhash: introduce
GRPC_RING_HASH_CAP
environment variable to override the maximum ring size. (#5884) - rls: propagate headers received in RLS response to backends (#5883)
Bug Fixes
- transport: drain client transport when streamID approaches MaxStreamID (#5889)
- server: after GracefulStop, ensure connections are closed when final RPC completes (#5968)
- server: fix a few issues where grpc server uses RST_STREAM for non-HTTP/2 errors (#5893)
- xdsclient: fix race which can happen when multiple load reporting calls are made at the same time. (#5927)
- rls: fix a data race involving the LRU cache (#5925)
- xds: fix panic involving double close of channel in xDS transport (#5959)
- gcp/observability: update method name validation (#5951)
Documentation
- credentials/oauth: mark
NewOauthAccess
as deprecated (#5882)- Special Thanks: @buzzsurfr
v1.52.3
Bug Fixes
- Fix user-agent version
v1.52.1
Bug Fixes
- grpclb: rename grpclbstate package back to state (#5963)
v1.52.0
New Features
- xdsclient: log node ID with verbosity INFO (#5860)
- ringhash: impose cap on
max_ring_size
to reduce possibility of OOMs (#5801)
Behavior Changes
- client: return an error from
Dial
if an empty target is passed and no custom dialer is present; the ClientConn would otherwise be unable to connect and perform RPCs (#5732)- Special Thanks: @huangchong94
Bug Fixes
- transport (net/http server handler): respond to bad HTTP requests with status 400 (Bad Request) instead of 500 (Internal Server Error). (#5804)
- Special Thanks: @sjbarag
- transport: Fixed closing a closed channel panic in handlePing (#5854)
- server: fix ChainUnaryInterceptor and ChainStreamInterceptor to allow retrying handlers (#5666)
- Special Thanks: @yiminc
- transport: ensure value of
:authority
header matches server name used in TLS handshake when the latter is overridden by the name resolver (#5748)- Special Thanks: @holdno
Documentation
- examples: add an example to illustrate the usage of stats handler (#5657)
- Special Thanks: @Yash-Handa
- examples: add new example to show updating metadata in interceptors (#5788)
- Special Thanks: @richzw
v1.51.0
Behavior Changes
- xds: NACK EDS resources with duplicate addresses in accordance with a recent spec change (#5715)
- Special Thanks: @erni27
- grpc: restrict status codes that can be generated by the control plane (gRFC A54) (#5653)
New Features
- client: set grpc-accept-encoding header with all registered compressors (#5541)
- Special Thanks: @jronak
- xds/weightedtarget: return a more meaningful error when all child policies are in
TRANSIENT_FAILURE
(#5711) - gcp/observability: add "started rpcs" metric (#5768)
- xds: de-experimentalize the google-c2p-resolver (#5707)
- balancer: add experimental Producer types and methods (#5669)
- orca: provide a way for LB policies to receive OOB load reports (#5669)
Bug Fixes
- go.mod: upgrade x/text dependency to address CVE 2022-32149 (#5769)
- client: fix race that could lead to an incorrect connection state if it was closed immediately after the server's HTTP/2 preface was received (#5714)
- Special Thanks: @fuweid
- xds: ensure sum of the weights of all EDS localities at the same priority level does not exceed uint32 max (#5703)
- Special Thanks: @erni27
- client: fix binary logging bug which logs a server header on a trailers-only response (#5763)
- balancer/priority: fix a bug where unreleased references to removed child policies (and associated state) was causing a memory leak (#5682)
- xds/google-c2p: validate URI schema for no authorities (#5756)
v1.50.1
New Features
- gcp/observability: support new configuration defined in public preview user guide
v1.50.0
Behavior Changes
-
client: use proper "@" semantics for connecting to abstract unix sockets. (#5678)
- This is technically a bug fix; the result is that the address was including a trailing NULL byte, which it should not have. This may break users creating the socket in Go by prefixing a NULL instead of an "@", though, so calling it out as a behavior change.
- Special Thanks: @jachor
New Features
- metadata: add experimental
ValueFromIncomingContext
to more efficiently retrieve a single value (#5596)- Special Thanks: @horpto
- stats: provide peer information in
HandleConn
context (#5589)- Special Thanks: @feihu-stripe
- xds: add support for Outlier Detection, enabled by default (#5435, #5673)
Bug Fixes
- client: fix deadlock in transport caused by GOAWAY racing with stream creation (#5652)
- This should only occur with an HTTP/2 server that does not follow best practices of an advisory GOAWAY (not a grpc-go server).
- xds/xdsclient: fix a bug which was causing routes with
cluster_specifier_plugin
set to be NACKed when GRPC_EXPERIMENTAL_XDS_RLS_LB was off (#5670) - xds/xdsclient: NACK cluster resource if
config_source_specifier
inlrs_server
is notself
(#5613) - xds/ringhash: fix a bug which sometimes prevents the LB policy from retrying connection attempts (#5601)
- xds/ringhash: do nothing when asked to exit
IDLE
instead of falling back on the default channel behavior of connecting to all addresses (#5614) - xds/rls: fix a bug which was causing the channel to be stuck in
IDLE
(#5656) - alts: fix a bug which was setting
WaitForReady
on handshaker service RPCs, thereby delaying fallback when required (#5620) - gcp/observability: fix End() to cleanup global state correctly (#5623)
v1.49.0
New Features
- gcp/observability: add support for Environment Variable
GRPC_CONFIG_OBSERVABILITY_JSON
(#5525) - gcp/observability: add support for custom tags (#5565)
Behavior Changes
- server: reduce log level from Warning to Info for early connection establishment errors (#5524)
- Special Thanks: @jpkrohling
Bug Fixes
- client: fix race in flow control that could lead to unexpected EOF errors (#5494)
- client: fix a race that could cause RPCs to time out instead of failing more quickly with UNAVAILABLE (#5503)
- client & server: fix a panic caused by passing a
nil
stats handler togrpc.WithStatsHandler
orgrpc.StatsHandler
(#5543) - transport/server: fix a race that could cause a stray header to be sent (#5513)
- balancer: give precedence to
IDLE
overTRANSIENT_FAILURE
when aggregating connectivity state (#5473) - xds/xdsclient: request correct resource name when user specifies a new style resource name with empty authority (#5488)
- xds/xdsclient: NACK endpoint resources with zero weight (#5560)
- xds/xdsclient: fix bug that would reset resource version information after ADS stream restart (#5422)
- xds/xdsclient: fix goroutine leaks when load reporting is enabled (#5505)
- xds/ringhash: fix config update processing to recreate ring and picker when min/max ring size changes (#5557)
- xds/ringhash: avoid recreating subChannels when update doesn't change address weight information (#5431)
- xds/priority: fix bug which could cause priority LB to block all traffic after a config update (#5549)
- xds: fix bug when environment variable
GRPC_EXPERIMENTAL_ENABLE_OUTLIER_DETECTION
is set to true (#5537)
v1.48.0
Bug Fixes
- xds/priority: fix bug that could prevent higher priorities from receiving config updates (#5417)
- RLS load balancer: don't propagate the status code returned on control plane RPCs to data plane RPCs (#5400)
New Features
- stats: add support for multiple stats handlers in a single client or server (#5347)
- gcp/observability: add experimental OpenCensus tracing/metrics support (#5372)
- xds: enable aggregate and logical DNS clusters by default (#5380)
- credentials/google (for xds): support xdstp C2P cluster names (#5399)
v1.47.0
New Features
- xds: add support for RBAC metadata invert matchers (#5345)
Bug Fixes
- client: fix a context leaked if a connection to an address is lost before it is fully established (#5337)
- Special Thanks: @carzil
- client: fix potential panic during RPC retries (#5323)
- xds/client: fix a potential concurrent map read/write in load reporting (#5331)
- client/SubConn: do not recreate addrConn if UpdateAddresses is called with the same addresses (#5373)
- xds/eds: resources containing duplicate localities with the same priority will be rejected (#5303)
- server: return Canceled or DeadlineExceeded status code when writing headers to a stream that is already closed (#5292)
- Special Thanks: @idiamond-stripe
Behavior Changes
- xds/priority: start the init timer when a child switches to Connecting from non-failure states (#5334)
- server: respond with HTTP Status 405 and gRPC status INTERNAL if the method sent to server is not POST (#5364)
Documentation
- server: clarify documentation around setting and sending headers and ServerStream errors (#5302)
v1.46.2
Bug Fixes
- client: fix potential panic during RPC retries (#5323)
- xds: fix leak of deleted CDS resources from CSDS view (#5339)
v1.46.1
v1.46.0
New Features
- server: Support setting
TCP_USER_TIMEOUT
ongrpc.Server
connections usingkeepalive.ServerParameters.Time
(#5219)- Special Thanks: @bonnefoa
- client: perform graceful switching of LB policies in the
ClientConn
by default (#5285) - all: improve logging by including channelz identifier in log messages (#5192)
API Changes
- grpc: delete
WithBalancerName()
API, deprecated over 4 years ago in #1697 (#5232) - balancer: change BuildOptions.ChannelzParentID to an opaque identifier instead of int (#5192)
- Note: the balancer package is labeled as EXPERIMENTAL, and we don't believe users were using this field.
Behavior Changes
- client: change connectivity state to
TransientFailure
inpick_first
LB policy when all addresses are removed (#5274)- This is a minor change that brings grpc-go's behavior in line with the intended behavior and how C and Java behave.
- metadata: add client-side validation of HTTP-invalid metadata before attempting to send (#4886)
- Special Thanks: @Patrick0308
Bug Fixes
- metadata: make a copy of the value slices in FromContext() functions so that modifications won't be made to the original copy (#5267)
- client: handle invalid service configs by applying the default, if applicable (#5238)
- xds: the xds client will now apply a 1 second backoff before recreating ADS or LRS streams (#5280)
Dependencies
- Upgrade security/authorization module dependencies to https://github.com/google/cel-go v0.10.1 and others (#5243)
- Special Thanks: @TristonianJones
v1.45.0
Bug Fixes
- xds/clusterresolver: pass cluster name to DNS child policy to be used in creds handshake (#5119)
- reflection: support dynamic messages (#5180)
- Special Thanks: @codebutler
Performance Improvements
- wrr: improve randomWRR performance (#5067)
- Special Thanks: @huangchong94
Behavior Changes
- server: convert context errors returned by service handlers to status with the correct status code (
Canceled
orDeadlineExceeded
), instead ofUnknown
(#5156)
New Features
- reflection: add
NewServer(ServerOptions)
for creating a reflection server with advanced customizations (#5197) - xds: support federation (#5128)
- xds/resource: accept Self as LDS's RDS config source and CDS's EDS config source (#5152)
- xds/bootstrap: add plugin system for credentials specified in bootstrap file (#5136)
v1.44.0
New Features
- balancer: add RLS load balancing policy (#5046)
- xds: add RLS Cluster Specifier Plugin (#5004)
- insecure: remove experimental notice (#5069)
Bug Fixes
- internal/balancergroup: eliminate race in exitIdle (#5012)
- authz: fix regex expression match (#5035)
Documentation
- grpc: minor improvement on WithInsecure() document (#5068)
- Special Thanks: @shitian-ni
- attributes: document that some value types (e.g.
map
s) must implement Equal (#5109) - dialoptions.go: Fix WithBlock godoc (#5073)
- Special Thanks: @sgreene570
- grpclog.DepthLoggerV2: Correct comment: formats like fmt.Println (#5038)
- Special Thanks: @evanj
v1.43.0
API Changes
- grpc: stabilize
WithConnectParams
DialOption
(#4915)- Special Thanks: @hypnoglow
Behavior Changes
- status: support wrapped errors in
FromContextError
(#4977)- Special Thanks: @bestbeforetoday
- config: remove the environment variable to disable retry support (#4922)
New Features
- balancer: new field
Authority
inBuildOptions
for server name to use in the authentication handshake with a remote load balancer (#4969)
Bug Fixes
- xds/resolver: fix possible
ClientConn
leak upon resolver initialization failure (#4900) - client: fix
nil
panic in rare race conditions with the pick first LB policy (#4971) - xds: improve RPC error messages when xDS connection errors occur (#5032, #5054)
- transport: do not create stream object in the face of illegal stream IDs (#4873)
- Special Thanks: @uds5501
Documentation
- client: clarify errors to indicate whether compressed or uncompressed messages exceeded size limits (#4918)
- Special Thanks: @uds5501
v1.42.0
Behavior Changes
- grpc: Dial("unix://relative-path") no longer works (#4817)
- use "unix://absolute-path" or "unix:relative-path" instead in accordance with our documentation
- xds/csds: use new field
GenericXdsConfig
instead ofPerXdsConfig
(#4898) - transport: server transport will reject requests with
connection
header (#4803)
New Features
- grpc: support
grpc.WithAuthority
when secure credentials are used (#4817) - creds/google: add NewDefaultCredentialsWithOptions() to support custom per-RPC creds (#4767, #4830)
- authz: create file watcher interceptor for gRPC SDK API (#4760)
- attributes: add
Equal
method (#4855) - resolver: add
AddressMap
andState.BalancerAttributes
(#4855) - resolver: Add
URL
field toTarget
to store parsed dial target (#4817) - grpclb: add a
target_name
field to lb config to specify target when used as a child policy (#4847) - grpclog: support formatting log output as JSON (#4854)
Bug Fixes
- server: add missing conn.Close if the connection dies before reading the HTTP/2 preface (#4837)
- grpclb: recover if addresses are received after an empty server list was received previously (#4879)
- authz: support empty principals and fix rbac authenticated matcher (#4883)
- xds/rds: NACK the RDS response if it contains unknown cluster specifier (#4788)
- xds/priority: do not switch to low priority when high priority is in Idle (e.g. ringhash) (#4889)
Documentation
- grpc: stabilize WithDefaultServiceConfig and improve godoc (#4888)
- status: clarify FromError docstring (#4880)
- examples: add example illustrating the use of unix abstract sockets (#4848)
- examples: update load balancing example to use loadBalancingConfig (#4887)
- doc: promote WithDisableRetry to stable; clarify retry is enabled by default (#4901)
API Changes
- credentials: Mark
TransportCredentials.OverrideServerName
method as deprecated (#4817)
v1.41.1
- creds/google: add NewDefaultCredentialsWithOptions() to support custom per-RPC creds (#4767, #4830)
- pickfirst: check b.sc before calling Connect (#4971)
v1.41.0
API Changes
- xds: Promote xds server and creds APIs to stable (#4753)
- balancer: add
ExitIdle
interface to instruct the balancer to attempt to leave the IDLE state by connecting SubConns if appropriate. (#4673)-
NOTICE: This method will be required by the
Balancer
interface in the future
-
NOTICE: This method will be required by the
Behavior Changes
- xds: update xdsclient to keep valid resources from the response even if it has invalid responses and is NACK'ed (see gRFC 260) (#4743)
- balancer: SubConns no longer automatically reconnect after READY; instead they transition to IDLE on connection loss (#4613)
New Features
- xds: add support for RINGHASH lb-policy and affinity (#4741)
- xds: add support for retry policy in VirtualHosts and Routes (#4738)
- stats: support stats for all retry attempts; support transparent retry (#4749)
- authz: create interceptors for gRPC security policy API (#4664)
Bug Fixes
- transport: fix race in transport stream accessing s.recvCompress (#4641)
- client: fix transparent retries when per-RPC credentials are in use (#4785)
- server: fix bug that net.Conn is leaked if the connection is closed (io.EOF) immediately with no traffic (#4633)
- oauth: Allow access to Google API regional endpoints via Google Default Credentials (#4713)
v1.40.1
- creds/google: add NewDefaultCredentialsWithOptions() to support custom per-RPC creds (#4767, #4830)
v1.40.0
Behavior Changes
- balancer: client channel no longer connects to idle subchannels that are returned by the pickers; LB policy should call SubConn.Connect instead. (#4579)
- This change is in line with existing documentation stating the balancer must call Connect on idle SubConns in order for them to connect, and is preparation for an upcoming change that transitions SubConns to the idle state when connections are lost. See https://pkg.go.dev/google.golang.org/grpc/balancer#SubConn for more details.
Bug Fixes
- transport: fail RPCs without HTTP status 200 (OK), according to the gRPC spec (#4474)
- Special Thanks: @JNProtzman
- binarylog: fail the
Write()
method if proto marshaling fails (#4582)- Special Thanks: @Jille
- binarylog: exit the flusher goroutine upon closing the
bufferedSink
(#4583)- Special Thanks: @Jille
New Features
- metadata: add Delete method to MD to encapsulate lowercasing (#4549)
- Special Thanks: @konradreiche
- xds/cds: support logical DNS cluster and aggregated cluster (#4594)
- stats: add stats.Begin.IsClientStream and IsServerStream to indicate the type of RPC invoked (#4533)
- Special Thanks: @leviska
Performance Improvements
- server: improve performance when multiple interceptors are used (#4524)
- Special Thanks: @amenzhinsky
v1.39.1
- server: fix bug that net.Conn is leaked if the connection is closed (io.EOF) immediately with no traffic (#4642)
- transport: fix race in transport stream accessing s.recvCompress (#4627)
v1.39.0
Behavior Changes
- csds: return empty response if xds client is not set (#4505)
- metadata: convert keys to lowercase in FromContext() (#4416)
New Features
- xds: add GetServiceInfo to GRPCServer (#4507)
- Special Thanks: @amenzhinsky
- xds: add test-only injection of xds config to client and server (#4476)
- server: allow PreparedMsgs to work for server streams (#3480)
- Special Thanks: @eafzali
Performance Improvements
- transport: remove decodeState from client & server to reduce allocations (#4423)
- Special Thanks: @JNProtzman
Bug Fixes
- server: return UNIMPLEMENTED on receipt of malformed method name (#4464)
- xds/rds: use 100 as default weighted cluster totalWeight instead of 0 (#4439)
- Special Thanks: @alpha-baby
- transport: unblock read throttling when controlbuf exits (#4447)
- client: fix status code to return Unavailable for servers shutting down instead of Unknown (#4561)
Documentation
- doc: fix broken benchmark dashboard link in README.md (#4503)
- Special Thanks: @laststem
- example: improve hello world server with starting msg (#4468)
- Special Thanks: @dkkb
- client: Clarify that WaitForReady will block for CONNECTING channels (#4477)
- Special Thanks: @evanj
v1.38.1
internal/transport: do not mask ConnectionError (#4561)
v1.38.0
API Changes
- reflection: accept interface instead of grpc.Server struct in Register() (#4340)
- resolver: add error return value from ClientConn.UpdateState (#4270)
Behavior Changes
- client: do not poll name resolver when errors or bad updates are reported (#4270)
- transport: InTapHandle may return RPC status errors; no longer RST_STREAMs (#4365)
New Features
- client: propagate connection error causes to RPC status (#4311, #4316)
- xds: support inline RDS resource from LDS response (#4299)
- xds: server side support is now experimentally available
- server: add ForceServerCodec() to set a custom encoding.Codec on the server (#4205)
- Special Thanks: @ash2k
Performance Improvements
- metadata: reduce memory footprint in FromOutgoingContext (#4360)
- Special Thanks: @irfansharif
Bug Fixes
- xds/balancergroup: fix rare memory leak after closing ClientConn (#4308)
Documentation
v1.37.1
- client: fix rare panic when shutting down client while receiving the first name resolver update (#4398)
- client: fix leaked addrConn struct when addresses are updated (#4347)
- xds/resolver: prevent panic when two LDS updates are receives without RDS in between (#4327)
v1.37.0
API Changes
- balancer: Add UpdateAddresses() to balancer.ClientConn interface (#4215)
- NOTICE: balancer.SubConn.UpdateAddresses() is now deprecated and will be REMOVED in gRPC-Go 1.39
Behavior Changes
- balancer/base: keep address attributes for pickers (#4253)
- Special Thanks: @longXboy
New Features
- xds: add support for csds (#4226, #4217, #4243)
- admin: create admin package for conveniently registering standard admin services (#4274)
- xds: add support for HTTP filters (gRFC A39) (#4206, #4221)
- xds: implement fault injection HTTP filter (A33) (#4236)
- xds: enable timeout, circuit breaking, and fault injection by default (#4286)
- xds: implement a priority based load balancer (#4070)
- xds/creds: support all SAN matchers on client-side (#4246)
Bug Fixes
- xds: add env var protection for client-side security (#4247)
- circuit breaking: update picker inline when there's a counter update (#4212)
- server: fail RPCs without POST HTTP method (#4241)
v1.36.1
- xds: add env var protection for client-side security (#4247)
v1.36.0
New Features
- xds bootstrap: support config content in env variable (#4153)
Bug Fixes
- encoding/proto: do not panic when types do not match (#4218)
Documentation
- status: document nil error handling of FromError (#4196)
- Special Thanks: @gauravgahlot
v1.35.1
- encoding/proto: do not panic when types do not match (#4218)
- xds: add env var protection for client-side security (#4247)
v1.35.0
Behavior Changes
- roundrobin: strip attributes from addresses (#4024)
- balancer: set RPC metadata in address attributes, instead of Metadata field (#4041)
New Features
- support unix-abstract schema (#4079)
- Special Thanks: @resec
- xds: implement experimental RouteAction timeout support (#4116)
- xds: Implement experimental circuit breaking support. (#4050)
Bug Fixes
- xds:
server_features
should be a child ofxds_servers
and not a sibling (#4087) - xds: NACK more invalid RDS responses (#4120)
v1.34.2
- encoding/proto: do not panic when types do not match (#4218)
- xds: add env var protection for client-side security (#4247)
v1.34.1
- xds client: Updated v3 type for http connection manager (#4137)
- lrs: use JSON for locality's String representation (#4135)
- eds/lrs: handle nil when LRS is disabled (#4086)
- client: fix "unix" scheme handling for some corner cases (#4021)
v1.34.0
New Features
- client: implement support for "unix" resolver scheme (#3890)
- rds: allow case_insensitive path matching (#3997)
- credentials/insecure: implement insecure credentials. (#3964)
- lrs: handle multiple clusters in LRS stream (#3935)
Performance Improvements
- encoding/proto: simplify & optimize proto codec (#3958)
Bug Fixes
- internal/transport: fix a bug causing -bin metadata to be incorrectly encoded (#3985)
- Special Thanks: @dntj
- grpclb: consider IDLE SubConns as connecting (#4031)
- grpclb: send custom user-agent (#4011)
- client: use "localhost:port" as authority if target is ":port" (#4017)
- credentials: fix PerRPCCredentials w/RequireTransportSecurity and security levels (#3995)
Documentation
- Documentation: fix outgoing metadata example code (#3979)
- Special Thanks: @aaronjheng
- Remove experimental comment from client interceptors (#3948)
- Special Thanks: @hypnoglow
- Documentation: update keepalive.md to add why (#3993)
v1.33.3
- xds client: Updated v3 type for http connection manager (#4137)
- lrs: use JSON for locality's String representation (#4135)
- eds/lrs: handle nil when LRS is disabled (#4086)
v1.33.2
- protobuf: update all generated code to google.golang.org/protobuf (#3932)
- xdsclient: populate error details for NACK (#3975)
- internal/credentials: fix a bug and add one more helper function SPIFFEIDFromCert (#3929)
v1.33.1
API Changes
- connectivity: remove unused, experimental Reporter interface (#3875)
New Features
- xds bootstrap: support insecure and make Creds required (#3881)
- xds: add bootstrap support for certificate providers. (#3901)
- lrs: add a layer for clusters in load store (#3880)
- credentials/xds: implementation of client-side xDS credentials. (#3888)
Bug Fixes
- http2_client: fix reader segfault on MROTOCOL_ERRORs (#3926)
- Special Thanks: @sorah
- internal/transport: handle h2 errcode on header decoding (#3872)
- Special Thanks: @tz70s
- xds: exit from run() goroutine when resolver is closed. (#3882)
- credentials/alts: ClientAuthorizationCheck to case-fold compare of peer SA (#3792)
- Special Thanks: @AntonNep
- service reflection: include transitive closure for a file (#3851)
- stats: include message header in stats.InPayload.WireLength (#3886)
- Special Thanks: @xstephen95x
- binarylog: export Sink (#3879)
- service reflection: include transitive closure for a file (#3851)
v1.32.0
Dependencies
- Remove Go 1.9 support; assume go1.12 build tag (#3767)
New Features
- grpc: add ServiceRegistrar interface; bump up support package version. (#3816; #3818)
- xds: add LRS balancing policy (#3799)
Bug Fixes
- server: prevent hang in Go HTTP transport in some error cases (#3833)
- server: respond correctly to client headers with END_STREAM flag set (#3803)
- eds: fix priority timeout failure when EDS removes all priorities (#3830)
v1.31.1
- eds: fix priority timeout failure when EDS removes all priorities (#3839)
Configuration
-
If you want to rebase/retry this MR, click this checkbox.
This MR has been generated by Renovate Bot.