系列目录 · 第 01 篇 · 部署与更新
本地已经运行原 Artex 时,新项目最先要解决的是共存:端口、数据库、卷和登录状态都需要核对。只换一个访问端口,隔离工作还没有结束。
这一篇记录 CodeScan-Artex 的本地部署方式。命令以 PowerShell 7 和 Docker Desktop 的 Linux 容器模式为例,示例路径需要替换成自己的源码位置。
0x01 先确认拿到的是哪份程序
本地配置使用上游运行镜像提供基础环境,再把当前工作树构建出来的后端、审计工具和内嵌前端放进去。
这意味着,直接拉取上游镜像,不能据此认定已经得到本系列全部改造。部署前需要取得包含对应修改的源码,并核对 dist/local/build-manifest.json 中的版本与摘要。
主要文件如下:
| 文件 | 职责 |
|---|---|
deploy-local.ps1 |
检查环境、选择端口、生成本机配置、构建与启动 |
compose.local.yml |
独立应用、PostgreSQL、网络和数据卷 |
Dockerfile.local-runtime |
把当前构建产物放入运行镜像 |
dist/local/build-manifest.json |
记录构建版本及程序摘要 |
0x02 首次部署
先准备 Docker Compose、Go 和 Node.js/npm。Go 版本以工作树里的 go.mod 为准;前端依赖按锁文件安装。
1 | Set-Location -LiteralPath 'D:\projects\code-audit\CodeScan-Artex' |
本地约定使用 codescan-artex-local 作为 Compose 项目名,对外只绑定 127.0.0.1:17878。原实例使用的 8787 保留。
要改成另一个空闲端口,可以显式传入 -Port 17879。显式端口被占用时应先处理冲突,避免把别的服务误认为本次部署结果。
脚本生成的 .env.local 属于本机私有配置,保存数据库口令和本地执行记录签名密钥。文章不提供固定口令,也不把实际配置文件放进示例。
0x03 启动后核对什么
1 | docker compose --project-name codescan-artex-local --env-file .env.local -f compose.local.yml ps |
浏览器打开 http://127.0.0.1:17878,完成管理员设置,再配置模型服务。一次验收至少需要回答:
- 应用与数据库是否就绪,访问到的版本是否对应本次构建?
- 前端是否为真实后端模式,静态文件是否能正常加载?
- 应用和数据库分别挂载了哪些卷?
- 原实例的容器标识、端口和卷是否保持预期?
主进程健康只说明服务可响应。模型可用性和一次完整审计,需要后续分别验证。
0x04 模型地址要从容器视角理解
模型服务运行在 Windows 主机上时,容器内的 127.0.0.1 指向容器自己。开发环境可以使用下列地址形式:
1 | http://host.docker.internal:8000/v1 |
这里的端口和模型名称都是示例,应替换成实际服务配置。还需要确认协议格式、鉴权、模型标识、上下文窗口和输出上限。
连接测试成功只能证明一条最小调用路径可用。长上下文排队、流式响应和工具调用,应在后续测试中逐项核对。
0x05 已有实例更新,要先保护状态
首次部署和带数据更新的检查重点不同。已有任务时,我先记录容器、卷、任务状态及模型配置,再备份数据库、现有构建产物和登录签名密钥。
本次环境中特别需要注意 /app/jwt.key:它位于应用容器文件系统,不能仅凭业务数据卷还在,就认定重建后登录也会保留。
可以先导出密钥到受控的本地备份目录:
1 | docker cp codescan-artex-local-app-1:/app/jwt.key .\data\maintenance\jwt.key |
执行前先创建备份目录;密钥应按私有文件保护。真正替换应用时,还要保存它原有的权限与归属,在新容器启动前恢复,并核对摘要。数据库备份则应使用与当前版本匹配的 pg_dump 流程,核验导出结果。
更新计划通常只需要重建本项目的应用容器。数据库容器、状态卷及其他项目都不应顺手重建。对于暂停或失败的任务,也应保留原状态,避免升级顺带恢复模型请求。
0x06 这一篇的验收边界
本系列后续的部署记录会给出各轮版本和测试范围。部署方法本身不证明审计能力,也不能替代一次恢复演练。
源码入口是 deploy-local.ps1、compose.local.yml、Dockerfile.local-runtime 和 server/auth.go。常规更新前还应核对这些文件有没有变化,尤其是密钥路径、卷挂载和构建方式。
