LogDog: Add prefix registration endpoint.

common/api/logdog_coordinator/registration/v1/service.pb.go

+// Code generated by protoc-gen-go.
+// source: service.proto
+// DO NOT EDIT!
+
+/*
+Package logdog is a generated protocol buffer package.
+
+It is generated from these files:
+        service.proto
+
+It has these top-level messages:
+        RegisterPrefixRequest
+        RegisterPrefixResponse
+*/
+package logdog
+
+import prpccommon "github.com/luci/luci-go/common/prpc"
+import prpc "github.com/luci/luci-go/server/prpc"
+
+import proto "github.com/golang/protobuf/proto"
+import fmt "fmt"
+import math "math"
+import google_protobuf "github.com/luci/luci-go/common/proto/google"
+
+import (
+        context "golang.org/x/net/context"
+        grpc "google.golang.org/grpc"
+)
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ = proto.Marshal
+var _ = fmt.Errorf
+var _ = math.Inf
+
+// This is a compile-time assertion to ensure that this generated file
+// is compatible with the proto package it is being compiled against.
+const _ = proto.ProtoPackageIsVersion1
+
+// RegisterPrefixRequest registers a new Prefix with the Coordinator.
+type RegisterPrefixRequest struct {
+        // The log stream's project.
+        Project string `protobuf:"bytes,1,opt,name=project" json:"project,omitempty"`
+        // Optional information about the registering agent.
+        SourceInfo []string `protobuf:"bytes,2,rep,name=source_info,json=sourceInfo" json:"source_info,omitempty"`
+        // The protobuf version string for this stream.
+        ProtoVersion string `protobuf:"bytes,3,opt,name=proto_version,json=protoVersion" json:"proto_version,omitempty"`
+        // The serialized LogStreamDescriptor protobuf for this stream. The stream's
+        // path is extracted from this field.
+        Desc []byte `protobuf:"bytes,4,opt,name=desc,proto3" json:"desc,omitempty"`
+        // The prefix expiration time. If <= 0, the project's default prefix
+        // expiration period will be applied.
+        //
+        // The prefix will be closed by the Coordinator after its expiration period.
+        // Once closed, new stream registration requests will no longer be accepted.
+        //
+        // If supplied, this value should exceed the timeout of the local task, else
+        // some of the task's streams may be dropped due to failing registration.
+        Expiration *google_protobuf.Duration `protobuf:"bytes,5,opt,name=expiration" json:"expiration,omitempty"`
+}
+
+func (m *RegisterPrefixRequest) Reset()                    { *m = RegisterPrefixRequest{} }
+func (m *RegisterPrefixRequest) String() string            { return proto.CompactTextString(m) }
+func (*RegisterPrefixRequest) ProtoMessage()               {}
+func (*RegisterPrefixRequest) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{0} }
+
+func (m *RegisterPrefixRequest) GetExpiration() *google_protobuf.Duration {
+        if m != nil {
+                return m.Expiration
+        }
+        return nil
+}
+
+// The response message for the RegisterPrefix RPC.
+type RegisterPrefixResponse struct {
+        // Secret is the prefix's secret. This must be included verbatim in Butler
+        // bundles to assert ownership of this prefix.
+        Secret []byte `protobuf:"bytes,1,opt,name=secret,proto3" json:"secret,omitempty"`
+        // The name of the Pub/Sub topic to publish butlerproto-formatted Butler log
+        // bundles to.
+        LogBundleTopic string `protobuf:"bytes,2,opt,name=log_bundle_topic,json=logBundleTopic" json:"log_bundle_topic,omitempty"`
+}
+
+func (m *RegisterPrefixResponse) Reset()                    { *m = RegisterPrefixResponse{} }
+func (m *RegisterPrefixResponse) String() string            { return proto.CompactTextString(m) }
+func (*RegisterPrefixResponse) ProtoMessage()               {}
+func (*RegisterPrefixResponse) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{1} }
+
+func init() {
+        proto.RegisterType((*RegisterPrefixRequest)(nil), "logdog.RegisterPrefixRequest")
+        proto.RegisterType((*RegisterPrefixResponse)(nil), "logdog.RegisterPrefixResponse")
+}
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ context.Context
+var _ grpc.ClientConn
+
+// This is a compile-time assertion to ensure that this generated file
+// is compatible with the grpc package it is being compiled against.
+const _ = grpc.SupportPackageIsVersion2
+
+// Client API for Registration service
+
+type RegistrationClient interface {
+        // RegisterStream allows a Butler instance to register a log stream with the
+        // Coordinator. Upon success, the Coordinator will return registration
+        // information and streaming parameters to the Butler.
+        //
+        // This should be called by a Butler instance to gain the ability to publish
+        // to a prefix space. The caller must have WRITE access to its project's
+        // stream space. If WRITE access is not present, this will fail with the
+        // "PermissionDenied" gRPC code.
+        //
+        // A stream prefix may be registered at most once. Additional registration
+        // requests will fail with the "AlreadyExists" gRPC code.
+        RegisterPrefix(ctx context.Context, in *RegisterPrefixRequest, opts ...grpc.CallOption) (*RegisterPrefixResponse, error)
+}
+type registrationPRPCClient struct {
+        client *prpccommon.Client
+}
+
+func NewRegistrationPRPCClient(client *prpccommon.Client) RegistrationClient {
+        return &registrationPRPCClient{client}
+}
+
+func (c *registrationPRPCClient) RegisterPrefix(ctx context.Context, in *RegisterPrefixRequest, opts ...grpc.CallOption) (*RegisterPrefixResponse, error) {
+        out := new(RegisterPrefixResponse)
+        err := c.client.Call(ctx, "logdog.Registration", "RegisterPrefix", in, out, opts...)
+        if err != nil {
+                return nil, err
+        }
+        return out, nil
+}
+
+type registrationClient struct {
+        cc *grpc.ClientConn
+}
+
+func NewRegistrationClient(cc *grpc.ClientConn) RegistrationClient {
+        return &registrationClient{cc}
+}
+
+func (c *registrationClient) RegisterPrefix(ctx context.Context, in *RegisterPrefixRequest, opts ...grpc.CallOption) (*RegisterPrefixResponse, error) {
+        out := new(RegisterPrefixResponse)
+        err := grpc.Invoke(ctx, "/logdog.Registration/RegisterPrefix", in, out, c.cc, opts...)
+        if err != nil {
+                return nil, err
+        }
+        return out, nil
+}
+
+// Server API for Registration service
+
+type RegistrationServer interface {
+        // RegisterStream allows a Butler instance to register a log stream with the
+        // Coordinator. Upon success, the Coordinator will return registration
+        // information and streaming parameters to the Butler.
+        //
+        // This should be called by a Butler instance to gain the ability to publish
+        // to a prefix space. The caller must have WRITE access to its project's
+        // stream space. If WRITE access is not present, this will fail with the
+        // "PermissionDenied" gRPC code.
+        //
+        // A stream prefix may be registered at most once. Additional registration
+        // requests will fail with the "AlreadyExists" gRPC code.
+        RegisterPrefix(context.Context, *RegisterPrefixRequest) (*RegisterPrefixResponse, error)
+}
+
+func RegisterRegistrationServer(s prpc.Registrar, srv RegistrationServer) {
+        s.RegisterService(&_Registration_serviceDesc, srv)
+}
+
+func _Registration_RegisterPrefix_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+        in := new(RegisterPrefixRequest)
+        if err := dec(in); err != nil {
+                return nil, err
+        }
+        if interceptor == nil {
+                return srv.(RegistrationServer).RegisterPrefix(ctx, in)
+        }
+        info := &grpc.UnaryServerInfo{
+                Server:     srv,
+                FullMethod: "/logdog.Registration/RegisterPrefix",
+        }
+        handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+                return srv.(RegistrationServer).RegisterPrefix(ctx, req.(*RegisterPrefixRequest))
+        }
+        return interceptor(ctx, in, info, handler)
+}
+
+var _Registration_serviceDesc = grpc.ServiceDesc{
+        ServiceName: "logdog.Registration",
+        HandlerType: (*RegistrationServer)(nil),
+        Methods: []grpc.MethodDesc{
+                {
+                        MethodName: "RegisterPrefix",
+                        Handler:    _Registration_RegisterPrefix_Handler,
+                },
+        },
+        Streams: []grpc.StreamDesc{},
+}
+
+var fileDescriptor0 = []byte{
+        // 290 bytes of a gzipped FileDescriptorProto
+        0x1f, 0x8b, 0x08, 0x00, 0x00, 0x09, 0x6e, 0x88, 0x02, 0xff, 0x74, 0x90, 0xc1, 0x4a, 0x03, 0x31,
+        0x10, 0x86, 0xa9, 0xad, 0x2b, 0x4e, 0xb7, 0x45, 0x02, 0x96, 0x58, 0xb0, 0x96, 0x7a, 0xe9, 0x29,
+        0x85, 0x7a, 0xf2, 0x2a, 0x5e, 0x3c, 0x29, 0x41, 0x3c, 0x78, 0x59, 0xdc, 0xec, 0xec, 0x12, 0x59,
+        0x76, 0xd6, 0x24, 0x5b, 0xfa, 0x84, 0x3e, 0x97, 0x69, 0xd2, 0x82, 0x8a, 0xde, 0x92, 0xef, 0x1f,
+        0x66, 0xe6, 0x1b, 0x18, 0x59, 0x34, 0x1b, 0xad, 0x50, 0xb4, 0x86, 0x1c, 0xb1, 0xa4, 0xa6, 0xaa,
+        0xa0, 0x6a, 0x3a, 0xab, 0x88, 0xaa, 0x1a, 0x57, 0x81, 0xe6, 0x5d, 0xb9, 0x2a, 0x3a, 0xf3, 0xe6,
+        0x34, 0x35, 0xb1, 0x6e, 0xf1, 0xd9, 0x83, 0x73, 0x89, 0x95, 0xb6, 0x0e, 0xcd, 0x93, 0xc1, 0x52,
+        0x6f, 0x25, 0x7e, 0x74, 0x68, 0x1d, 0xe3, 0x70, 0xe2, 0x4b, 0xde, 0x51, 0x39, 0xde, 0x9b, 0xf7,
+        0x96, 0xa7, 0xf2, 0xf0, 0x65, 0x57, 0x30, 0xb4, 0xd4, 0x19, 0x85, 0x99, 0x6e, 0x4a, 0xe2, 0x47,
+        0xf3, 0xbe, 0x4f, 0x21, 0xa2, 0x07, 0x4f, 0xd8, 0x35, 0x8c, 0x42, 0xf7, 0x6c, 0x83, 0xc6, 0xfa,
+        0x59, 0xbc, 0x1f, 0x1a, 0xa4, 0x01, 0xbe, 0x44, 0xc6, 0x18, 0x0c, 0x0a, 0xb4, 0x8a, 0x0f, 0x7c,
+        0x96, 0xca, 0xf0, 0x66, 0xb7, 0x00, 0xb8, 0x6d, 0x75, 0xdc, 0x90, 0x1f, 0xfb, 0x64, 0xb8, 0xbe,
+        0x10, 0x51, 0x41, 0x1c, 0x14, 0xc4, 0xfd, 0x5e, 0x41, 0x7e, 0x2b, 0x5e, 0xbc, 0xc2, 0xe4, 0xb7,
+        0x87, 0x6d, 0xa9, 0xb1, 0xc8, 0x26, 0x90, 0x58, 0x54, 0x06, 0xa3, 0x47, 0x2a, 0xf7, 0x3f, 0xb6,
+        0x84, 0x33, 0x7f, 0xa4, 0x2c, 0xef, 0x9a, 0xa2, 0xc6, 0xcc, 0x51, 0xab, 0x95, 0x77, 0xd9, 0x2d,
+        0x3a, 0xf6, 0xfc, 0x2e, 0xe0, 0xe7, 0x1d, 0x5d, 0x67, 0x90, 0xc6, 0xde, 0x71, 0x16, 0x7b, 0x84,
+        0xf1, 0xcf, 0x59, 0xec, 0x52, 0xc4, 0x7b, 0x8b, 0x3f, 0x6f, 0x39, 0x9d, 0xfd, 0x17, 0xc7, 0x15,
+        0xf3, 0x24, 0xb8, 0xdd, 0x7c, 0x05, 0x00, 0x00, 0xff, 0xff, 0xda, 0x7f, 0x26, 0x0d, 0xc5, 0x01,
+        0x00, 0x00,
+}