环境搭建与基本操作
🎯 引言
上一篇我们认识了 Kubernetes 的 Cluster、Node 和 Pod。但要真正学会 Kubernetes,还需要一个能够执行命令的集群。
学习阶段不必先购买服务器。本篇使用 kind 在电脑上创建一个本地集群,再用 kubectl 操作它。我们会从安装工具开始,完成创建集群、查看节点、编写 YAML 和验证资源的全过程。
学完后,你应该能够独立创建本地练习集群,并判断自己的操作是否成功。下一篇再用它部署 Node.js 服务。
🧱 认识 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 通常只创建一个节点,它同时承担控制平面和工作负载运行的职责。
下面是结构示意:
正在加载流程图…
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 命令。下一篇部署失败时,你才更容易区分环境问题和应用配置问题。
🧪 小练习
在本机独立完成以下操作:
- 确认 Docker、kind、kubectl 可用。
- 创建名为
node-course的 Kubernetes 集群。 - 使用
kubectl get nodes确认节点处于Ready。 - 使用 YAML 创建名为
course的 Namespace。 - 使用
kubectl get namespace course查看创建结果。
验收标准: 能看到就绪的 Node 和状态为 Active 的 course Namespace,并且能说出 kind、kubectl、Node、Namespace 分别负责什么。
🎉 恭喜你!你已经完成了 Kubernetes 本地环境搭建,并学会使用 kubectl 创建、查看和验证最基本的资源。下一篇,我们将在这个集群中部署真正的 Node.js 服务。
