diff --git a/AGENTS.md b/AGENTS.md index 6d83619..3846ec1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -118,6 +118,23 @@ jnpf-k8s/ | `jnpf-k8s/docker-optional/` | 早期「每个服务打一个镜像」方案,§7.1 已列为硬约束「不重打镜像」,零代码引用 | | `other/` | compose 时代的产物源。`datav/` 与 `build/web/datav` 完全重复;4 个 jar 已被 `build/{workflow,report,xxl,tenant}/app.jar` 取代;`config/*.yml` 的有效部分已进 ConfigMap | | `boot/.git` | 见上。154 个 commit 已备份到 `~/.cache/testspace-cleanup-20261015/boot-git-backup`,原目录在回收站 | +| `Dockerfile`(仓库根) | 构建 `jnpf-claude` 开发镜像(ubuntu:24.04 + Claude Code CLI + cloudcli)。对应服务块早已在 compose 里整段注释,全仓库**无任何 `build:` 段**引用它,无容器无镜像,且 §7.1 明令不重打镜像 | + +**根 `docker-compose.yml` 保留,删的是同目录的 `Dockerfile`** —— 两者都在仓库根、都在 compose 时代,但性质相反: + +| | `docker-compose.yml` | `Dockerfile` | +|---|---|---| +| 定义的东西 | **正在跑**的 `jnpf-gitea` / `jnpf-postgres` / `jnpf-redis` | 早已注释掉的 `jnpf-claude` | +| 删了会怎样 | 容器一旦被误删**无法重建**;AGENTS.md §1 那几个复用镜像的出处消失,§7.1「不重打镜像」的约束悬空 | 无影响 | + +⚠️ **`docker-compose.yml` 不能在 testspace/ 下直接 `docker compose up -d`。** 里面挂载全是相对路径 `./persist/...`,而 `persist/` 是 testspace 的**兄弟目录**(`/Users/xs/Desktop/workspace/persist/{gits,postgres}`)。在本目录跑会新建一套空 postgres + gitea,且容器名与现有实例冲突直接起不来。正确姿势: + +```bash +cd /Users/xs/Desktop/workspace && docker compose -f /Users/xs/Desktop/workspace/testspace/docker-compose.yml up -d +# 查现存实例的真实 compose 路径(标签记录的是创建时的位置): +docker inspect jnpf-gitea --format '{{index .Config.Labels "com.docker.compose.project.working_dir"}}' +# → /Users/xs/Desktop/workspace ← 该路径下的 compose 文件已不存在,testspace/ 这份是幸存的副本 +``` --- @@ -959,8 +976,8 @@ xop run --secret SSW_LLM_API_KEY=llm_key -- bash -c ' ## 10. 没做的 / 已知限制 -- **kkFileView 已部署**(`k8s/45-kkfile.yaml`,镜像 `ssw188/kkfile:1.1`),nginx 把 `/FileServer/` 按前缀透传给 `jnpf-kkfile:30090`。裸访问 `/FileServer/` 返回 **404 是正常的** —— kkFileView 的 context-path 就是 `/FileServer`,根路径没有文件可预览。 -- `docker-optional/` 与 `other/` 已于 2026-10-15 删除(理由见 §3「已清理的历史目录」),均在回收站可恢复。 +- **kkFileView 已部署**(`k8s/45-kkfile.yaml`,镜像 `ssw188/kkfile:1.1`),nginx 把 `/FileServer/` 按前缀透传给 `jnpf-kkfile:30090`。裸访问 `/FileServer/` 返回 **404 是正常的** —— kkFileView 的 context-path 就是 `/FileServer`,根路径没有文件可预览。镜像由**用户直接指定**,`docker-compose.yml` 里从头到尾没有 kkfile 的条目(既不是注释状态,是完全没有)。 +- `docker-optional/`、`other/`、根 `Dockerfile` 已于 2026-10-15 删除(理由见 §3「已清理的历史目录」),均在回收站可恢复。根 `docker-compose.yml` **保留** —— 它是本机 Gitea/PG/Redis 三个在跑容器的唯一定义,删了无法重建(详见 §3 那张对照表)。 - 单副本部署,未配 HPA / PDB。测试环境够用。 - 多租户**前后端都已开启并端到端验证通过**:后端 `MultiTenancy: true` + PG schema 隔离(§6.9),前端独立入口 `http://192.168.1.26:30095/`(§6.11)。租户管理 UI 是**独立仓库** `../jnpf/jnpf-web-tenant-vue3`(v7.0.0),不在 monorepo 里 —— `jnpf-web-monorepo-framework/apps/` 下只有 `jnpf-web-apps-main`,所以不能走 monorepo 的 `pnpm build:tenant`。改前端要回那个仓库 build,再 `rsync` 到 `build/tenant-web/` 跑 `01-artifacts.sh`。 - 同事日常用不到租户管理 UI:他们在**主前端**用 `租户号@账号` 或 SSO 登录即可,只有建租户的人需要管理中心。 diff --git a/Dockerfile b/Dockerfile deleted file mode 100644 index fa0afcc..0000000 --- a/Dockerfile +++ /dev/null @@ -1,76 +0,0 @@ -# ============================================================================= -# java + Claude Code 容器镜像(纯运行时,文件通过挂载注入) -# ============================================================================= -# 构建: -# docker build -t jnpf-claude . -# -# 运行: -# docker compose up -d -# docker compose exec jnpf bash -# ============================================================================= -# -# 缓存持久化: node / pnpm / pip 三类下载缓存统一指向 /home/ubuntu/.cache 下, -# 运行时由 compose 挂载 ./persist/cache* 即可跨容器持久化(重装不重复下载)。 -# ============================================================================= -FROM ubuntu:24.04 - -ENV DEBIAN_FRONTEND=noninteractive -ENV TZ=Asia/Shanghai - -# 缓存目录统一根(可挂载持久化) -ENV XDG_CACHE_HOME=/home/ubuntu/.cache -ENV npm_config_cache=/home/ubuntu/.cache/npm -ENV PIP_CACHE_DIR=/home/ubuntu/.cache/pip -ENV PNPM_HOME=/home/ubuntu/.cache/pnpm - -# ------------------------------------------------------------------ -# 安装基础依赖(JDK headless 支持容器内 mvn/javac 持续编译;不装完整 JDK) -# ------------------------------------------------------------------ -RUN apt-get update && apt-get install -y --no-install-recommends \ - curl wget git unzip ca-certificates ncurses-term \ - python3 python3-pip \ - openjdk-21-jdk-headless \ - maven \ - netcat-openbsd \ - && apt-get clean && rm -rf /var/lib/apt/lists/* - -# ------------------------------------------------------------------ -# Node.js 22 -# ------------------------------------------------------------------ -RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \ - && apt-get install -y nodejs \ - && corepack enable \ - && corepack prepare pnpm@latest --activate - -# ------------------------------------------------------------------ -# Claude Code CLI & CloudCLI(装完立刻清 npm 缓存,避免残留膨胀) -# pnpm 也装上,缓存目录已指向 /home/ubuntu/.cache/pnpm -# 注: 本镜像不用 OpenAI Codex,codex 是 cloudcli 的硬依赖,npm 无法 --omit 跳过, -# 故装完后直接删掉嵌套的 @openai 目录(含 197MB codex 原生二进制)以瘦身 -# ------------------------------------------------------------------ -RUN mkdir -p /home/ubuntu/.cache \ - && npm install -g @anthropic-ai/claude-code@2.1.185 @cloudcli-ai/cloudcli@1.34.0 \ - && rm -rf "$(npm root -g)/@cloudcli-ai/cloudcli/node_modules/@openai" \ - && pnpm config set store-dir /home/ubuntu/.cache/pnpm-store \ - && npm cache clean --force - -# pnpm 包仓库 store 固化:pnpm 全局配置是 YAML 文件(/home/ubuntu/.config/pnpm/config.yaml), -# store-dir 必须用 camelCase 键名 storeDir,且仅认该全局 YAML(不读用户级 .npmrc / 环境变量)。 -# 必须写【绝对路径】,不能依赖 HOME —— build 时 HOME=/root 写的配置运行时 HOME=/home/ubuntu 会读不到。 -RUN mkdir -p /home/ubuntu/.config/pnpm \ - && printf 'storeDir: /home/ubuntu/.cache/pnpm-store\n' > /home/ubuntu/.config/pnpm/config.yaml - -# ------------------------------------------------------------------ -# Python 依赖 -# ------------------------------------------------------------------ -RUN pip3 install --no-cache-dir --break-system-packages \ - requests>=2.31.0 cryptography>=42.0.0 - -WORKDIR /home/ubuntu/ccWorkDir - -ENV PYTHONPATH=/home/ubuntu/ccWorkDir -ENV PYTHONUNBUFFERED=1 -ENV HOME=/home/ubuntu - -# 默认启动 cloudcli -ENTRYPOINT ["cloudcli"] diff --git a/docker-compose.yml b/docker-compose.yml index ba2ce38..8f7094e 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1,15 +1,33 @@ # ============================================================================= -# JNPF + AIBridge + Claude Code 一键启动 +# Gitea / PostgreSQL / Redis —— 本机 compose 栈(2026-10-15 订正) # ============================================================================= -# 启动: -# docker compose up -d +# 这个文件曾经是「JNPF + AIBridge + Claude Code 一键启动」的全栈定义。现在: +# - 三个 java 服务(jnpf / workflow / report / xxl)与 nginx 全部服务块已注释, +# 2026-10-15 迁 K8s(见 jnpf-k8s/),**compose 不再跑 JNPF**。 +# - 实际在跑的只有下面 3 个:redis / postgres / gitea。 +# - 与之配套的 Dockerfile(构建 jnpf-claude 开发镜像)已删 —— compose 里已无任何 +# `build:` 段引用它,无容器无镜像,且 §7.1 明令不重打镜像。 # -# 进入容器: -# docker compose exec jnpf bash +# ⚠️ 【不要在本目录直接 `docker compose up -d`】—— 会静默起一套空库 +# 本文件里所有挂载都是相对路径 `./persist/...`,而 persist/ 是 **testspace 的兄弟 +# 目录**,不在本目录内: +# 实际路径 /Users/xs/Desktop/workspace/persist/{gits,postgres} +# 在本目录跑 → 找不到就新建 → 一套没有任何仓库/数据的空 postgres + gitea, +# 且容器名 jnpf-gitea / jnpf-postgres 与现有实例冲突,起不来。 +# 正确姿势(现存三个容器的 compose 标签记录的就是这个路径): +# cd /Users/xs/Desktop/workspace && docker compose -f <本文件> up -d +# # 或直接用现有实例:docker exec jnpf-gitea ... +# 查运行态:docker inspect jnpf-gitea \ +# --format '{{index .Config.Labels "com.docker.compose.project.working_dir"}}' # -# 进入后手动启动服务: -# java -jar /app/boot/jnpf-admin/target/jnpf-admin-6.2.0-RELEASE.jar --server.port=30000 -# claude +# 【为什么留这个文件】2026-10-15 清理时差点删掉,三条理由: +# 1. 它是 jnpf-gitea / jnpf-postgres / jnpf-redis **唯一**的完整定义(镜像全名、 +# 端口、DB 凭据、healthcheck)。删了就无法在容器被误删后重建 Gitea。 +# 2. 注释掉的服务块是 AGENTS.md §1 那几个复用镜像的**出处** +# (ssw188/liberica-openjre-rocky:21、ssw188/nginx:latest)—— K8s 部署全靠 +# 「不重打镜像、复用现成镜像」这条硬约束(§7.1),出处没了这条约束就悬空。 +# 3. gitea 容器创建于 2026-08-19,其 compose 标签指向的 +# /Users/xs/Desktop/workspace/docker-compose.yml **已不存在**,本文件是幸存的副本。 # ============================================================================= services: