* Changes required make a build after update of component-base (#3004) * Update packages required for bump to component-base * Update version of controller-gen required by packages update Migrate to kube_codegen.sh * Sync CRDs post generator update * Docker and go-toolchain update * Update tests to align with package changes A in SetFeatureGateDuringTest, that stopped returning a cleanup func - https://github.com/kubernetes/kubernetes/issues/123677 Required tests update to not use `It()` while it could be `By()` as using `It()` resulted in parallel access to the feature gates. * Change enforced by golangci-lint - fieldalignment * Regenerate client code with new generator * [CI] fix locust versions (#3100) Signed-off-by: Rueian <[email protected]> * [ci] remove the test for modin because its certificate is broken (#3135) Signed-off-by: Rueian <[email protected]> --------- Signed-off-by: Rueian <[email protected]> Co-authored-by: Rueian <[email protected]>
Protocol Buffer API Definitions
This directory contains API definitions written in Protocol Buffers. These definitions will be used for building services.
Prerequisites
To successfully run the generation commands, ensure the following tools are installed in your environment:
Run the following command to build the proto-generator image. This image will be used for generating APIs:
Note: You can actually skip this step, and a prebuilt image will be downloaded instead.
make build-image
Automatic Generation
Go Client and Swagger
make generate
Clients
We postpone the client generation until there is a need for external service communication.
API Reference Documentation
Use the tools bootprint-openapi and html-inline to generate API reference documentation from the Swagger files. For more information on the API and architecture, refer to the design document.
Third-Party Protos
Third-party proto dependencies are synchronized back to proto/third_party for easier development (IDE friendly). Ideally, the directory for searching imports should be specified instead.
protoc -I.
-I/go/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \
-I/go/src/github.com/grpc-ecosystem/grpc-gateway/ \
-I/go/src/github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger/options/ \
Sources: