Worktree Manager_IT运维与安全 skill-PHP中文网

首页专区 Skill 文章专题 AI工具学习编程手册

剧云中文短剧剧本制作平台立刻MV 低成本歌曲 MV、视频生成 Laper 剧本策划到成片协作 updream 一键生成高质量推广成片

PHP MySQL jquery HTML CSS

Worktree Manager

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

管理基于 Docker 的开发实例及 git worktree，处理应用容器生命周期、数据库种子数据和代理路由激活，需要 mysql‑manager 等依赖。

Worktree 管理器管理 Docker app例和 git 工作树用于本地开发

功能概述

Worktree 管理器管理 Docker app例和 git 工作树用于本地开发是一项面向实际任务的技能，主要用于每个实例都获得自己的 docker 编译堆栈( 后端 + 前端) , 孤立的 git 分支和 . env. workt。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Worktree Manager

用于本地开发的 Docker 应用实例与 Git worktree 管理工具。

每个实例拥有独立的 docker-compose 栈（后端 + 前端）、隔离的 Git 分支，以及一个 .env.worktree- 文件。MySQL 和 nginx-proxy 由各自独立的插件单独管理。

前置条件

请按顺序先启动以下服务（顺序至关重要）：

proxy-manager start — 创建共享 Docker 网络（nginx-proxy_net）
mysql-manager start — 启动共享 MySQL 容器

架构

project/
├── docker-compose.yml        # 应用栈模板（后端 + 前端）
├── run.sh                    # 本插件的入口脚本（需复制到项目根目录）
├── .env.base                 # 主实例环境变量文件
├── .env.worktree-      # 每个 worktree 对应的环境变量文件（已加入 .gitignore）
└── .worktrees/
    └── /               # Git worktree 目录（已加入 .gitignore）

main → 使用 .env.base，位于项目根目录
worktree → 使用 .env.worktree-，检出至 .worktrees/
访问地址：http://.frontend.localhost / http://.backend.localhost

命令

所有命令均需在项目根目录下执行：

./run.sh list                        # 显示所有实例及 MySQL/Proxy 状态
./run.sh start [main|]         # 初始化数据库、启动容器、连接代理
./run.sh stop  [main|]         # 停止容器（数据库数据保留）
./run.sh restart [main|]       # 先停止再启动
./run.sh logs  [main|]         # 实时查看容器日志
./run.sh create-worktree       # 创建 Git worktree、分支及环境变量文件
./run.sh remove-worktree       # 停止容器 + 删除数据库 + 移除 worktree

任务执行方式

完整环境初始化（首次使用）

proxy-manager/run.sh start        # 启动网络与 nginx-proxy
mysql-manager/run.sh start        # 启动 MySQL
./run.sh start main               # 启动主应用实例

新建 worktree 并启动

./run.sh create-worktree — 创建分支 worktree/、目录 .worktrees/ 及对应环境变量文件
./run.sh start — 从 main 快照导入数据库、启动容器、激活代理路由
完成后将输出前端与后端访问 URL

停止某个实例

./run.sh stop

删除 worktree（破坏性操作 — 每次执行前必须确认）

用户确认提示：“是否删除 worktree ‘’？该操作将删除容器、数据库、Git worktree（分支 worktree/）以及 .env.worktree- 文件。”

./run.sh remove-worktree

列出所有实例

./run.sh list

`start` 命令执行流程

检查 MySQL 容器是否正在运行（若未运行则报错退出）
为当前实例执行 CREATE DATABASE IF NOT EXISTS
对于非 main 实例：将 codai_main 数据库 dump 并导入至当前实例数据库
执行 docker compose up --build -d
执行 docker network connect — 将 proxy 连接到实例网络（激活路由）

规范

每次执行 start 前，务必先运行 ./run.sh list 查看 MySQL/Proxy 状态。
执行 remove-worktree 前必须人工确认 — 此操作不可逆。
start 成功后，需打印出前端与后端的访问 URL。
若 ./run.sh 不具备可执行权限，请先执行：chmod +x run.sh
.env.worktree-* 文件与 .worktrees/ 目录必须加入 .gitignore。

配置项

变量名	默认值	用途
`MYSQL_CONTAINER`	`codai_db`	MySQL 容器名称
`MYSQL_ROOT_PASS`	`secret`	MySQL root 用户密码
`MYSQL_MAIN_DB`	`codai_main`	快照导出的数据源数据库
`PROXY_CONTAINER`	`codai_nginx_proxy`	nginx-proxy 容器名称
`PROJECT_PREFIX`	`codai-dev`	Docker Compose 项目前缀