beaver_project/deploy-control/README.md

deploy-control

部署机接口：

• 给 auth-portal 提供实例创建和实例解析 API
• 调用 app-instance/create-instance.sh
• 在实例创建后刷新 router-proxy

接口

• GET /healthz
• POST /api/instances/register
• POST /api/instances/resolve
• DELETE /api/instances/{instance_id}

关键环境变量

• DEPLOY_CONTROL_API_TOKEN
• APP_INSTANCE_API_KEY
• DEFAULT_AUTHZ_BASE_URL
• DEPLOY_PUBLIC_BASE_DOMAIN
• DEPLOY_PUBLIC_PORT
• DEPLOY_PUBLIC_SCHEME
• APP_INSTANCE_NETWORK_NAME

默认实例 URL 形如：

http://<instance-slug>.127.0.0.1.nip.io:8088

实例容器本身的 20000-29999 端口默认只绑定到部署机 127.0.0.1，外部入口应走 router-proxy。

本机启动

cd /home/ivan/xuan/nano_project/deploy-control
python3 server.py

Docker 启动

如果要容器化运行，需要挂载：

• Docker socket：/var/run/docker.sock
• /home/ivan/xuan/nano_project/app-instance
• /home/ivan/xuan/nano_project/router-proxy

并传入对应环境变量，让容器内脚本路径仍能访问这两个目录。