支持
第 1 章 etcd 服务 复制链接链接已复制到粘贴板!
etcd 服务作为 MicroShift RPM 的红帽构建的一部分提供。etcd 服务作为单独的进程运行,etcd 生命周期由 MicroShift 自动管理。
1.1. 观察并调试 MicroShift etcd 服务器 复制链接链接已复制到粘贴板!
您可以收集 journalctl 日志来观察和调试 etcd 服务器日志。
先决条件
- MicroShift 服务正在运行。
流程
要获取 etcd 的日志,请运行以下命令:
sudo journalctl -u microshift-etcd.scope
$ sudo journalctl -u microshift-etcd.scopeCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注意MicroShift 日志可以使用
journalctl -u microshift命令独立于 etcd 日志访问。
1.2. 配置 memoryLimitMB 值来为 etcd 服务器设置参数 复制链接链接已复制到粘贴板!
默认情况下,etcd 将根据需要使用内存来处理系统上的负载。在一些内存限制的系统中,可能需要限制给定时间允许使用的内存 etcd 量。
流程
编辑
/etc/microshift/config.yaml文件,以设置memoryLimitMB的值。etcd: memoryLimitMB: 128
etcd: memoryLimitMB: 128Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意MicroShift 上
memoryLimitMB的最小允许值为 128 MB。接近最小值的值可能更有可能影响 etcd 性能。的限制越低,etcd 响应查询所需的时间越长。如果限制太小,或者 etcd 用量很高,查询会超时。
验证
修改
/etc/microshift/config.yaml中的memoryLimitMB值后,运行以下命令来重启 MicroShift:sudo systemctl restart microshift
$ sudo systemctl restart microshiftCopy to Clipboard Copied! Toggle word wrap Toggle overflow 运行以下命令,验证新的
memoryLimitMB值是否正在使用:systemctl show --property=MemoryHigh microshift-etcd.scope
$ systemctl show --property=MemoryHigh microshift-etcd.scopeCopy to Clipboard Copied! Toggle word wrap Toggle overflow
1.3. 检查 etcd 版本 复制链接链接已复制到粘贴板!
您可以获取 MicroShift 中包含的 etcd 数据库的版本信息。
流程
要显示基本数据库版本信息,请运行以下命令:
microshift-etcd version
$ microshift-etcd versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
microshift-etcd Version: 4.15.1 Base etcd Version: 3.5.10
microshift-etcd Version: 4.15.1 Base etcd Version: 3.5.10Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要显示完整的数据库版本信息,请运行以下命令:
microshift-etcd version -o json
$ microshift-etcd version -o jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
第 2 章 使用 sos 报告 复制链接链接已复制到粘贴板!
您可以使用 sos 工具收集有关主机的故障排除信息。sos report 命令生成详细的报告,其中显示了系统中不同组件和应用程序中的所有已启用插件和数据。
2.1. 关于 sos 报告 复制链接链接已复制到粘贴板!
sos 工具由不同的插件组成,可帮助您从不同的应用程序收集信息。从 sos 版本 4.5.1 添加了特定于 MicroShift 的插件,它可以收集以下数据:
- MicroShift 配置和版本
- 集群范围和系统命名空间资源的 YAML 输出
- OVN-Kubernetes 信息
2.2. 从 sos 报告收集数据 复制链接链接已复制到粘贴板!
先决条件
-
已安装
sos软件包。
流程
- 以 root 用户身份登录到失败的主机。
运行以下命令执行 debug 报告创建步骤:
microshift-sos-report
$ microshift-sos-reportCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
第 3 章 获取支持 复制链接链接已复制到粘贴板!
使用以下信息获得 Red Hat Device Edge 的更多信息,包括红帽构建的 MicroShift 或 Red Hat Enterprise Linux for Edge (RHEL for Edge)。
3.1. 获取支持 复制链接链接已复制到粘贴板!
如果您在执行本文档所述的某个流程或红帽构建的 MicroShift 时遇到问题,请访问红帽客户门户。
通过红帽客户门户网站:
- 搜索或者浏览红帽知识库,了解与红帽产品相关的文章和解决方案。
- 提交问题单给红帽支持。
- 访问其他产品文档。
3.2. 提供文档反馈 复制链接链接已复制到粘贴板!
要报告错误或改进文档,请登录到 Red Hat JIRA 帐户 并提交 JIRA 问题。
3.3. 关于红帽知识库 复制链接链接已复制到粘贴板!
红帽知识库提供丰富的内容以帮助您最大程度地利用红帽的产品和技术。红帽知识库包括文章、产品文档和视频,概述了安装、配置和使用红帽产品的最佳实践。另外,您还可以搜索已知问题的解决方案,其提供简洁的根原因描述和补救措施。
3.4. 搜索红帽知识库 复制链接链接已复制到粘贴板!
如果红帽构建的 MicroShift 问题,您可以执行初始搜索来确定红帽知识库中是否已存在解决方案。
先决条件
- 您有红帽客户门户网站帐户。
流程
- 登录到 红帽客户门户网站。
- 点 Search。
在搜索字段中,输入与问题相关的关键字和字符串,包括:
- 红帽构建的 MicroShift 组件(如 etcd)
- 相关步骤(比如 安装)
- 警告、错误消息和其他与输出与特定的问题相关
- 点 Enter 键。
- 可选: 选择 红帽构建的 MicroShift 产品过滤器。
- 可选: 选择 Documentation 内容类型过滤器。
3.5. 提交支持问题单 复制链接链接已复制到粘贴板!
先决条件
- MicroShift 服务正在运行。
-
已安装 OpenShift CLI(
oc)。 - 您有红帽客户门户网站帐户。
- 您有红帽标准订阅或高级订阅。
流程
- 登录到红帽客户门户网站的客户支持 页面。
- 点 Get support。
在 客户支持 页面的 Cases 选项卡中:
- 可选:根据需要更改预先填充的帐户和所有者详情。
- 为您的问题选择适当的类别,如 Bug 或 Defect,然后点 Continue。
输入以下信息:
- 在 Summary 字段中,输入简要但描述性问题概述,以及有关所经历的症状的详细信息,以及您的预期。
- 从 产品 下拉菜单中选择 Red Hat Device Edge。
- 从 Version 下拉菜单中选择 4。
- 查看推荐的红帽知识库解决方案列表,它们可能会与您要报告的问题相关。如果建议的文章没有解决这个问题,请点 Continue。
- 查看更新的推荐红帽知识库解决方案列表,它们可能会与您要报告的问题相关。这个列表的范围会缩小,因为您在创建问题单的过程中提供了更多信息。如果建议的文章没有解决这个问题,请点 Continue。
- 请确保提供的帐户信息是正确的,如果需要,请相应调整。
在出现提示时填写以下问题。包括您使用的安装类型,可以是 RPM 或 embedded-image。点 Continue:
- 您遇到什么情况?您期望发生什么情况?
- 对业务的影响价值。
- 您在哪里遇到此行为?什么环境?
- 此行为何时发生?发生频率?重复发生?是否只在特定时间发生?
-
上传相关的诊断数据文件并点击 Continue。包含使用
sos工具或 etcd 作为起点收集的数据,以及这些日志中未收集的任何特定于问题的数据。 - 添加相关的问题单管理详情并点 Continue。
- 预览问题单详情,点 Submit。