clusterv3connect

Documentation

Index

• Constants
• func NewClusterDiscoveryServiceHandler(svc ClusterDiscoveryServiceHandler, opts ...connect_go.HandlerOption) (string, http.Handler)
• type ClusterDiscoveryServiceClient
  • func NewClusterDiscoveryServiceClient(httpClient connect_go.HTTPClient, baseURL string, ...) ClusterDiscoveryServiceClient
• type ClusterDiscoveryServiceHandler
• type UnimplementedClusterDiscoveryServiceHandler
  • func (UnimplementedClusterDiscoveryServiceHandler) DeltaClusters(context.Context, ...) error
  • func (UnimplementedClusterDiscoveryServiceHandler) FetchClusters(context.Context, *connect_go.Request[v3.DiscoveryRequest]) (*connect_go.Response[v3.DiscoveryResponse], error)
  • func (UnimplementedClusterDiscoveryServiceHandler) StreamClusters(context.Context, ...) error

Constants

const (
	// ClusterDiscoveryServiceStreamClustersProcedure is the fully-qualified name of the
	// ClusterDiscoveryService's StreamClusters RPC.
	ClusterDiscoveryServiceStreamClustersProcedure = "/envoy.service.cluster.v3.ClusterDiscoveryService/StreamClusters"
	// ClusterDiscoveryServiceDeltaClustersProcedure is the fully-qualified name of the
	// ClusterDiscoveryService's DeltaClusters RPC.
	ClusterDiscoveryServiceDeltaClustersProcedure = "/envoy.service.cluster.v3.ClusterDiscoveryService/DeltaClusters"
	// ClusterDiscoveryServiceFetchClustersProcedure is the fully-qualified name of the
	// ClusterDiscoveryService's FetchClusters RPC.
	ClusterDiscoveryServiceFetchClustersProcedure = "/envoy.service.cluster.v3.ClusterDiscoveryService/FetchClusters"
)

These constants are the fully-qualified names of the RPCs defined in this package. They're exposed at runtime as Spec.Procedure and as the final two segments of the HTTP route.

Note that these are different from the fully-qualified method names used by google.golang.org/protobuf/reflect/protoreflect. To convert from these constants to reflection-formatted method names, remove the leading slash and convert the remaining slash to a period.

const (
	// ClusterDiscoveryServiceName is the fully-qualified name of the ClusterDiscoveryService service.
	ClusterDiscoveryServiceName = "envoy.service.cluster.v3.ClusterDiscoveryService"
)

Functions

func NewClusterDiscoveryServiceHandler

func NewClusterDiscoveryServiceHandler(svc ClusterDiscoveryServiceHandler, opts ...connect_go.HandlerOption) (string, http.Handler)

NewClusterDiscoveryServiceHandler builds an HTTP handler from the service implementation. It returns the path on which to mount the handler and the handler itself.

By default, handlers support the Connect, gRPC, and gRPC-Web protocols with the binary Protobuf and JSON codecs. They also support gzip compression.

Types

type ClusterDiscoveryServiceClient

type ClusterDiscoveryServiceClient interface {
	StreamClusters(context.Context) *connect_go.BidiStreamForClient[v3.DiscoveryRequest, v3.DiscoveryResponse]
	DeltaClusters(context.Context) *connect_go.BidiStreamForClient[v3.DeltaDiscoveryRequest, v3.DeltaDiscoveryResponse]
	FetchClusters(context.Context, *connect_go.Request[v3.DiscoveryRequest]) (*connect_go.Response[v3.DiscoveryResponse], error)
}

ClusterDiscoveryServiceClient is a client for the envoy.service.cluster.v3.ClusterDiscoveryService service.

func NewClusterDiscoveryServiceClient

func NewClusterDiscoveryServiceClient(httpClient connect_go.HTTPClient, baseURL string, opts ...connect_go.ClientOption) ClusterDiscoveryServiceClient

NewClusterDiscoveryServiceClient constructs a client for the envoy.service.cluster.v3.ClusterDiscoveryService service. By default, it uses the Connect protocol with the binary Protobuf Codec, asks for gzipped responses, and sends uncompressed requests. To use the gRPC or gRPC-Web protocols, supply the connect.WithGRPC() or connect.WithGRPCWeb() options.

The URL supplied here should be the base URL for the Connect or gRPC server (for example, http://api.acme.com or https://acme.com/grpc).

type ClusterDiscoveryServiceHandler

type ClusterDiscoveryServiceHandler interface {
	StreamClusters(context.Context, *connect_go.BidiStream[v3.DiscoveryRequest, v3.DiscoveryResponse]) error
	DeltaClusters(context.Context, *connect_go.BidiStream[v3.DeltaDiscoveryRequest, v3.DeltaDiscoveryResponse]) error
	FetchClusters(context.Context, *connect_go.Request[v3.DiscoveryRequest]) (*connect_go.Response[v3.DiscoveryResponse], error)
}

ClusterDiscoveryServiceHandler is an implementation of the envoy.service.cluster.v3.ClusterDiscoveryService service.

type UnimplementedClusterDiscoveryServiceHandler

type UnimplementedClusterDiscoveryServiceHandler struct{}

UnimplementedClusterDiscoveryServiceHandler returns CodeUnimplemented from all methods.

func (UnimplementedClusterDiscoveryServiceHandler) DeltaClusters

func (UnimplementedClusterDiscoveryServiceHandler) DeltaClusters(context.Context, *connect_go.BidiStream[v3.DeltaDiscoveryRequest, v3.DeltaDiscoveryResponse]) error

func (UnimplementedClusterDiscoveryServiceHandler) FetchClusters

func (UnimplementedClusterDiscoveryServiceHandler) FetchClusters(context.Context, *connect_go.Request[v3.DiscoveryRequest]) (*connect_go.Response[v3.DiscoveryResponse], error)

func (UnimplementedClusterDiscoveryServiceHandler) StreamClusters

func (UnimplementedClusterDiscoveryServiceHandler) StreamClusters(context.Context, *connect_go.BidiStream[v3.DiscoveryRequest, v3.DiscoveryResponse]) error