Search⌘ K
AI Features

Interacting With the Kubernetes API

Explore how the Kubernetes API functions as an aggregation of multiple APIs served by the control plane server. Learn to create a local Kubernetes cluster with KinD, manage namespace resources using kubectl, and understand the structure of Kubernetes resources including Group, Version, Kind, Name, and Namespace. Discover how authentication works with kubeconfig files to securely access clusters. This lesson equips you with foundational knowledge to interact with Kubernetes programmatically using Go.

In the introduction, we talked about the Kubernetes API as if it is just one thing, although in a sense, it can be thought of in that way. However, the Kubernetes API we have been talking about is an aggregation of multiple APIs served by the core of Kubernetes, the control plane API server. The API server exposes an HTTP API that exposes the aggregated API and allows for the query and manipulation of API objects such as Pods, Deployments, Services, and Namespaces.

In this lesson, we will learn how to use KinD to create a local cluster. We will use the local cluster to manipulate a namespace resource using kubectl. We will examine the basic structure of a Kubernetes resource and see how we can address individual resources by their Group, Version, Kind, Name, and, usually, Namespace. Lastly, we'll discuss authentication and the kubeconfig file. This lesson will prepare us for interacting with the Kubernetes API at a lower level using Go.

Creating a KinD cluster

Prior to getting started interacting with the Kubernetes API, let's build a local Kubernetes cluster using KinD. This is a tool that enables us to create a Kubernetes cluster locally using Docker rather than running as services on the host.

Terminal 1
Terminal
Loading...

To create the cluster, run the following in the terminal above:

C++
kind create cluster

The preceding command will create a cluster named kind. It will build a Kubernetes control plane ...