Skip to content
apiserver-builder-alpha implements libraries and tools to quickly and easily build Kubernetes apiservers/controllers to support custom resource types based on APIServer Aggregation
Go Python Other
Branch: master
Clone or download
k8s-ci-robot Merge pull request #422 from yue9944882/feat/protobuf-support
Feat: Support protobuf code-generation/serialization
Latest commit 40f4649 Sep 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd [vendor] add gonum to apiserver-boot dependency as is required by pro… Sep 17, 2019
docs adding documentation for protobuf serialization Sep 17, 2019
example Merge pull request #415 from yue9944882/chore/remove-generated-files-… Sep 4, 2019
pkg apply etcd storage options Sep 17, 2019
scripts Enable travis CI Jun 16, 2017
test revise travis path Aug 23, 2019
vendor [vendor] do not strip gogo protobuf codes Sep 11, 2019
.gitignore ignore dbs Aug 26, 2019
.travis.yml
BUILD.bazel moving from github.com/kubernetes-incubator to sigs.k8s.io Aug 19, 2019
CONTRIBUTING.md Add CONTRIBUTING.md Sep 1, 2018
Gopkg.lock [vendor] do not strip gogo protobuf codes Sep 11, 2019
Gopkg.toml [vendor] do not strip gogo protobuf codes Sep 11, 2019
LICENSE Initial commit Apr 27, 2017
Makefile moving from github.com/kubernetes-incubator to sigs.k8s.io Aug 19, 2019
OWNERS bump version to v1.12.alpha.3: May 28, 2019
README.md add examples to README headlines Aug 27, 2019
SECURITY_CONTACTS bump version to v1.12.alpha.3: May 28, 2019
VERSION cut 1.15 release Aug 28, 2019
WORKSPACE Add gazelle to BUILD.bazel Oct 26, 2017
code-of-conduct.md Add code-of-conduct.md Dec 20, 2017

README.md

apiserver-builder-alpha

Build Status Go Report Card

Unless you absolutely need apiserver-aggregation, you are recommended to use Kubebuilder instead of apiserver-builder for building Kubernetes APIs. Kubebuilder builds APIs using CRDs and addresses limitations and feedback from apiserver-builder.

Apiserver Builder is a collection of libraries and tools to build native Kubernetes extensions using Kubernetes apiserver aggregation. Aggregated apiserver empowers you to customize your apiserver to do following things cannot achieved by CR[D]:

  • Makes your apiserver adopt different storage APIs rather than ETCDv3
  • Extends long-running subresources/endpoints like websocket for your own resources
  • Integrates your apiserver with whatever other external systems

Motivation

Addon apiservers are a Kubernetes extension point allowing fully featured Kubernetes APIs to be developed on the same api-machinery used to build the core Kubernetes APIS, but with the flexibility of being distributed and installed separately from the Kubernetes project. This allows APIs to be developed outside of the Kubernetes repo and installed separately as a package.

Building addon apiservers directly on the raw api-machinery libraries requires non-trivial code that must be maintained and rebased as the raw libraries change. The goal of this project is to make building apiservers in Go simple and accessible to everyone in the Kubernetes community.

apiserver-builder provides libraries, code generators, and tooling to make it possible to build and run a basic apiserver in an afternoon, while providing all of the hooks to offer the same capabilities when building from scratch.

Highlights

  • Tools to bootstrap type definitions, controllers (powered by controller-runtime framework), tests and documentation for new resources
  • Tools to build and run the extension control plane standalone and in minikube and remote clusters.
  • Easily watch and update Kubernetes API types from your controller
  • Easily add new resources and subresources
  • Provides sane defaults for most values, but can be overridden

Examples

  • BasicExample: Various simple resource examples.
  • KineExample: Plumbs aggregated apiserver over SQL-storages including sqlite, mysql, etc..
  • PodLogsExample: Serves pod/logs in aggregation layer to offload kube-apiserver connections.
  • PodExecExample: Serves pod/exec in aggregation layer to offload kube-apiserver connections.

Guides

Note: The guides are presented roughly in the order of recommended progression.

Installation guide

Download the latest release and install on your PATH.

installation guide

Building APIs concept guide

Conceptual information on how APIs and the Kubernetes control plane is structure and how to build new API extensions using apiserver-builder.

If you want to get straight to building something without knowing all the details of what is going on, skip ahead to the tools guide and come back to this later.

api building concept guide

Tools user guide

Instructions on how to use the tools packaged with apiserver-builder to build and run a new apiserver.

tools guide

Step by step example

List of commits showing apiserver-boot commands run and the corresponding changes:

https://sigs.k8s.io/apiserver-builder-alpha/commits/example-simple

Coding and libraries user guide

Instructions for how to implement custom APIs on top of the apiserver-builder libraries.

libraries guide

Concept guides

Conceptual information on addon apiservers, such as how auth works and how they interact with the main Kubernetes API server and API aggregator.

Concepts

Additional material

Using delegated auth with minikube

Instructions on how to run an apiserver using delegated auth with a minikube cluster

Details here

Community, discussion, contribution, and support

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this project at:

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.

You can’t perform that action at this time.