milo: Add barebones BuildInfo pRPC service.

milo/api/proto/buildinfo.proto

+// Copyright 2017 The LUCI Authors. All rights reserved.
+// Use of this source code is governed under the Apache License, Version 2.0
+// that can be found in the LICENSE file.
+
+syntax = "proto3";
+
+package milo;
+
+import "github.com/luci/luci-go/common/proto/milo/annotations.proto";
+
+// The buildbot service definition.

[hinoka, 2017/02/02 22:46:23]

BuildInfo?  Also copypasta the description you sent out in your codreview email
message, I think that was helpful.

[dnj, 2017/02/03 01:53:26]

OK

+service BuildInfo {
+  rpc Get(BuildInfoRequest) returns (BuildInfoResponse);
+}
+
+message BuildInfoRequest {
+  // The request for the name of a BuildBot built.
+  message BuildBot {
+    // The master name.
+    string master_name = 1;
+    // The builder name server.
+    string builder_name = 2;
+    // The build number.
+    int64 build_number = 3;
+  }
+
+  // The request containing a Swarming task.
+  message Swarming {
+    // The Swarming task name.
+    string task = 1;

[hinoka, 2017/02/02 22:46:23]

string server = 1.  we have like 8 of them.

[dnj, 2017/02/03 01:53:26]

ATM I'm leaving server off until we have a whitelist of allowed servers (RE
vulnerability). I'll do that next, then add it as an = 2.

+  }
+
+  oneof build {
+    // Request a BuildBot build.
+    BuildBot buildbot = 1;
+    // Request a Swarming build.
+    Swarming swarming = 2;
+  }
+
+  // Project hint is a LUCI project suggestion for this build. Some builds,
+  // notably older ones, may not contain enough metadata to resolve their
+  // project. Resolution may succeed if this hint is provided and correct.
+  //
+  // This field is optional, and its use is discouraged unless necessary.
+  string project_hint = 11;

[hinoka, 2017/02/02 22:46:23]

Is this actively useful in V1? If not let's remove it until we need it.  It's
always easier to add fields than remove them.

[dnj, 2017/02/03 01:53:26]

Yes, it is. Older builds especially, which don't have that property, can use
this.

+}
+
+// The request containing the name of the master.
+message BuildInfoResponse {
+  // The LUCI project that this build belongs to.
+  string project = 1;
+
+  // The main build step.
+  milo.Step step = 2;
+
+  // The LogDog annotation stream for this build. The Prefix will be populated
+  // and can be used as the prefix for any un-prefixed LogdogStream in "step".
+  milo.LogdogStream annotation_stream = 3;
+}