环境搭建与基本操作

使用 kind 和 kubectl 在本机创建 Kubernetes 集群,学会检查节点、通过 YAML 创建 Namespace 并查看资源状态。

🎯 引言

上一篇我们认识了 Kubernetes 的 Cluster、Node 和 Pod。但要真正学会 Kubernetes,还需要一个能够执行命令的集群。

学习阶段不必先购买服务器。本篇使用 kind 在电脑上创建一个本地集群,再用 kubectl 操作它。我们会从安装工具开始,完成创建集群、查看节点、编写 YAML 和验证资源的全过程。

学完后,你应该能够独立创建本地练习集群,并判断自己的操作是否成功。下一篇再用它部署 Node.js 服务。

为了让暂时不方便动手的读者也能看懂,本文在主要命令后提供了 模拟终端输出。这些输出不是在你的电脑上真实执行得到的,版本号、地址、时间和部分系统 Pod 名称可能不同。阅读时重点观察关键字段和成功标志。

🧱 认识 kind 与 kubectl

这两个工具分工不同:

工具解决什么问题本篇怎么用
kind在本机创建 Kubernetes 练习集群创建名为 node-course 的集群
kubectl向 Kubernetes 集群发送管理命令查看节点、创建和查询资源

kind 的名字来自 Kubernetes IN Docker。本篇使用 Docker 作为容器运行环境:kind 会创建 Docker 容器,用这些容器充当 Kubernetes 节点。

可以先把整个操作过程理解为:

正在加载流程图…

这张图展示的是工具之间的作用关系,而不是严格的网络拓扑。创建好集群后,日常查看、配置资源主要使用 kubectl;需要创建或删除整个练习集群时,才使用 kind。


🛠 安装学习环境

以下以 macOS + Docker Desktop + Homebrew 为例。Windows 和 Linux 的安装入口放在本节末尾,后面的 Kubernetes 命令基本相同。

1. 准备 Docker

先安装并启动 Docker Desktop。如果之前学过 Docker 且已经安装,可以直接使用原来的环境。

打开终端,执行:

docker info

这条命令会显示 Docker 客户端和服务端的信息。输出通常很长,下面仅展示关键部分:

Client:
 Version:    28.0.0
 Context:    desktop-linux

Server:
 Containers: 1
  Running: 0
 Server Version: 28.0.0

这是模拟输出,不代表必须使用这个版本。关键是 能看到 Server 部分并且命令没有连接错误,说明当前终端能够连接 Docker 引擎。

如果出现 Cannot connect to the Docker daemon 等错误,先检查 Docker Desktop 是否启动。不要跳过此步骤直接创建集群。

2. 安装 kind 和 kubectl

如果已经安装 Homebrew,在终端执行:

brew install kind
brew install kubernetes-cli

安装过程会显示 Homebrew 下载、安装软件包的日志,结尾可能类似:

==> Installing kind
🍺  /opt/homebrew/Cellar/kind/0.xx.x: ...
==> Installing kubernetes-cli
🍺  /opt/homebrew/Cellar/kubernetes-cli/1.xx.x: ...

上面是省略中间步骤的模拟输出;安装路径、软件版本和日志会因机器不同而变化。

安装完成后,验证这两个命令是否可用:

kind version
kubectl version --client

模拟输出:

$ kind version
kind v0.xx.x go1.xx.x darwin/arm64

$ kubectl version --client
Client Version: v1.xx.x
Kustomize Version: v5.x.x

只要能正常显示版本,说明命令已安装并能运行。 版本号和系统架构仅为示意,不需要与示例相同。

如果提示 brew: command not found,说明 Homebrew 尚不可用。请先按照 Homebrew 官网 的说明安装它,再回来执行上面的命令。

其他系统可使用官方安装指南:


🚀 创建并检查本地集群

1. 创建集群

在终端执行:

kind create cluster --name node-course --wait 60s

这里有三个部分:

  • create cluster:创建 Kubernetes 集群。
  • --name node-course:给集群取名为 node-course。
  • --wait 60s:最多等待 60 秒,检查控制平面是否达到就绪状态;如果超时,需检查集群实际状态。

首次运行时,kind 可能需要下载节点镜像,所需时间取决于网络和本机性能。模拟输出如下(日志可能略有不同):

Creating cluster "node-course" ...
 ✓ Ensuring node image
 ✓ Preparing nodes
 ✓ Writing configuration
 ✓ Starting control-plane
 ✓ Installing CNI
 ✓ Installing StorageClass
 ✓ Waiting for control-plane ready
Set kubectl context to "kind-node-course"
You can now use your cluster with:

kubectl cluster-info --context kind-node-course

可以把这段输出理解为:kind 创建了节点、准备了集群组件,并把 kubectl 的当前连接目标切换到新集群。若命令报告超时或错误,应先处理错误,不要把上面的模拟输出当作真实成功结果。

命令成功后,可以用下面的命令确认集群是否存在:

kind get clusters

模拟输出:

$ kind get clusters
node-course

出现 node-course,说明 kind 记录的集群列表中已有这个集群;是否真正就绪,还要继续查看节点状态。

2. 看看集群创建在哪里

在本篇使用的 Docker 环境里,kind 的节点实际上是 Docker 容器。执行:

docker ps

模拟输出(为便于阅读,省略部分列与其他 Docker 容器):

$ docker ps
CONTAINER ID   IMAGE                 STATUS         NAMES
8a3f2c1d9e00   kindest/node:v1.xx.x   Up 2 minutes   node-course-control-plane

重点查看最后的 NAMES 列:node-course-control-plane 就是 kind 创建的节点容器。CONTAINER ID、镜像版本和运行时间会因环境而变化。

这个容器承担着本地集群的 Kubernetes 节点角色。默认配置下,kind 通常只创建一个节点,它同时承担控制平面和工作负载运行的职责。

下面是结构示意:

正在加载流程图…

图中为了方便理解,把控制平面组件与系统 Pod 分开画出;实际上部分控制平面组件也以静态 Pod 的形式运行。kind 的一个节点容器不等于一个业务 Pod。

3. 查看当前连接的集群

kubectl config current-context

模拟输出:

$ kubectl config current-context
kind-node-course

如果看到 kind-node-course,就表示 kubectl 当前选择的是我们刚才创建的练习集群。

这里的 context(上下文) 可以先理解成:kubectl 当前选择操作哪一个集群及对应的访问配置。

以后电脑上可能有多个 Kubernetes 集群,因此执行操作前,确认当前 context 很重要。

再查看集群连接信息:

kubectl cluster-info

模拟输出(地址和端口因环境而异):

$ kubectl cluster-info
Kubernetes control plane is running at https://127.0.0.1:51234
CoreDNS is running at https://127.0.0.1:51234/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

看到 Kubernetes control plane is running at ...,表示 kubectl 已经能够访问集群的控制平面。这里的 127.0.0.1 是本机地址,不是要求读者访问的公网服务器。

4. 查看节点

kubectl get nodes

输出可能类似:

NAME                        STATUS   ROLES           AGE   VERSION
node-course-control-plane   Ready    control-plane   2m    v1.x.y

这是模拟输出,实际时间、版本可能不同。只要节点出现 Ready,就表示已经就绪;不要把示例里的 v1.x.y 当作真实版本号。

字段含义
NAME节点名称
STATUS节点状态,Ready 表示已就绪
ROLES节点角色
AGE节点创建至今的时间
VERSION节点的 Kubernetes 版本

如果节点状态为 Ready,就完成了本篇最重要的一步:本地 Kubernetes 集群已经创建并可以使用。

如果创建失败,先检查 docker info 是否正常;如果节点尚未 Ready,不要急着继续下一节,先查看创建命令的报错并重新检查节点状态。


🧩 使用 YAML 创建第一个资源

集群已经创建好了。接下来不部署 Node.js 服务,先做一个更小的操作:创建 Namespace。

Namespace 可以先理解成 Kubernetes 集群里的一个资源分组。例如,后续我们可以把课程练习用的资源放在名为 course 的 Namespace 中,方便区分。

1. 编写 YAML

创建文件 namespace.yaml,写入:

apiVersion: v1
kind: Namespace
metadata:
  name: course

Kubernetes 经常使用 YAML 文件描述希望创建或管理的资源。这个例子只需要理解三个字段:

字段含义这里的值
apiVersion资源使用的 API 版本v1
kind资源的类型Namespace
metadata.name资源的名称course

注意:name 缩进到 metadata 下方,表示它属于 metadata。这里使用两个空格,重点是缩进层级正确,而不是必须使用两个空格。

2. 提交资源配置

在 namespace.yaml 所在目录打开终端,执行:

kubectl apply -f namespace.yaml

其中 -f 表示从指定文件读取配置。

首次创建成功时,通常会看到:

namespace/course created

这表示名为 course 的 Namespace 已创建。如果再次运行相同命令,并且内容没有变化,模拟输出会变成:

namespace/course unchanged

unchanged 表示配置没有变化,不是执行失败。

3. 查看创建结果

执行:

kubectl get namespaces

输出可能类似:

NAME              STATUS   AGE
default           Active   5m
kube-system       Active   5m
course            Active   30s

这里只展示部分可能出现的行,实际列表还可能包含其他 Namespace。

NAME 是名称,STATUS 是状态,AGE 是创建至今的时间。如果能看到 course 且状态为 Active,就说明这次操作成功了。

想只查看 course,可以执行:

kubectl get namespace course

模拟输出:

$ kubectl get namespace course
NAME     STATUS   AGE
course   Active   1m

这样就不需要从所有 Namespace 中寻找它;看到 Active 就是本次检查的关键。


🔎 常用查看命令

后面部署 Node.js 服务时,会频繁检查 Kubernetes 资源。现在只掌握最基本的两个命令就够了。

1. 用 get 查看资源

kubectl get nodes
kubectl get namespaces
kubectl get pods -A

get 用来查看指定类型资源的列表及基本状态。其中前两条命令的输出,在前面已经分别展示过。

第三条命令的模拟输出如下(仅截取部分系统 Pod):

$ kubectl get pods -A
NAMESPACE            NAME                                      READY   STATUS    RESTARTS   AGE
kube-system          coredns-xxxxxxxxxx-xxxxx                  1/1     Running   0          4m
kube-system          etcd-node-course-control-plane            1/1     Running   0          4m
kube-system          kube-apiserver-node-course-control-plane  1/1     Running   0          4m
local-path-storage   local-path-provisioner-xxxxxxxxxx-xxxxx   1/1     Running   0          4m

pods 指 Pod 资源,-A 表示查看所有 Namespace。READY 显示容器就绪数量,STATUS 显示 Pod 状态,例如 Running 表示 Pod 正在运行;AGE 表示已存在多久。Pod 后缀和具体数量会变化。

现在还没部署自己的订单服务,因此看到的 Pod 主要是 Kubernetes 自带的系统组件,这是正常的。

2. 用 describe 查看详细信息

kubectl describe namespace course

模拟输出(不同版本的字段可能有差异):

$ kubectl describe namespace course
Name:         course
Labels:       kubernetes.io/metadata.name=course
Annotations:  <none>
Status:       Active

No resource quota.

No LimitRange resource.

Name 是资源名称,Labels 是附加的标识信息,Status: Active 表示 Namespace 处于活动状态。No resource quota 表示这里没有设置资源配额。

describe 会显示该资源的更详细信息。对于 Namespace,输出比较简单;后续排查 Pod 时,这个命令会更有用。

先记住它们的区别:

命令适合做什么
kubectl get快速查看有哪些资源、当前是什么状态
kubectl describe进一步查看某个资源的详细信息

本篇不需要记住所有 kubectl 命令。下一篇部署服务时,我们会继续使用这些命令。


🧹 清理练习环境

如果你准备继续下一篇课程,现在不要删除集群。 下一篇会继续使用名为 node-course 的集群。

等整个课程练习结束、确定不需要其中的资源后,再执行:

kind delete cluster --name node-course

模拟输出:

$ kind delete cluster --name node-course
Deleting cluster "node-course" ...
Deleted nodes: [node-course-control-plane]

这条命令会删除对应的 kind 集群及其中的练习资源,不只是退出终端。如果还要继续学习,不要执行。

如果只是暂时不练习,可以关闭电脑或 Docker Desktop,不需要执行删除命令。下次使用前,请先启动 Docker Desktop 并确认集群节点状态;如果原有集群未正常恢复,再根据实际情况排查。


❓ 知识问答

Q:为什么创建集群后只有一个 Node?

因为 kind 默认创建的是单节点集群。这已经足够完成前期的 Kubernetes 基础练习;后续需要学习多节点时,再创建多节点集群即可。

Q:kind、Docker 和 kubectl 是同一个东西吗?

不是。Docker 提供容器运行环境,kind 利用容器创建本地 Kubernetes 集群,kubectl 则用于管理创建好的 Kubernetes 资源。

Q:为什么这篇不直接部署 Node.js 服务?

先确保本地集群可用,并学会执行、验证最基本的 Kubernetes 命令。下一篇部署失败时,你才更容易区分环境问题和应用配置问题。


🧪 小练习

在本机独立完成以下操作:

  1. 确认 Docker、kind、kubectl 可用。
  2. 创建名为 node-course 的 Kubernetes 集群。
  3. 使用 kubectl get nodes 确认节点处于 Ready。
  4. 使用 YAML 创建名为 course 的 Namespace。
  5. 使用 kubectl get namespace course 查看创建结果。

验收标准: 能看到就绪的 Node 和状态为 Active 的 course Namespace,并且能说出 kind、kubectl、Node、Namespace 分别负责什么。


🎉 恭喜你!你已经完成了 Kubernetes 本地环境搭建,并学会使用 kubectl 创建、查看和验证最基本的资源。下一篇,我们将在这个集群中部署真正的 Node.js 服务。