Kubernetes API

As explained in Platform Engineering on Kubernetes

The Kubernetes API is the programmatic interface through which Kubernetes resources and cluster behavior are defined and managed.

The Kubernetes API provides the building blocks for composing platforms on top of Kubernetes. It supports declarative workflows and connects platform capabilities with developer delivery needs. section 1.0 section 1.2

Kubernetes is better understood as a meta-platform than as a complete platform: its APIs, CLI, dashboard, and ecosystem support domain-specific platforms for delivery, provisioning, monitoring, and developer experience. section 1.2

Platform teams use Kubernetes APIs to:

• Compose higher-level tools from Kubernetes building blocks. section 1.2
• Provide cloud-agnostic workflows for packaging, deploying, running, and monitoring workloads. section 1.2
• Extend Kubernetes for continuous integration, continuous delivery, cloud-resource provisioning, monitoring, observability, and developer experience. section 1.2
• Expose platform capabilities through Kubernetes conventions such as declarative behavior, versioning, and the resource model. section 6.2

A platform API built with Kubernetes conventions

A platform team can run platform-wide tools in a separate management cluster and host its platform API there, leaving workload clusters focused on applications. Reusing or extending the Kubernetes API gives the platform declarative behavior, versioning, the resource model, and compatibility with CNCF tools. Teams may also add an organization-specific API when company standards or non-Kubernetes users require a different interface. section 6.2

Figure 1.10 Kubernetes offer us a CLI, SDKs and dashboards, is it a platform?

Use the figure to distinguish Kubernetes APIs, CLI, SDKs, and dashboards from the broader platform capabilities built on top of them. section 1.2

How Platform Engineering on Kubernetes covers it

How deep it goes

Explains the API’s platform role, conventions, and architectural tradeoffs, but does not provide implementation code or endpoint details.

Examples

Uses platform clusters, workload clusters, management tools, and organization-specific APIs as architectural examples.

What it assumes

Assumes familiarity with Kubernetes, containers, and cloud-native applications while focusing on developer workflows and platform challenges.

What you can do after

Apply it to design platform APIs that reuse Kubernetes conventions or deliberately complement them with company-specific interfaces.

How it connects

Connects Kubernetes APIs with declarative systems, resource models, versioning, kubectl, dashboards, CNCF tools, and platform engineering.

liveBookmanning.com

Read Platform Engineering on Kubernetes on liveBook Get the book at manning.com

Also explained in

• 

  liveBookmanning.com
  Kubernetes in Action, Second EditionThe Kubernetes API is the programmatic interface through which clients and applications query and modify Kubernetes resources and cluster state.
• 

  liveBookmanning.com
  Acing the Certified Kubernetes Administrator Exam, Second EditionThe Kubernetes API is the interface through which Kubernetes resources and cluster operations are represented and accessed.
• 

  liveBookmanning.com
  Learn Docker in a Month of Lunches, Second EditionThe Kubernetes API is the standardized interface for declaring, querying, and managing Kubernetes resources and application models.
• 

  liveBookmanning.com
  Effective Platform EngineeringThe Kubernetes API is the interface through which clients and components manage Kubernetes resources and cluster state.
• 

  liveBookmanning.com
  Cloud Observability in ActionThe Kubernetes API is the programmatic interface for querying and changing the state of Kubernetes resources.

Compare how 6 books explain Kubernetes API →

Related concepts

• kubectlused by · kubectl is the Kubernetes command-line client for communicating with the Kubernetes API and managing cluster resources.
• Kubernetespart of · Kubernetes is an open-source platform for orchestrating and automating the deployment, scaling, and management of containerized workloads across computing clusters.
• Kubernetes manifestused by · A Kubernetes manifest is a declarative configuration document, typically written in YAML or JSON, that specifies Kubernetes resources and their desired state.
• cloud computingused by · Cloud computing is the on-demand delivery of computing resources and services over a network from remotely managed infrastructure.
• Helmused by · Helm is a Kubernetes package manager and templating tool that defines, packages, installs, upgrades, and manages applications through charts.
• custom objecthas part · A Kubernetes custom object is an API object whose resource type and schema are defined by a custom resource definition or another extension mechanism.

This explainer was generated by Manning's knowledge graph from the text of Platform Engineering on Kubernetes. The section links point to the parts of the book it draws on.