K8S etcd 排查

排查 Kubernetes (K8s) 中的 etcd 问题涉及到几个关键步骤：

1. **检查日志**：首先查看 `etcd` 的日志文件（默认在 `/var/log/etcd`），寻找有关“context deadline exceeded”的详细信息，它会包含关于出错操作的上下文和时间。

2. **监控状态**：通过 K8s 自带的 Dashboard 或第三方工具（如 Heapster 或 Prometheus），检查 `etcd-healthz` 接口的状态，看是否有可用性和健康警告。

3. **节点连接**：核实所有 K8s 节点是否正常连接到 etcd，并确认它们的 API 路由和证书是否正确配置。

4. **网络问题**：确认节点间的网络连接是否畅通无阻，尤其是当 etcd 集群部署在多机环境时。

5. **资源限制**：确保 etcd 集群有足够的 CPU、内存和磁盘空间来运行，同时检查其配置项如 `--max-procs` 是否合理。

6. **故障转移**：如果发现主 etcd 节点有问题，可以尝试手动切换到备份节点，看看是否能解决问题。

7. **故障排查工具**：利用 kubectl 命令行或 Kubernetes 相关命令，比如 `kubectl get events`，找出最近的异常事件。

8. **重启服务**：如果上述检查都无法确定问题，尝试重启 etcd 服务看是否可以恢复正常。

相关问题

K8S etcd特性

### Kubernetes 中 etcd 的特性及作用

#### 高可用性与一致性保障
etcd 是一个分布式键值数据库，在 Kubernetes 架构中扮演着至关重要的角色。作为一个高可用性的存储系统，etcd 使用 Raft 协议来确保数据的一致性和可靠性[^2]。

#### 存储核心元数据
自 Kubernetes v0.4 版本起采用 etcd 作为其核心元数据的存储服务。这使得所有的集群状态信息、资源对象定义以及其他重要配置都被保存在 etcd 当中。因此，任何对这些数据的操作都会涉及到与 etcd 的交互过程。

#### 实现动态发现和服务注册
借助于 etcd 提供的强大功能——Watch机制，Kubernetes 能够实现实时监控特定键/值的变化情况，并据此作出响应动作。这种能力对于自动扩展应用实例数量、负载均衡器调整目标节点列表等场景尤为重要[^1]。

#### 支持大规模部署环境下的高效协作
由于采用了高效的并发控制算法以及优化过的读写性能设计，即使是在拥有成千上万个 Pod 和 Service 的大型生产环境中，etcd 依然可以稳定运行并提供快速的数据访问体验。

# 查看当前Etcd集群健康状况命令示例
kubectl get --raw=/healthz

K8S etcd运维命令

Kubernetes (K8s) 中的 etcd 是一个分布式键值存储，用于持久化存储集群的配置信息。以下是关于 etcd 的一些基本运维命令：

1. 安装和启动 etcd：

   kubectl apply -f https://raw.githubusercontent.com/coreos/etcd/master/Documentation/examples/v3_5/etcd.yaml
   sudo systemctl start etcd

2. 验证 etcd 是否运行正常：

   etcdctl member list

3. 获取 etcd 数据：

   etcdctl get / <key>

4. 将配置添加到 etcd：

   etcdctl set /path/to/key value

5. 同步集群：

   etcdctl snapshot save <output-file>

6. 恢复从备份恢复 etcd 集群：

   etcdctl restore <input-file>

7. 更新 etcd 配置（例如更新证书）：

   kubectl edit deployment etcd

8. 切换至新的 etcd 实例：

   kubectl drain node-with-old-etcd --delete-local-data=true --force
   kubectl delete pod --all -n kube-system

请注意，在实际环境中，这些命令可能会因 Kubernetes 版本和集群配置的不同而有所变化。在操作前建议查阅官方文档或参考具体的 K8s 部署指南。