---
title: Kubernetes 集群二进制包部署实践（面向企业运维）
description: 面向企业 IT 运维，讲解用二进制包部署 Kubernetes 集群的通用流程：环境规划、etcd 与 Master/Node 组件配置、启动顺序、验证与回退。所有环境参数用中文占位符表示，具体版本与参数以对应版本文档为准。
url: "https://www.lanever.com/docs/kubernetes-%e9%9b%86%e7%be%a4%e4%ba%8c%e8%bf%9b%e5%88%b6%e5%8c%85%e9%83%a8%e7%bd%b2%e5%ae%9e%e8%b7%b5%ef%bc%88%e9%9d%a2%e5%90%91%e4%bc%81%e4%b8%9a%e8%bf%90%e7%bb%b4%ef%bc%89/"
updated: "2026-10-12"
category: Kubernetes
---

# Kubernetes 集群二进制包部署实践（面向企业运维）

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Kubernetes(K8S)集群管理Docker容器（部署篇） - 李振良的技术博客 - CSDN博客](https://blog.csdn.net/zhenliang8/article/details/78611004)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

需要在受控内网环境中搭建一套可观测、可拆解的 Kubernetes 集群，并希望理解各组件职责与依赖关系时，可采用二进制包方式部署。相比自动化工具，二进制方式暴露更多配置细节，便于排障与教学；代价是手工步骤多、易出错，适合具备 Linux 与 systemd 基础的运维人员。

本文给出通用流程与安全形式命令，不绑定具体版本。Kubernetes、Docker、etcd 的版本兼容性与参数名称请查阅对应版本官方文档。

## 准备与风险

- 规划角色与地址：至少一台 master（承载 etcd、kube-apiserver、kube-controller-manager、kube-scheduler），若干 node（承载 kubelet、kube-proxy、容器运行时）。地址统一用 `[服务器地址]`、`[节点地址]` 占位。
- 操作系统：常见企业发行版均可，需确认内核、cgroup 驱动与容器运行时匹配。
- 关闭 SELinux 或配置为宽容模式前，先确认合规要求；生产环境建议按安全基线评估。
- 时间同步、主机名解析、防火墙端口放行需提前完成。
- 风险提示：部署涉及系统服务与网络配置变更。务必先在测试环境验证，并对 etcd 数据目录、原有配置文件做备份。破坏性操作（如清空数据目录、删除服务单元）执行前必须确认可回退。

## 处理步骤

### 1. 获取二进制包

从官方发布渠道获取服务端与节点端二进制包，校验完整性后分发：服务端包放 master，节点端包放 node。解压后将所需可执行文件放入统一目录，例如 `/opt/kubernetes/bin`，配置放入 `/opt/kubernetes/cfg`。

### 2. 部署 etcd

etcd 是集群状态存储，必须先于 apiserver 启动。安装后编辑配置文件，设置数据目录、监听地址与对外通告地址。示例（参数用占位符）：

```
ETCD_NAME="[节点名称]"
ETCD_DATA_DIR="[数据目录]"
ETCD_LISTEN_CLIENT_URLS="[外部链接已移除]"
ETCD_ADVERTISE_CLIENT_URLS="[外部链接已移除]"
```

不同发行版配置文件路径不同，请以实际系统为准。启用并启动服务后，确认进程与端口正常。

### 3. 启动 Master 组件

为每个组件创建环境变量配置文件与 systemd 单元。apiserver 需指向 etcd 地址、监听地址与端口、服务网段等；scheduler 与 controller-manager 需指向 apiserver 地址，并按需启用 leader 选举。示例片段：

```
KUBE_LOGTOSTDERR="--logtostderr=true"
KUBE_LOG_LEVEL="--v=4"
KUBE_ETCD_SERVERS="--etcd-servers=[外部链接已移除]"
KUBE_API_ADDRESS="--insecure-bind-address=[服务器地址]"
KUBE_API_PORT="--insecure-port=8080"
KUBE_SERVICE_ADDRESSES="--service-cluster-ip-range=[服务网段]"
```

systemd 单元通过 `EnvironmentFile` 引入上述变量，`ExecStart` 调用对应二进制。执行 `systemctl daemon-reload` 后依次启用并启动。启动顺序：etcd → apiserver → 其他 Master 组件。

### 4. 启动 Node 组件

节点端需准备 kubelet 的 kubeconfig，用于连接 apiserver；再配置 kubelet 与 kube-proxy 的环境变量文件及 systemd 单元。kubeconfig 示例：

```
apiVersion: v1
kind: Config
clusters:
- cluster:
 server: [外部链接已移除]
 name: local
contexts:
- context:
 cluster: local
 name: local
current-context: local
```

确认容器运行时已启动，再启用并启动 kubelet、kube-proxy。节点注册依赖网络与证书/认证配置，具体参数以对应版本文档为准。

## 验证方法

- 查看服务状态：`systemctl status [服务名]`，确认 active。
- 查看日志：`journalctl -u [服务名]`，定位启动失败原因。
- 在 master 执行 `kubectl get nodes`，确认节点进入就绪状态。
- 执行 `kubectl get componentstatuses`（若该版本支持）检查核心组件健康。
- 部署一个最小工作负载，确认调度与网络连通。

## 回退建议

- 变更前备份 etcd 数据目录与全部配置文件。
- 回退时先停止新增服务，恢复原配置文件与数据目录，再按原顺序启动。
- 若节点注册异常，可先下线该节点、清理其本地状态后再重新加入；清理前确认不影响其他工作负载。
- 无法回退时，保留日志与配置快照，便于后续分析。

## 常见问题

- apiserver 启动失败：检查 etcd 地址、端口与存储后端版本是否匹配。
- 节点未就绪：检查 kubelet 日志、容器运行时状态与 kubeconfig 指向。
- 组件间通信失败：核对监听地址、防火墙规则与时间同步。
- 参数不生效：确认 systemd 单元已 `daemon-reload`，且环境变量文件路径正确。
- 版本差异：不同 Kubernetes 版本的参数与默认行为可能变化，务必查阅对应版本官方文档。
