OpenShift Origin 项目调试指南：常见问题排查与解决方案
项目地址: https://gitcode.com/gh_mirrors/or/origin 前言
OpenShift Origin 作为企业级 Kubernetes 发行版，在实际部署和运行过程中可能会遇到各种问题。本文将从技术专家角度，系统性地梳理 OpenShift v3 部署中的常见问题及其解决方案，帮助开发者快速定位和解决问题。
系统环境配置
1. 权限与防火墙配置
OpenShift v3 需要以 root 权限启动，以便管理 iptables 配置。但日常操作命令（如 oc create）无需 root 权限。
对于使用 firewalld 的系统（如 Fedora），需将 docker0 接口加入受信任区域：
firewall-cmd --zone=trusted --change-interface=docker0
systemctl restart firewalld
或者直接禁用 firewalld：
systemctl stop firewalld
2. DNS 配置要点
容器需要能够解析主机名，建议将主机 DNS 配置为容器可访问的地址。常见做法是使用公共 DNS 服务器如 8.8.8.8。
3. iptables 规则管理
重启 iptables 时，务必先备份再恢复规则，否则 Docker 插入的规则会丢失：
iptables-save > /path/to/iptables.bkp
systemctl restart iptables
iptables-restore < /path/to/iptables.bkp
构建故障排查
1. 获取构建日志
首先检查构建日志：
oc logs build/[build_id]
获取构建 ID：
oc get builds
2. 直接查看 Docker 容器日志
如果无法通过 OpenShift 获取日志，可直接从 Docker 查看：
docker ps -a | grep builder
docker logs [container id]
3. 常见构建问题
主机名解析失败
若日志中出现无法解析 GitHub 等域名的问题：
Could not resolve host: github.com; Unknown error
解决方案：
sudo systemctl restart docker
oc start-build --from-build=<your build identifier>
容器镜像仓库问题
1. 检查本地仓库状态
oc adm registry --dry-run
正常应显示：
container image registry "docker-registry" service exists
若不存在，则启动：
oc adm registry
2. 非安全仓库配置
当出现推送失败时（如 TLS 相关错误），需配置 Docker 为非安全仓库：
编辑 /etc/sysconfig/docker 添加：
--insecure-registry 172.30.0.0/16
或直接启动 Docker：
docker daemon --insecure-registry 172.30.0.0/16
注意：网络范围应与 master-config.yaml 中的 networkConfig.serviceNetworkCIDR 一致。
容器调试技巧
1. 基本调试方法
查看容器日志：
docker logs [container id]
进入容器：
docker exec -it [container id] /bin/sh
2. 高级调试技巧
对于无法启动的容器，可将其提交为新镜像后调试：
docker commit <CONTAINER ID> <debug-image>
docker run -it <debug-image> /bin/bash
DNS 相关问题
1. 解决 DNS 服务冲突
dnsmasq 等 DNS 服务可能与 OpenShift 冲突，需禁用：
sudo systemctl stop dnsmasq
sudo systemctl disable dnsmasq
sudo killall dnsmasq
可忽略的错误信息
以下日志信息通常可安全忽略：
- 找不到 Pod IP（除非持续出现）
- 代理连接重置
- 无网络设置警告
Vagrant 同步文件夹问题
使用 Vagrant 同步文件夹时可能出现权限问题，解决方案是指定不同的卷存储目录：
openshift start --volume-dir=/absolute/path
全面故障收集
1. 日志收集
收集 OpenShift 详细日志（级别 4）和所有容器日志：
for container in $(docker ps -aq); do
docker logs $container >& $LOG_DIR/container-$container.log
done
2. 授权问题排查
遇到 403 错误时，收集相关策略信息：
oc describe policy default --namespace=master
oc describe policybindings master --namespace=master
oc describe policy default --namespace=<project-namespace>
# 其他相关命令...
结语
本文涵盖了 OpenShift Origin 项目中最常见的调试场景和解决方案。掌握这些技巧将大大提升您的问题排查效率。对于更复杂的问题，建议结合系统日志和上述收集的信息进行深入分析。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
