dev.sh 加 --postgres:起(已经有就复用、停着就起)一个本地开发用的 PostgreSQL 容器,端口只开在 127.0.0.1(缺省 55432),数据在 docker 数据卷,密码第一次自动生成在数据目录的 .postgres-dev/ 里,后端按 PGPASSFILE 读、照它设 AGENTLAB_DATABASE_URL;容器名、端口、数据卷、镜像可用 AGENTLAB_DEV_PG_* 改,同名容器不是这个脚本起的、端口和已有容器的不一致都照实报错。不加就和原来一样:SQLite,不用 docker

This commit is contained in:
ThearchyHelios
2026-10-19 13:43:33 +08:00
parent 93cd32bc97
commit bf74423651
+61 -5
View File
@@ -4,20 +4,30 @@ set -euo pipefail
usage() {
cat <<'USAGE'
用法:./scripts/dev.sh [--host]
用法:./scripts/dev.sh [--host] [--postgres]
--host 前端也在局域网上监听(同一网络里的手机、别的电脑能打开)。后端仍只听 127.0.0.1:
页面里的 /api 由前端开发服务器在本机转发,局域网里的设备不需要、也不该直连后端。
注意:AgentLab 没有登录,同一网络里打得开页面的人都能用它——跑工作流、花你配的
模型额度、读数据源、执行沙箱代码。只在信得过的网络里开。
--host 前端也在局域网上监听(同一网络里的手机、别的电脑能打开)。后端仍只听 127.0.0.1:
页面里的 /api 由前端开发服务器在本机转发,局域网里的设备不需要、也不该直连后端。
注意:AgentLab 没有登录,同一网络里打得开页面的人都能用它——跑工作流、花你配的
模型额度、读数据源、执行沙箱代码。只在信得过的网络里开。
--postgres 应用库用 PostgreSQL:起(已经有就复用)一个本地开发用的 PostgreSQL 容器,端口只开在 127.0.0.1,
后端照它设 AGENTLAB_DATABASE_URL。密码第一次自动生成,在 data/.postgres-dev/ 里;库的数据在 docker
数据卷里,Ctrl-C 只停前后端,库的容器留着下次复用(不要了:docker rm -f 容器名 && docker volume rm 卷名)。
不加就和原来一样:SQLite,不用 docker。下面几个环境变量可以改缺省:
AGENTLAB_DEV_PG_CONTAINER 容器名,缺省 agentlab-dev-postgres
AGENTLAB_DEV_PG_PORT 本机端口,缺省 55432
AGENTLAB_DEV_PG_VOLUME 数据卷,缺省 agentlab-dev-pgdata
AGENTLAB_DEV_PG_IMAGE 镜像,缺省 postgres:16
USAGE
}
# 参数先认完再干活:以前不读参数,--host 这类写了也被悄悄忽略
WEB_ARGS=()
WITH_PG=""
for arg in "$@"; do
case "$arg" in
--host) WEB_ARGS+=(--host) ;;
--postgres) WITH_PG=1 ;;
-h|--help) usage; exit 0 ;;
*) echo "认不出的参数:$arg"; echo; usage; exit 2 ;;
esac
@@ -43,6 +53,7 @@ PY_BIN="$(conda run -n "$CONDA_ENV" python -c 'import sys; print(sys.executable)
echo "==> 后端解释器 $PY_BIN"
[ -d "$ROOT/frontend/node_modules" ] || (cd "$ROOT/frontend" && pnpm install)
# 端口被别人占着就往后挪。踩过一次坑:8000 被另一个项目占住时,uvicorn
# 起不来直接退出,而下面的健康检查去探 8000 又被那个项目答应了,脚本以为
# 后端就绪、继续起前端——于是前端连着别人的服务,界面显示的全是陈年旧数据。
@@ -60,6 +71,51 @@ fi
# 前端代理要跟着后端端口走,否则请求会打到占端口的那个服务上
export AGENTLAB_PORT="$API_PORT"
# ---- --postgres:本地开发用的 PostgreSQL ----
if [ -n "$WITH_PG" ]; then
PG_CONTAINER="${AGENTLAB_DEV_PG_CONTAINER:-agentlab-dev-postgres}"
PG_PORT="${AGENTLAB_DEV_PG_PORT:-55432}"
PG_VOLUME="${AGENTLAB_DEV_PG_VOLUME:-agentlab-dev-pgdata}"
PG_IMAGE="${AGENTLAB_DEV_PG_IMAGE:-postgres:16}"
DEV_DATA="${AGENTLAB_DATA_DIR:-$ROOT/data}"
case "$PG_PORT" in ''|*[!0-9]*) echo "AGENTLAB_DEV_PG_PORT 要是端口号:$PG_PORT"; exit 2 ;; esac
command -v docker >/dev/null || { echo "--postgres 要用 docker,没找到它"; exit 1; }
docker version --format '{{.Server.Version}}' >/dev/null 2>&1 || { echo "连不上 docker 服务,先把 Docker 启动起来"; exit 1; }
# 密码:第一次生成(0600),之后沿用;pgpass 给后端连库用(PGPASSFILE),密码不进命令行和环境变量
(cd "$ROOT/backend" && "$PY_BIN" -m app.ops postgres-secrets --data "$DEV_DATA" --dir .postgres-dev \
--host 127.0.0.1 --port "$PG_PORT") >/dev/null
if docker container inspect "$PG_CONTAINER" >/dev/null 2>&1; then
role="$(docker inspect -f '{{index .Config.Labels "agentlab.role"}}' "$PG_CONTAINER")"
[ "$role" = dev-postgres ] || { echo "已经有一个叫 $PG_CONTAINER 的容器,不是这个脚本起的。换个名字:AGENTLAB_DEV_PG_CONTAINER=…"; exit 1; }
published="$(docker inspect -f '{{range $p, $b := .HostConfig.PortBindings}}{{range $b}}{{.HostPort}}{{end}}{{end}}' "$PG_CONTAINER")"
[ "$published" = "$PG_PORT" ] || { echo "容器 $PG_CONTAINER 开的是本机端口 ${published},不是 ${PG_PORT}:AGENTLAB_DEV_PG_PORT=$published 再来,或者删掉容器重建"; exit 1; }
if [ "$(docker inspect -f '{{.State.Running}}' "$PG_CONTAINER")" != true ]; then
echo "==> 启动开发用的 PostgreSQL(${PG_CONTAINER})"
docker start "$PG_CONTAINER" >/dev/null
else
echo "==> 复用开发用的 PostgreSQL(${PG_CONTAINER})"
fi
else
port_taken "$PG_PORT" && { echo "端口 $PG_PORT 已被占用:换一个 AGENTLAB_DEV_PG_PORT=…"; exit 1; }
echo "==> 起开发用的 PostgreSQL(${PG_CONTAINER},${PG_IMAGE},127.0.0.1:${PG_PORT},数据卷 ${PG_VOLUME})"
docker run -d --name "$PG_CONTAINER" --label agentlab.role=dev-postgres \
-e POSTGRES_USER=agentlab -e POSTGRES_DB=agentlab -e POSTGRES_PASSWORD_FILE=/run/agentlab/password \
-v "$PG_VOLUME:/var/lib/postgresql/data" -v "$DEV_DATA/.postgres-dev/password:/run/agentlab/password:ro" \
-p "127.0.0.1:$PG_PORT:5432" "$PG_IMAGE" >/dev/null
fi
# 走 TCP 问:第一次初始化时临时起的那个只听本地套接字,问得通才是正式起好了
ready=""
for _ in $(seq 1 60); do
if docker exec "$PG_CONTAINER" pg_isready -q -h 127.0.0.1 -U agentlab -d agentlab 2>/dev/null; then ready=1; break; fi
[ "$(docker inspect -f '{{.State.Running}}' "$PG_CONTAINER" 2>/dev/null)" = true ] || break
sleep 1
done
[ -n "$ready" ] || { docker logs --tail 30 "$PG_CONTAINER" 2>&1 || true; echo "开发用的 PostgreSQL 没起来,见上面的日志"; exit 1; }
export AGENTLAB_DATABASE_URL="postgresql+asyncpg://agentlab@127.0.0.1:$PG_PORT/agentlab"
export PGPASSFILE="$DEV_DATA/.postgres-dev/pgpass"
echo "==> 应用库 PostgreSQL 127.0.0.1:$PG_PORT/agentlab(容器 ${PG_CONTAINER})"
fi
cleanup() {
echo
echo "==> 停止"