Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

add beta comment for terminating pods and pod replacement policy

Kubernetes-commit: 7fe31be11fbe9b44af262d5f5cffb1e73648aa96

Git stats


Failed to load latest commit information.
Latest commit message
Commit time
February 22, 2019 09:43
October 18, 2023 11:36
October 31, 2023 10:13


Schema of the external API types that are served by the Kubernetes API server.


This library is the canonical location of the Kubernetes API definition. Most likely interaction with this repository is as a dependency of client-go.

It is published separately to avoid diamond dependency problems for users who depend on more than one of,,

Recommended Use

We recommend using the go types in this repo. You may serialize them directly to JSON.

If you want to store or interact with proto-formatted Kubernetes API objects, we recommend using the "official" serialization stack in Directly serializing these types to proto will not result in data that matches the wire format or is compatible with other kubernetes ecosystem tools. The reason is that the wire format includes a magic prefix and an envelope proto. Please see:

For the same reason, we do not recommend embedding these proto objects within your own proto definitions. It is better to store Kubernetes objects as byte arrays, in the wire format, which is self-describing. This permits you to use either JSON or binary (proto) wire formats without code changes. It will be difficult for you to operate on both Custom Resources and built-in types otherwise.


Branches track Kubernetes branches and are compatible with that repo.

Where does it come from?

api is synced from Code changes are made in that location, merged into and later synced here.

Things you should NOT do

  1. is synced to All changes must be made in the former. The latter is read-only.