API machinery
Recommended reading: kubernetes API convention doc and .
To generate the API code simply run to update the generated API machinery code (conversion functions). Note that make apimachinery
and (currently) only update the autogenerated code; it does not trigger a rebuild, hence the need for && make
.
Adding a field
- Add the field to pkg/apis/kops, and then also to each versioned copy: pkg/apis/kops/v1alpha2, pkg/apis/kops/v1alpha3, etc
- You likely want to update the validation logic
Currently, the apimachinery code we check in is relatively stable. However, when the generated code is large, it is often considered good manners to your code reviewer to split a PR into multiple commits: one with the actual changes, and then a second commit with the autogenerated code.