在Devenv项目中同时运行多个process-compose服务的解决方案

在开发环境中，我们经常需要同时运行多个独立的项目，每个项目可能都有自己的服务依赖。当这些项目都使用Devenv和process-compose来管理服务时，会遇到一个常见问题：默认情况下无法同时运行多个process-compose实例。

问题本质

process-compose默认会监听9999端口来提供TUI界面和控制功能。当第一个项目启动process-compose后，它会占用这个默认端口。此时如果尝试启动第二个项目，由于端口已被占用，第二个process-compose实例将无法启动，导致整个项目启动失败。

解决方案

方法一：为每个项目配置不同的端口

最直接的解决方案是为每个项目的process-compose配置不同的监听端口。在Devenv的配置文件中，可以这样设置：

process.process-compose = {
  version = "0.69.0";
  port = 12345;  # 为每个项目设置唯一端口
  tui = "false"; # 可选，关闭TUI界面
};

这种方法简单有效，特别适合固定项目数量的场景。开发人员需要确保为每个项目分配唯一的端口号，避免冲突。

方法二：直接调用process-compose命令

更灵活的方式是绕过Devenv的封装，直接调用process-compose命令。这种方法有两个优势：

1. 避免了Devenv启动时的额外开销
2. 可以更灵活地控制参数，包括端口号

实现方式是在项目的shellHook中设置PATH，使process-compose命令可用，然后创建简单的包装脚本。例如可以创建一个名为ci-test的脚本，在其中显式指定端口号。

最佳实践建议

1. 端口管理：建议建立一个项目端口分配表，避免团队成员之间的端口冲突
2. 环境隔离：考虑使用容器技术或虚拟环境进一步隔离各个项目的运行环境
3. 自动化配置：可以编写脚本自动检测可用端口并分配给新项目
4. 文档记录：在项目README中记录使用的端口号，方便团队成员协作

总结

在Devenv生态中管理多个并行运行的process-compose项目，关键在于解决端口冲突问题。通过合理配置或直接控制process-compose命令，开发者可以轻松实现多项目并行开发的需求。选择哪种方案取决于项目规模、团队习惯和具体的开发流程需求。