LogDog: Add prefix registration endpoint.

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

Index: common/api/logdog_coordinator/registration/v1/service.pb.go
diff --git a/common/api/logdog_coordinator/registration/v1/service.pb.go b/common/api/logdog_coordinator/registration/v1/service.pb.go
new file mode 100644
index 0000000000000000000000000000000000000000..b76d82936379bb1807f3ba188e4e329a3c8bd55b
--- /dev/null
+++ b/common/api/logdog_coordinator/registration/v1/service.pb.go
@@ -0,0 +1,223 @@
+// 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,
+}