# Kubernetes

> Kubernetes (K8s) is an open source system for automating deployment, scaling, and management of containerized applications. The Kubernetes API is the resource-based (RESTful) HTTP interface exposed by the control-plane API server; users, cluster components, and external clients all read and mutate cluster state through it using the standard HTTP verbs. It is a CNCF graduated project.

This llms.txt is generated by API Evangelist from the apis.yml catalog and the artifacts harvested into the api-evangelist/kubernetes repository. The API server is addressed in-cluster at https://kubernetes.default.svc; there is no single public base URL.

## APIs

- [Kubernetes API](https://kubernetes.io/docs/concepts/overview/kubernetes-api/): Query and manipulate the state of Kubernetes objects (Pods, Deployments, Services, Namespaces, Nodes, ConfigMaps, Secrets, RBAC, autoscaling, events) via the control-plane API server.

## Specs

- [OpenAPI 3.1 (curated)](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/openapi/kubernetes-api-openapi.yml): Representative OpenAPI for core resource operations.
- [OpenAPI (upstream swagger.json)](https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/openapi-spec/swagger.json): Full generated API surface.
- [AsyncAPI (watch)](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/asyncapi/kubernetes-watch-asyncapi.yml): The API server watch/streaming event channels.
- [JSON Schema (resources)](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/json-schema/kubernetes-resource-schema.json)

## Docs

- [API Reference](https://kubernetes.io/docs/reference/kubernetes-api/): Every resource type and operation.
- [API Concepts](https://kubernetes.io/docs/reference/using-api/api-concepts/): Resource model, watch semantics, server-side apply, dry-run, field/label selectors.
- [Access, Authn & Authz](https://kubernetes.io/docs/reference/access-authn-authz/): Authentication (bearer tokens, client certs, OIDC), RBAC authorization, admission control.
- [Client Libraries](https://kubernetes.io/docs/reference/using-api/client-libraries/): Officially-supported Go, Python, JavaScript, Java, dotnet, Ruby, Haskell, Perl, and C clients.
- [Deprecation Policy](https://kubernetes.io/docs/reference/using-api/deprecation-policy/) and [Deprecation Guide](https://kubernetes.io/docs/reference/using-api/deprecation-guide/): API versioning and removal rules.

## Artifacts (API Evangelist)

- [Packages / SDKs](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/packages/kubernetes-packages.yml)
- [Authentication profile](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/authentication/kubernetes-authentication.yml)
- [Conventions](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/conventions/kubernetes-conventions.yml)
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/errors/kubernetes-problem-types.yml)
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/lifecycle/kubernetes-lifecycle.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/data-model/kubernetes-data-model.yml)
- [CLI (kubectl)](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/cli/kubernetes-cli.yml)
- [Changelog](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/changelog/kubernetes-changelog.yml)
- [Conformance](https://raw.githubusercontent.com/api-evangelist/kubernetes/refs/heads/main/conformance/kubernetes-conformance.yml)