Orchest 常见问题终极解决方案：10个高效排错技巧

Orchest 是一个基于 Kubernetes 的 CI/CD 平台，适合自动化部署和管理应用程序，支持多种语言和框架。在使用过程中，用户经常会遇到一些常见问题，本文将为您提供完整的解决方案。

🔧 环境配置与依赖管理

如何安装新包的正确方法

安装新包的正确方式是通过环境配置功能。您需要创建一个包含所需包的新环境，然后在管道编辑器中选择该环境。使用熟悉的命令如 pip install 或 sudo apt-get install 来安装包。

注意事项：

• 更新现有环境时，新环境会自动在可视化编辑器中使用
• 如果 JupyterLab 内核已在运行，需要重新启动

避免模块找不到错误的终极方案

如果您遇到 ModuleNotFoundError 异常，即使已经声明了依赖项，这可能是由于重新安装了 ipykernel 导致的兼容性问题。

解决方案：

1. 在设置脚本末尾添加 python -m ipykernel install --sys-prefix，恢复 ipykernel 所需的工作路径
2. 使用 mamba（或 conda）而不是 pip 来安装依赖项，避免这种不兼容性

🚀 管道构建与代码共享

可视化管道编辑技巧

Orchest 提供强大的可视化管道编辑功能，让您能够直观地构建数据处理流程。

步骤间代码共享最佳实践

在步骤之间共享代码有多种方法：

• 将代码打包成包，然后像安装 numpy 等其他包一样安装到环境中
• 直接将文件添加到项目目录中，并在脚本中导入使用

示例：在项目目录中创建 utils.py 文件，然后通过 import utils 来使用其功能。

💾 存储优化与性能调优

最小化磁盘占用的黄金法则

为了保持 Orchest 的磁盘占用最小化，遵循以下最佳实践：

• 数据持久化：将数据写入 /data 目录而不是项目目录
• 作业配置：设置自动清理，仅保留一定数量的管道运行

GPU 支持现状说明

目前 Orchest 尚未提供 GPU 支持功能，该功能正在开发中。

📊 日志管理与调试技巧

步骤日志查看方法

通过查看步骤日志，您可以快速定位问题所在，了解每个步骤的执行情况。

🔍 高级排错与系统维护

调试 Orchest 服务的专业技巧

当遇到问题时，可以通过以下方式增加 Orchest 的详细程度：

orchest patch --log-level=DEBUG

数据库问题解决方案

多个头部修订错误： 当看到 Error: Multiple head revisions are present 错误时，使用以下命令解决：

bash scripts/migration_manager.sh orchest-api merge heads

开发模式故障排除

确保集群已挂载 Orchest 仓库。如果更改了依赖项，需要重新构建镜像并杀死 pod 以重新部署。

认证问题快速修复

对于启用认证的实例无法登录的问题：

1. 打开 k9s 并在 orchest-database pod 上打开 shell
2. 登录数据库并更新认证设置

🎯 实用小贴士与快捷操作

跳过笔记本单元格的简单方法

Orchest 提供了预安装的 JupyterLab 扩展来跳过特定单元格：

1. 打开 JupyterLab
2. 转到属性检查器（右侧的两个齿轮图标）
3. 选择要跳过的单元格并为其添加标签：skip

带有 skip 标签的单元格在 JupyterLab 中仍然可运行，但在 Orchest 中执行管道时不会运行。

环境变量缺失问题处理

当 orchest-api、orchest-webserver、auth-server 或 celery-worker 的 pod 出现环境变量相关问题时：

• 确保已构建控制器镜像
• 停止 Orchest
• 通过删除控制器 pod 或缩放部署来强制重新部署控制器镜像
• 启动 Orchest

通过掌握这些常见问题的解决方案，您将能够更高效地使用 Orchest 平台，充分发挥其自动化部署和管理应用程序的强大功能。