Add generated helix api client library

[alexperovich]

Needed for #118

This is the C# client library that allows access to the helix api. The telemetry sending tool will be using this library.

[chcosta]

I thought this was for a general telemetry client usable by .NET products to report status, is this a Helix specific thing? All of the references to Helix are throwing me off as to what this is going to be used for.

[alexperovich]

No, this is specifically for builds sending telemetry to helix so they can show up on MC.

[chcosta]

Maybe I don't have a clear picture of where Helix plays into the model. I thought the telemetry was going to MC and that this tool would be used by CI, official builds, etc... Where can I see the design so that I can understand why we need to call this a Helix thing?

[alexperovich]

Helix == MC

The telemetry tool sends telemetry to helix as if it was a job running on helix machines.

[chcosta]

I thought "Helix" was the controller thing responsible for acquiring machines and scheduling jobs on them.

[alexperovich]

"Helix" is also the telemetry system that collects data from those jobs and provides them for MC to display. This telemetry tool hooks into that processing by sending its own telemetry. Specifically by calling the Telemetry apis.

[alexperovich]

@tmat PTAL

[chcosta]

I see. "Helix" still feels a bit overloaded. The namespace in this repo has thus far been "Microsoft.DotNet.Build.blah". I wonder if we should be slightly more targeted here than what's currently in the PR and go with something like "Microsoft.DotNet.Build.HelixTelemetry.Client".

[alexperovich]

This client library will also be used by the other tasks brought in from build tools to send test jobs to helix. This isn't the "HelixTelemetry" client. Its the entire surface area of the helix api.

[chcosta]

That makes more sense then.

[chcosta]

I can't find this comment from @tmat in the PR

What are these files generated by? Can they be generated during build rather then checked in to the repo?

Was that addressed?

[alexperovich]

They are generated by https://github.com/Azure/autorest. The config for the generator is in src/Microsoft.DotNet.Helix/Client/generator. Adding generation of the code to the build isn't really feasible because the generator is a nodejs process.

[markwilkie]

@alexperovich - please file an issue for you to provide a clear story for what the mechanics should be to update. Assuming this issue, I'm fine w/ you merging.

[alexperovich]

Created #124