api

I sometimes joke that Kubernetes is a mass experiment in teaching people how to write Go via YAML. The giant nested YAML you come across is the input (pre-deserialization)/output (post-serialization) for the declared types: https://github.com/kubernetes/api/blob/master/core/v1/types.... Fortunately, or unfortunately, I am the only person that finds humor in this.

> Not sure where it really comes from, It's almost certainly from the golang struct https://github.com/kubernetes/api/blob/v0.32.0/apps/v1/types... or its more succinct generated.proto friend https://github.com/kubernetes/api/blob/v0.32.0/apps/v1/gener... and, as you pointed out, the .dev one appears to just be alphabetical. In their defense, I would guess for humans that are looking for "paused" it's much easier to scan down to the "mnop" area and then look for "paused" than, lol, guess where the paused was introduced in the timeline of a golang struct

On the last point ("Stringy Types") - k8s API types are actually defined as Protobufs[0] so they have strictly defined schemas. There are some types that are sum types (IntOrString) but generally no type depends on some other field's value afaik. Ofc that doesn't stop CRD developers from making everything a String type and then interpolating server-side (within their custom controller) based on phases of the moon and what not... [0] - e.g https://github.com/kubernetes/api/blob/master/core/v1/genera...

The schema is defined as a Protocol Buffer (https://developers.google.com/protocol-buffers/) package. This lets us construct values protobuf-based APIs without having to manually copy over the schema. For example, if you had this schema: package my.example.schema; message Person { string name = 1; int32 id = 2; string email = 3; } Then you could build a value using Skycfg like this: pb = proto.package("my.example.schema") msg = pb.Person( id = 1234, name = "Jane Doe", email = "jdoe@example.com", ) print(msg) For Kubernetes, we're using the schema at https://github.com/kubernetes/api and for Envoy we use https://github.com/envoyproxy/data-plane-api/tree/master/env...