package internal
import "google.golang.org/grpc/internal"
Package internal contains gRPC-internal code, to avoid polluting the godoc of the top-level grpc package. It must not import any grpc symbols to avoid circular dependencies.
Index ¶
- Constants
- Variables
- func GetXDSHandshakeClusterName(attr *attributes.Attributes) (string, bool)
- func SetXDSHandshakeClusterName(addr resolver.Address, clusterName string) resolver.Address
- type HealthChecker
Constants ¶
const ( // CredsBundleModeFallback switches GoogleDefaultCreds to fallback mode. CredsBundleModeFallback = "fallback" // CredsBundleModeBalancer switches GoogleDefaultCreds to grpclb balancer // mode. CredsBundleModeBalancer = "balancer" // CredsBundleModeBackendFromBalancer switches GoogleDefaultCreds to mode // that supports backend returned by grpclb balancer. CredsBundleModeBackendFromBalancer = "backend-from-balancer" )
const RLSLoadBalancingPolicyName = "rls_experimental"
RLSLoadBalancingPolicyName is the name of the RLS LB policy.
It currently has an experimental suffix which would be removed once end-to-end testing of the policy is completed.
Variables ¶
var ( // WithHealthCheckFunc is set by dialoptions.go WithHealthCheckFunc interface{} // func (HealthChecker) DialOption // HealthCheckFunc is used to provide client-side LB channel health checking HealthCheckFunc HealthChecker // BalancerUnregister is exported by package balancer to unregister a balancer. BalancerUnregister func(name string) // KeepaliveMinPingTime is the minimum ping interval. This must be 10s by // default, but tests may wish to set it lower for convenience. KeepaliveMinPingTime = 10 * time.Second // ParseServiceConfig parses a JSON representation of the service config. ParseServiceConfig interface{} // func(string) *serviceconfig.ParseResult // EqualServiceConfigForTesting is for testing service config generation and // parsing. Both a and b should be returned by ParseServiceConfig. // This function compares the config without rawJSON stripped, in case the // there's difference in white space. EqualServiceConfigForTesting func(a, b serviceconfig.Config) bool // GetCertificateProviderBuilder returns the registered builder for the // given name. This is set by package certprovider for use from xDS // bootstrap code while parsing certificate provider configs in the // bootstrap file. GetCertificateProviderBuilder interface{} // func(string) certprovider.Builder // GetXDSHandshakeInfoForTesting returns a pointer to the xds.HandshakeInfo // stored in the passed in attributes. This is set by // credentials/xds/xds.go. GetXDSHandshakeInfoForTesting interface{} // func (*attributes.Attributes) *xds.HandshakeInfo // GetServerCredentials returns the transport credentials configured on a // gRPC server. An xDS-enabled server needs to know what type of credentials // is configured on the underlying gRPC server. This is set by server.go. GetServerCredentials interface{} // func (*grpc.Server) credentials.TransportCredentials // DrainServerTransports initiates a graceful close of existing connections // on a gRPC server accepted on the provided listener address. An // xDS-enabled server invokes this method on a grpc.Server when a particular // listener moves to "not-serving" mode. DrainServerTransports interface{} // func(*grpc.Server, string) // AddGlobalServerOptions adds an array of ServerOption that will be // effective globally for newly created servers. The priority will be: 1. // user-provided; 2. this method; 3. default values. AddGlobalServerOptions interface{} // func(opt ...ServerOption) // ClearGlobalServerOptions clears the array of extra ServerOption. This // method is useful in testing and benchmarking. ClearGlobalServerOptions func() // AddGlobalDialOptions adds an array of DialOption that will be effective // globally for newly created client channels. The priority will be: 1. // user-provided; 2. this method; 3. default values. AddGlobalDialOptions interface{} // func(opt ...DialOption) // ClearGlobalDialOptions clears the array of extra DialOption. This // method is useful in testing and benchmarking. ClearGlobalDialOptions func() // JoinServerOptions combines the server options passed as arguments into a // single server option. JoinServerOptions interface{} // func(...grpc.ServerOption) grpc.ServerOption // WithBinaryLogger returns a DialOption that specifies the binary logger // for a ClientConn. WithBinaryLogger interface{} // func(binarylog.Logger) grpc.DialOption // BinaryLogger returns a ServerOption that can set the binary logger for a // server. BinaryLogger interface{} // func(binarylog.Logger) grpc.ServerOption // NewXDSResolverWithConfigForTesting creates a new xds resolver builder using // the provided xds bootstrap config instead of the global configuration from // the supported environment variables. The resolver.Builder is meant to be // used in conjunction with the grpc.WithResolvers DialOption. // // Testing Only // // This function should ONLY be used for testing and may not work with some // other features, including the CSDS service. NewXDSResolverWithConfigForTesting interface{} // func([]byte) (resolver.Builder, error) // RegisterRLSClusterSpecifierPluginForTesting registers the RLS Cluster // Specifier Plugin for testing purposes, regardless of the XDSRLS environment // variable. // // TODO: Remove this function once the RLS env var is removed. RegisterRLSClusterSpecifierPluginForTesting func() // UnregisterRLSClusterSpecifierPluginForTesting unregisters the RLS Cluster // Specifier Plugin for testing purposes. This is needed because there is no way // to unregister the RLS Cluster Specifier Plugin after registering it solely // for testing purposes using RegisterRLSClusterSpecifierPluginForTesting(). // // TODO: Remove this function once the RLS env var is removed. UnregisterRLSClusterSpecifierPluginForTesting func() // RegisterRBACHTTPFilterForTesting registers the RBAC HTTP Filter for testing // purposes, regardless of the RBAC environment variable. // // TODO: Remove this function once the RBAC env var is removed. RegisterRBACHTTPFilterForTesting func() // UnregisterRBACHTTPFilterForTesting unregisters the RBAC HTTP Filter for // testing purposes. This is needed because there is no way to unregister the // HTTP Filter after registering it solely for testing purposes using // RegisterRBACHTTPFilterForTesting(). // // TODO: Remove this function once the RBAC env var is removed. UnregisterRBACHTTPFilterForTesting func() )
Functions ¶
func GetXDSHandshakeClusterName ¶
func GetXDSHandshakeClusterName(attr *attributes.Attributes) (string, bool)
GetXDSHandshakeClusterName returns cluster name stored in attr.
func SetXDSHandshakeClusterName ¶
SetXDSHandshakeClusterName returns a copy of addr in which the Attributes field is updated with the cluster name.
Types ¶
type HealthChecker ¶
type HealthChecker func(ctx context.Context, newStream func(string) (interface{}, error), setConnectivityState func(connectivity.State, error), serviceName string) error
HealthChecker defines the signature of the client-side LB channel health checking function.
The implementation is expected to create a health checking RPC stream by calling newStream(), watch for the health status of serviceName, and report it's health back by calling setConnectivityState().
The health checking protocol is defined at: https://github.com/grpc/grpc/blob/master/doc/health-checking.md
Source Files ¶
internal.go xds_handshake_cluster.go
Directories ¶
Path | Synopsis |
---|---|
internal/admin | Package admin contains internal implementation for admin service. |
internal/backoff | Package backoff implement the backoff strategy for gRPC. |
internal/balancer | |
internal/balancer/gracefulswitch | Package gracefulswitch implements a graceful switch load balancer. |
internal/balancergroup | Package balancergroup implements a utility struct to bind multiple balancers into one balancer. |
internal/balancerload | Package balancerload defines APIs to parse server loads in trailers. |
internal/balancer/stub | Package stub implements a balancer for testing purposes. |
internal/binarylog | Package binarylog implementation binary logging as defined in https://github.com/grpc/proposal/blob/master/A16-binary-logging.md. |
internal/buffer | Package buffer provides an implementation of an unbounded buffer. |
internal/cache | Package cache implements caches to be used in gRPC. |
internal/channelz | Package channelz defines APIs for enabling channelz service, entry registration/deletion, and accessing channelz data. |
internal/credentials | Package credentials defines APIs for parsing SPIFFE ID. |
internal/credentials/xds | Package xds contains non-user facing functionality of the xds credentials. |
internal/envconfig | Package envconfig contains grpc settings configured by environment variables. |
internal/googlecloud | Package googlecloud contains internal helpful functions for google cloud. |
internal/grpclog | Package grpclog (internal) defines depth logging for grpc. |
internal/grpcrand | Package grpcrand implements math/rand functions in a concurrent-safe way with a global random source, independent of math/rand's global source. |
internal/grpcsync | Package grpcsync implements additional synchronization primitives built upon the sync package. |
internal/grpctest | Package grpctest implements testing helpers. |
internal/grpcutil | Package grpcutil provides utility functions used across the gRPC codebase. |
internal/hierarchy | Package hierarchy contains functions to set and get hierarchy string from addresses. |
internal/leakcheck | Package leakcheck contains functions to check leaked goroutines. |
internal/metadata | Package metadata contains functions to set and get metadata from addresses. |
internal/pretty | Package pretty defines helper functions to pretty-print structs for logging. |
internal/profiling | Package profiling contains two logical components: buffer.go and profiling.go. |
internal/profiling/buffer | Package buffer provides a high-performant lock free implementation of a circular buffer used by the profiling code. |
internal/proto | |
internal/proto/grpc_lookup_v1 | |
internal/resolver | Package resolver provides internal resolver-related functionality. |
internal/resolver/dns | Package dns implements a dns resolver to be installed as the default resolver in grpc. |
internal/resolver/passthrough | Package passthrough implements a pass-through resolver. |
internal/resolver/unix | Package unix implements a resolver for unix targets. |
internal/serviceconfig | Package serviceconfig contains utility functions to parse service config. |
internal/status | Package status implements errors returned by gRPC. |
internal/stubserver | Package stubserver is a stubbable implementation of google.golang.org/grpc/test/grpc_testing for testing purposes. |
internal/syscall | Package syscall provides functionalities that grpc uses to get low-level operating system stats/info. |
internal/testutils | Package testutils contains testing helpers. |
internal/testutils/fakegrpclb | Package fakegrpclb provides a fake implementation of the grpclb server. |
internal/testutils/rls | Package rls contains utilities for RouteLookupService e2e tests. |
internal/testutils/roundrobin | Package roundrobin contains helper functions to check for roundrobin and weighted-roundrobin load balancing of RPCs in tests. |
internal/testutils/xds | |
internal/testutils/xds/e2e | Package e2e provides utilities for end2end testing of xDS functionality. |
internal/transport | Package transport defines and implements message oriented communication channel to complete various transactions (e.g., an RPC). |
internal/transport/networktype | Package networktype declares the network type to be used in the default dialer. |
internal/wrr | Package wrr contains the interface and common implementations of wrr algorithms. |
internal/xds | Package xds contains types that need to be shared between code under google.golang.org/grpc/xds/... |
internal/xds/matcher | Package matcher contains types that need to be shared between code under google.golang.org/grpc/xds/... |
internal/xds/rbac | Package rbac provides service-level and method-level access control for a service. |
- Version
- v1.50.1
- Published
- Oct 14, 2022
- Platform
- darwin/amd64
- Imports
- 6 packages
- Last checked
- 1 hour ago –
Tools for package owners.