mirror of
https://github.com/seaweedfs/seaweedfs.git
synced 2026-09-13 01:50:40 +02:00
proto: define MountRegister/MountList and MountPeer service Adds the wire types for peer chunk sharing between weed mount clients: * filer.proto: MountRegister / MountList RPCs so each mount can heartbeat its peer-serve address into a filer-hosted registry, and refresh the list of peers. Tiny payload; the filer stores only O(fleet_size) state. * mount_peer.proto (new): ChunkAnnounce / ChunkLookup RPCs for the mount-to-mount chunk directory. Each fid's directory entry lives on an HRW-assigned mount; announces and lookups route to that mount. No behavior yet — later PRs wire the RPCs into the filer and mount. See design-weed-mount-peer-chunk-sharing.md for the full design.
230 lines
9.7 KiB
Go
230 lines
9.7 KiB
Go
// Code generated by protoc-gen-go-grpc. DO NOT EDIT.
|
|
// versions:
|
|
// - protoc-gen-go-grpc v1.5.1
|
|
// - protoc v6.33.4
|
|
// source: mount_peer.proto
|
|
|
|
package mount_peer_pb
|
|
|
|
import (
|
|
context "context"
|
|
grpc "google.golang.org/grpc"
|
|
codes "google.golang.org/grpc/codes"
|
|
status "google.golang.org/grpc/status"
|
|
)
|
|
|
|
// This is a compile-time assertion to ensure that this generated file
|
|
// is compatible with the grpc package it is being compiled against.
|
|
// Requires gRPC-Go v1.64.0 or later.
|
|
const _ = grpc.SupportPackageIsVersion9
|
|
|
|
const (
|
|
MountPeer_ChunkAnnounce_FullMethodName = "/mount_peer_pb.MountPeer/ChunkAnnounce"
|
|
MountPeer_ChunkLookup_FullMethodName = "/mount_peer_pb.MountPeer/ChunkLookup"
|
|
MountPeer_FetchChunk_FullMethodName = "/mount_peer_pb.MountPeer/FetchChunk"
|
|
)
|
|
|
|
// MountPeerClient is the client API for MountPeer service.
|
|
//
|
|
// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.
|
|
type MountPeerClient interface {
|
|
// ChunkAnnounce: the caller asserts it currently holds the listed fids in
|
|
// its local chunk cache and is willing to serve them to peers. The
|
|
// receiver accepts only fids for which it is the HRW-assigned owner on
|
|
// its current seed view; others are returned in rejected_file_ids.
|
|
ChunkAnnounce(ctx context.Context, in *ChunkAnnounceRequest, opts ...grpc.CallOption) (*ChunkAnnounceResponse, error)
|
|
// ChunkLookup: asks the receiver for known holders of each requested fid.
|
|
// The receiver responds only for fids it owns; others are listed in
|
|
// not_owner_file_ids so the caller can retry against the correct owner
|
|
// after refreshing its own seed view.
|
|
ChunkLookup(ctx context.Context, in *ChunkLookupRequest, opts ...grpc.CallOption) (*ChunkLookupResponse, error)
|
|
// FetchChunk: server-streams the bytes of a cached chunk to a peer.
|
|
// Streaming avoids the default gRPC 4 MiB message cap for typical
|
|
// 16 MiB chunks and lets the receiver assemble into a preallocated
|
|
// buffer. Not-cached / cache-miss returns a gRPC NOT_FOUND status.
|
|
// The fetcher re-verifies MD5 against expected_etag end-to-end after
|
|
// the stream completes.
|
|
FetchChunk(ctx context.Context, in *FetchChunkRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[FetchChunkResponse], error)
|
|
}
|
|
|
|
type mountPeerClient struct {
|
|
cc grpc.ClientConnInterface
|
|
}
|
|
|
|
func NewMountPeerClient(cc grpc.ClientConnInterface) MountPeerClient {
|
|
return &mountPeerClient{cc}
|
|
}
|
|
|
|
func (c *mountPeerClient) ChunkAnnounce(ctx context.Context, in *ChunkAnnounceRequest, opts ...grpc.CallOption) (*ChunkAnnounceResponse, error) {
|
|
cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
|
|
out := new(ChunkAnnounceResponse)
|
|
err := c.cc.Invoke(ctx, MountPeer_ChunkAnnounce_FullMethodName, in, out, cOpts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return out, nil
|
|
}
|
|
|
|
func (c *mountPeerClient) ChunkLookup(ctx context.Context, in *ChunkLookupRequest, opts ...grpc.CallOption) (*ChunkLookupResponse, error) {
|
|
cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
|
|
out := new(ChunkLookupResponse)
|
|
err := c.cc.Invoke(ctx, MountPeer_ChunkLookup_FullMethodName, in, out, cOpts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return out, nil
|
|
}
|
|
|
|
func (c *mountPeerClient) FetchChunk(ctx context.Context, in *FetchChunkRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[FetchChunkResponse], error) {
|
|
cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
|
|
stream, err := c.cc.NewStream(ctx, &MountPeer_ServiceDesc.Streams[0], MountPeer_FetchChunk_FullMethodName, cOpts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
x := &grpc.GenericClientStream[FetchChunkRequest, FetchChunkResponse]{ClientStream: stream}
|
|
if err := x.ClientStream.SendMsg(in); err != nil {
|
|
return nil, err
|
|
}
|
|
if err := x.ClientStream.CloseSend(); err != nil {
|
|
return nil, err
|
|
}
|
|
return x, nil
|
|
}
|
|
|
|
// This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
|
|
type MountPeer_FetchChunkClient = grpc.ServerStreamingClient[FetchChunkResponse]
|
|
|
|
// MountPeerServer is the server API for MountPeer service.
|
|
// All implementations must embed UnimplementedMountPeerServer
|
|
// for forward compatibility.
|
|
type MountPeerServer interface {
|
|
// ChunkAnnounce: the caller asserts it currently holds the listed fids in
|
|
// its local chunk cache and is willing to serve them to peers. The
|
|
// receiver accepts only fids for which it is the HRW-assigned owner on
|
|
// its current seed view; others are returned in rejected_file_ids.
|
|
ChunkAnnounce(context.Context, *ChunkAnnounceRequest) (*ChunkAnnounceResponse, error)
|
|
// ChunkLookup: asks the receiver for known holders of each requested fid.
|
|
// The receiver responds only for fids it owns; others are listed in
|
|
// not_owner_file_ids so the caller can retry against the correct owner
|
|
// after refreshing its own seed view.
|
|
ChunkLookup(context.Context, *ChunkLookupRequest) (*ChunkLookupResponse, error)
|
|
// FetchChunk: server-streams the bytes of a cached chunk to a peer.
|
|
// Streaming avoids the default gRPC 4 MiB message cap for typical
|
|
// 16 MiB chunks and lets the receiver assemble into a preallocated
|
|
// buffer. Not-cached / cache-miss returns a gRPC NOT_FOUND status.
|
|
// The fetcher re-verifies MD5 against expected_etag end-to-end after
|
|
// the stream completes.
|
|
FetchChunk(*FetchChunkRequest, grpc.ServerStreamingServer[FetchChunkResponse]) error
|
|
mustEmbedUnimplementedMountPeerServer()
|
|
}
|
|
|
|
// UnimplementedMountPeerServer must be embedded to have
|
|
// forward compatible implementations.
|
|
//
|
|
// NOTE: this should be embedded by value instead of pointer to avoid a nil
|
|
// pointer dereference when methods are called.
|
|
type UnimplementedMountPeerServer struct{}
|
|
|
|
func (UnimplementedMountPeerServer) ChunkAnnounce(context.Context, *ChunkAnnounceRequest) (*ChunkAnnounceResponse, error) {
|
|
return nil, status.Errorf(codes.Unimplemented, "method ChunkAnnounce not implemented")
|
|
}
|
|
func (UnimplementedMountPeerServer) ChunkLookup(context.Context, *ChunkLookupRequest) (*ChunkLookupResponse, error) {
|
|
return nil, status.Errorf(codes.Unimplemented, "method ChunkLookup not implemented")
|
|
}
|
|
func (UnimplementedMountPeerServer) FetchChunk(*FetchChunkRequest, grpc.ServerStreamingServer[FetchChunkResponse]) error {
|
|
return status.Errorf(codes.Unimplemented, "method FetchChunk not implemented")
|
|
}
|
|
func (UnimplementedMountPeerServer) mustEmbedUnimplementedMountPeerServer() {}
|
|
func (UnimplementedMountPeerServer) testEmbeddedByValue() {}
|
|
|
|
// UnsafeMountPeerServer may be embedded to opt out of forward compatibility for this service.
|
|
// Use of this interface is not recommended, as added methods to MountPeerServer will
|
|
// result in compilation errors.
|
|
type UnsafeMountPeerServer interface {
|
|
mustEmbedUnimplementedMountPeerServer()
|
|
}
|
|
|
|
func RegisterMountPeerServer(s grpc.ServiceRegistrar, srv MountPeerServer) {
|
|
// If the following call pancis, it indicates UnimplementedMountPeerServer was
|
|
// embedded by pointer and is nil. This will cause panics if an
|
|
// unimplemented method is ever invoked, so we test this at initialization
|
|
// time to prevent it from happening at runtime later due to I/O.
|
|
if t, ok := srv.(interface{ testEmbeddedByValue() }); ok {
|
|
t.testEmbeddedByValue()
|
|
}
|
|
s.RegisterService(&MountPeer_ServiceDesc, srv)
|
|
}
|
|
|
|
func _MountPeer_ChunkAnnounce_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
|
|
in := new(ChunkAnnounceRequest)
|
|
if err := dec(in); err != nil {
|
|
return nil, err
|
|
}
|
|
if interceptor == nil {
|
|
return srv.(MountPeerServer).ChunkAnnounce(ctx, in)
|
|
}
|
|
info := &grpc.UnaryServerInfo{
|
|
Server: srv,
|
|
FullMethod: MountPeer_ChunkAnnounce_FullMethodName,
|
|
}
|
|
handler := func(ctx context.Context, req interface{}) (interface{}, error) {
|
|
return srv.(MountPeerServer).ChunkAnnounce(ctx, req.(*ChunkAnnounceRequest))
|
|
}
|
|
return interceptor(ctx, in, info, handler)
|
|
}
|
|
|
|
func _MountPeer_ChunkLookup_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
|
|
in := new(ChunkLookupRequest)
|
|
if err := dec(in); err != nil {
|
|
return nil, err
|
|
}
|
|
if interceptor == nil {
|
|
return srv.(MountPeerServer).ChunkLookup(ctx, in)
|
|
}
|
|
info := &grpc.UnaryServerInfo{
|
|
Server: srv,
|
|
FullMethod: MountPeer_ChunkLookup_FullMethodName,
|
|
}
|
|
handler := func(ctx context.Context, req interface{}) (interface{}, error) {
|
|
return srv.(MountPeerServer).ChunkLookup(ctx, req.(*ChunkLookupRequest))
|
|
}
|
|
return interceptor(ctx, in, info, handler)
|
|
}
|
|
|
|
func _MountPeer_FetchChunk_Handler(srv interface{}, stream grpc.ServerStream) error {
|
|
m := new(FetchChunkRequest)
|
|
if err := stream.RecvMsg(m); err != nil {
|
|
return err
|
|
}
|
|
return srv.(MountPeerServer).FetchChunk(m, &grpc.GenericServerStream[FetchChunkRequest, FetchChunkResponse]{ServerStream: stream})
|
|
}
|
|
|
|
// This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
|
|
type MountPeer_FetchChunkServer = grpc.ServerStreamingServer[FetchChunkResponse]
|
|
|
|
// MountPeer_ServiceDesc is the grpc.ServiceDesc for MountPeer service.
|
|
// It's only intended for direct use with grpc.RegisterService,
|
|
// and not to be introspected or modified (even as a copy)
|
|
var MountPeer_ServiceDesc = grpc.ServiceDesc{
|
|
ServiceName: "mount_peer_pb.MountPeer",
|
|
HandlerType: (*MountPeerServer)(nil),
|
|
Methods: []grpc.MethodDesc{
|
|
{
|
|
MethodName: "ChunkAnnounce",
|
|
Handler: _MountPeer_ChunkAnnounce_Handler,
|
|
},
|
|
{
|
|
MethodName: "ChunkLookup",
|
|
Handler: _MountPeer_ChunkLookup_Handler,
|
|
},
|
|
},
|
|
Streams: []grpc.StreamDesc{
|
|
{
|
|
StreamName: "FetchChunk",
|
|
Handler: _MountPeer_FetchChunk_Handler,
|
|
ServerStreams: true,
|
|
},
|
|
},
|
|
Metadata: "mount_peer.proto",
|
|
}
|