From bf744236514ec3a9a5a3a82652865accd1c44284 Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Mon, 19 Oct 2026 13:43:33 +0800 Subject: [PATCH] =?UTF-8?q?dev.sh=20=E5=8A=A0=20--postgres=EF=BC=9A?= =?UTF-8?q?=E8=B5=B7=EF=BC=88=E5=B7=B2=E7=BB=8F=E6=9C=89=E5=B0=B1=E5=A4=8D?= =?UTF-8?q?=E7=94=A8=E3=80=81=E5=81=9C=E7=9D=80=E5=B0=B1=E8=B5=B7=EF=BC=89?= =?UTF-8?q?=E4=B8=80=E4=B8=AA=E6=9C=AC=E5=9C=B0=E5=BC=80=E5=8F=91=E7=94=A8?= =?UTF-8?q?=E7=9A=84=20PostgreSQL=20=E5=AE=B9=E5=99=A8=EF=BC=8C=E7=AB=AF?= =?UTF-8?q?=E5=8F=A3=E5=8F=AA=E5=BC=80=E5=9C=A8=20127.0.0.1=EF=BC=88?= =?UTF-8?q?=E7=BC=BA=E7=9C=81=2055432=EF=BC=89=EF=BC=8C=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E5=9C=A8=20docker=20=E6=95=B0=E6=8D=AE=E5=8D=B7=EF=BC=8C?= =?UTF-8?q?=E5=AF=86=E7=A0=81=E7=AC=AC=E4=B8=80=E6=AC=A1=E8=87=AA=E5=8A=A8?= =?UTF-8?q?=E7=94=9F=E6=88=90=E5=9C=A8=E6=95=B0=E6=8D=AE=E7=9B=AE=E5=BD=95?= =?UTF-8?q?=E7=9A=84=20.postgres-dev/=20=E9=87=8C=EF=BC=8C=E5=90=8E?= =?UTF-8?q?=E7=AB=AF=E6=8C=89=20PGPASSFILE=20=E8=AF=BB=E3=80=81=E7=85=A7?= =?UTF-8?q?=E5=AE=83=E8=AE=BE=20AGENTLAB=5FDATABASE=5FURL=EF=BC=9B?= =?UTF-8?q?=E5=AE=B9=E5=99=A8=E5=90=8D=E3=80=81=E7=AB=AF=E5=8F=A3=E3=80=81?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=8D=B7=E3=80=81=E9=95=9C=E5=83=8F=E5=8F=AF?= =?UTF-8?q?=E7=94=A8=20AGENTLAB=5FDEV=5FPG=5F*=20=E6=94=B9=EF=BC=8C?= =?UTF-8?q?=E5=90=8C=E5=90=8D=E5=AE=B9=E5=99=A8=E4=B8=8D=E6=98=AF=E8=BF=99?= =?UTF-8?q?=E4=B8=AA=E8=84=9A=E6=9C=AC=E8=B5=B7=E7=9A=84=E3=80=81=E7=AB=AF?= =?UTF-8?q?=E5=8F=A3=E5=92=8C=E5=B7=B2=E6=9C=89=E5=AE=B9=E5=99=A8=E7=9A=84?= =?UTF-8?q?=E4=B8=8D=E4=B8=80=E8=87=B4=E9=83=BD=E7=85=A7=E5=AE=9E=E6=8A=A5?= =?UTF-8?q?=E9=94=99=E3=80=82=E4=B8=8D=E5=8A=A0=E5=B0=B1=E5=92=8C=E5=8E=9F?= =?UTF-8?q?=E6=9D=A5=E4=B8=80=E6=A0=B7=EF=BC=9ASQLite=EF=BC=8C=E4=B8=8D?= =?UTF-8?q?=E7=94=A8=20docker?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/dev.sh | 66 ++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 61 insertions(+), 5 deletions(-) diff --git a/scripts/dev.sh b/scripts/dev.sh index 28fd4b99..9abd6e16 100755 --- a/scripts/dev.sh +++ b/scripts/dev.sh @@ -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 "==> 停止"