# 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 形如：

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

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

## 本机启动

```bash
cd /home/ivan/xuan/nano_project/deploy-control
uv run server.py
```

## Docker 启动

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

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

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