minienv Vibe 项目

minienv 是一款可以从 Docker Compose 配置文件直接生成远程轻量级开发环境的命令行工具。它的核心理念是：团队成员已经在 docker-compose.yml 里描述了自己的服务栈，为什么还要维护一套与之重复的 Kubernetes 配置或 Helm Chart 呢？minienv 直接读取已有的 Compose 文件，加上一层轻量的扩展配置块，就能把整个服务栈部署到远程环境，让 teammates 只需点击链接就能审查对应分支上的功能。

解决什么问题

传统的远程开发环境分享流程需要两道配置：一份 docker-compose.yml 用于本地开发，一份 Kubernetes 清单或 Helm Chart 用于共享评审环境。这两份配置从创建的第一天起就会产生漂移——只要有人在 Compose 文件里加一个服务，远程环境的对应配置就过时了。minienv 消除了这道重复配置，让 Compose 文件本身成为唯一的真相来源。

核心功能

minienv 读取 Compose 文件中每个含 build: 的服务，自动构建镜像并推送到镜像仓库；自动创建目标命名空间（Kubernetes namespace 或远程 Docker 项目目录）；按 depends_on 顺序依次部署所有服务；支持 ngrok 自动暴露公共服务，让外部评审人员无需配置 VPN 即可访问。销毁时运行 minienv destroy，整个环境连同所有关联资源一并清理。

技术实现

minienv 支持两种目标后端。通过 docker 后端，可以将整个 Compose 项目部署到一台远程 Docker 主机，传输层支持 SSH 接入远程服务器；通过 k8s 后端，可以将每个服务作为独立 Helm Release 部署到 Kubernetes 集群，开发者可以在不同 Kubernetes 上下文中切换。扩展配置以 x-minienv 键嵌入现有的 docker-compose.yml 文件，无需新建独立配置文件。

快速上手

第一步，编写扩展配置：在已有的 docker-compose.yml 顶部添加 x-minienv 块，指定目标集群上下文和命名空间。例如指定 minikube 集群和 my-feature-branch 命名空间。

第二步，运行部署：执行 minienv deploy，工具自动完成镜像构建、推送和远程服务启动，全程无需手动操作。

第三步，共享访问地址：部署完成后，每个暴露了端口的服务会获得一个公共访问 URL，复制链接发给同事即可开始评审。

第四步，清理环境：评审结束后运行 minienv destroy，工具自动删除所有部署的资源和命名空间，不留残余。

适用人群

需要频繁共享开发环境给远程同事或评审人员的全栈开发者；使用 Docker Compose 管理微服务栈并希望简化 CI/CD 环境中环境创建和销毁流程的 DevOps 工程师；以及希望确保每个代码分支都能在一致环境中被独立验证的测试团队。minienv 让「在我机器上能跑」的问题成为历史，每一个环境都来自同一份配置，每一次部署都完全一致。