参考来源与致谢
- 引用来源:Kubernetes(K8S)集群管理Docker容器(部署篇) – 李振良的技术博客 – CSDN博客
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
需要在受控内网环境中搭建一套可观测、可拆解的 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 版本的参数与默认行为可能变化,务必查阅对应版本官方文档。
