Dockerized dev
Dockerized dev 标记 Dockerfile、Compose 或 container build 是本地开发、集成验证或部署交付的一等路径。它不表示“仓库里偶然有 Dockerfile”,而是 Docker 影响运行环境、数据卷、端口、build args、嵌入式前端产物或 release artifact。
- 服务
- 运维
目录
Definition
Dockerized dev 标记 Dockerfile、Compose 或 container build 是本地开发、集成验证或部署交付的一等路径。它不表示“仓库里偶然有 Dockerfile”,而是 Docker 影响运行环境、数据卷、端口、build args、嵌入式前端产物或 release artifact。
这个 Topic 的判断重点是容器是否承载了可维护的运行真相:基础镜像、multi-stage build、前端 asset 注入、SQLite volume、env var、healthcheck、Compose service 名和 release artifact 都会影响后续 Agent 如何验证项目。若 Dockerfile 没有被 README、scripts、workflow 或部署文档消费,只能算待复核证据(projects/codex-vibe-monitor.md、projects/proxy-broker.md)。
When to use
当 Docker/Compose 是 README、scripts、CI、deploy 或 release workflow 的显式部分时使用。若 Dockerfile 只是旧实验文件、没有脚本/CI/deploy 证据,应先复核。
当项目需要稳定复现 runtime、隔离系统依赖、发布单镜像服务、在 Compose 中固定 DB/volume,或把 Web bundle 嵌进后端 binary/runtime 时,应命中本 Topic。单纯为了本地临时调试而留下的 Dockerfile 不够;必须能说明它在交付或验证链路中承担什么职责(projects/blog-26.md、projects/tavily-hikari.md)。
Habits / defaults
- Rust + React 服务常见两阶段构建:Bun/Vite 先构建
web/dist,Rust stage 再 embed 或复制静态资产;projects/codex-vibe-monitor.md、projects/proxy-broker.md、projects/xp.md都是这种形态。 - Compose 中的端口、env 和 volume 是项目记忆;
projects/tavily-hikari.md保留PROXY_PORT、PROXY_DB_PATH和 data volume,projects/blog-26.md保留/app/data/sqlite.db。 - 不要把容器默认端口当作 Codex 预览端口;交付 localhost 前仍要走全局端口租约。
- Docker build gate 要同时验证前端资产和后端 binary,尤其是 embedded admin UI 服务。
- 项目摘要应记录容器数据路径和 env var,而不是只写“支持 Docker”。SQLite、uploads、cache 或 API key 路径一旦漏记,迁移部署时最容易丢状态(
projects/blog-26.md、projects/tavily-hikari.md)。 - 对 Rust/React 服务,Dockerfile 的 base image、Bun/Rust 版本和 build args 是兼容性证据;遇到 glibc、OpenSSL 或静态资产问题时优先回读 Dockerfile,而不是只看 Cargo/npm manifest(
projects/codex-vibe-monitor.md)。 - 当 Compose 同时承载 Prometheus/Grafana/Tempo 等观测组件时,把 monitoring network、target service alias、named volume、只读 provisioning 和 host exposure 一起当作部署合同审查;不因为“只是监控”就跳过网络隔离和凭据边界(
projects/codex-vibe-monitor.md、skills/style-playbook/references/topics/monitoring-dashboard/TOPIC.md)。 - 观测 Compose 的验证应覆盖服务能否 provision、target 是否 fresh、dashboard/alert query 是否有正确样本,以及观测组件停止时业务服务是否仍可用;
docker compose up成功不等于整条观测链路有效(projects/codex-vibe-monitor.md)。 - Compose 只表达编排和隔离,不替目标项目决定 metrics retention、trace window、sampling、容量或性能预算;这些参数必须由项目自己的证据和验收合同拥有。
Reference implementations
projects/blog-26.md:多 runtime 博客平台,Docker 数据路径和 build split 是交付 contract。projects/dockrev.md:Docker/Compose update manager 本身以 Docker delivery 为核心。projects/tavily-hikari.md:Compose 直接表达 MCP proxy 运行环境和 SQLite volume。projects/codex-vibe-monitor.md:Dockerfile 固定 Bun/Rust/Debian 版本并注入APP_EFFECTIVE_VERSION;ops/observability/compose.yml另外展示观测服务的网络、volume、provisioning 和隔离边界,适合检查主服务交付与观测 sidecar 是否一致。projects/xp.md:分布式服务的容器化边界与端口/状态管理更复杂,适合作为“不要只看 Dockerfile 是否存在”的反例式参考。
Failure modes
- 只看到 Dockerfile 就打标签,可能把弃用文件提升成 Topic;要看 README/scripts/CI/deploy 是否引用。
- 容器 build 成功但 web asset 版本未注入,会导致 UI 显示错误版本。
- Compose volume/env 漏记会让 Agent 在迁移部署时丢数据。
- 直接复用 Compose 暴露端口给用户预览,会绕过全局端口租约并可能撞到其他 worktree;owner-facing localhost 必须由当前工作区服务会话持有(
projects/style-playbook-skills.md)。 - 在容器里重新生成前端资产但没有把 build/version/env 注入记录到项目快照,会让站点显示与 release tag 不一致;需要把 Docker build args、web script 和 release workflow 一起审查(
projects/codex-vibe-monitor.md)。 - 把 Prometheus、Grafana 或 Tempo 的 host port、secret mount、volume 和 network 成员资格复制到另一个项目,可能造成暴露面或状态边界错误;迁移时只复用结构,重新审查 bind、身份、容量和通知策略(
projects/codex-vibe-monitor.md、skills/style-playbook/references/topics/monitoring-dashboard/TOPIC.md)。 - 只验证 Compose 服务启动,不验证 exporter scrape、freshness、dashboard provisioning 或业务降级语义,会把“容器健康”误报成“观测可用”;应使用项目自己的工具和 synthetic/acceptance 验证补齐证据(
projects/codex-vibe-monitor.md)。
Evidence index
projects/blog-26.mdprojects/dockrev.mdprojects/tavily-hikari.mdprojects/xp.mdprojects/codex-vibe-monitor.mdops/observability/compose.ymlops/observability/prometheus.ymlops/observability/grafana/provisioning/skills/style-playbook/references/data/topic-candidates.json
相关内容
Ivan's Blog 2026
项目实践Ivan's Blog 2026 是 Ivan 博客平台的公开开源镜像,由 Astro public site、Vite/React admin SPA 和 Bun gateway/API 组成。README.md、astro.config.mjs、apps/admin/、src/server/ 和 package.
Codex Vibe Monitor
项目实践Codex Vibe Monitor 是面向自部署的 OpenAI 兼容代理观测工作台:它接入 /v1/* HTTP / WebSocket 流量,将调用留证、实时 SSE、历史统计、请求排障、上游账号池、forward proxy、价格目录和 SQLite 持久化收在同一套运营界面中。
Dockrev
项目实践Dockrev 是 self-hosted Docker/Compose update manager。README.md 把根文档定位为快速入口,完整部署、使用、运维、排障和 API 文档在 docs-site/,这说明它是运维工具而不是普通 CRUD 管理台。
mineru-remote-mcp
项目实践Remote (HTTP) MCP server that fronts MinerU’s document-to-Markdown pipeline, with a companion web console. Evidence: README.md, Cargo.toml, web/.
OctoRill
项目实践OctoRill 把与 Ivan 相关的 GitHub 动态整理成适合持续阅读的工作区:发布更新、获星/关注动态、日报和 Inbox,发布内容还支持中文翻译和要点整理。README.md 同时指向 public docs-site、quick start、config、product 和 internal docs,说明它是产品化 Rust 服务 + React UI + 文档站,而不是一次性脚本。
pod-upgrade-trigger
项目实践Small Rust HTTP service that validates GitHub package events, enforces rate limits, refreshes Podman images, and restarts systemd units; ships a Web UI (embedded bundle) and CLI subcommands for ops tasks.
pod-upgrade-trigger-bak
项目实践Backup/variant of pod-upgrade-trigger with the same overall shape: Rust HTTP service + embedded web UI + ops-focused CLI and state directory. Evidence: Cargo.toml, README.md, web/.
Proxy Broker
项目实践Proxy Broker 是 standalone Rust service,用于加载 mihomo subscriptions,按 IP 构建带 probe/geo metadata 的代理池,按选择的 IP 开关本地 proxy listener sessions,并从同一 binary 提供 Bun-built operator web console。README.
Style Playbook Skills
项目实践Style Playbook Skills 是 Ivan style playbook 的 source-of-truth 仓库:它保存人工维护的 project snapshots、Topic packages、六个 global group Skills,以及用于浏览、筛选和触发生成任务的本地 library site。
Tavily Hikari
项目实践Tavily Hikari 是 Rust + Axum proxy,用于 Tavily MCP endpoint:它复用多 API key、匿名化上游请求、把完整 audit logs 写入 SQLite,并附带 React + Vite web console 做实时可视化。README.md 与 README.zh-CN.md 说明这个项目同时服务英文/中文维护入口。
ups120-daemon
项目实践Rust daemon/service around the UPS120 device, with a plan doc and install helper; appears to include DB migration tooling. Evidence: README.md, Cargo.toml, PLAN.md, alembic/.
XP Cluster Manager
项目实践XP Cluster Manager 是 self-hosted multi-host Xray cluster manager。README.md 明确每台 host 运行 xp 和 xray 两个进程,xp 用 OpenRaft 保存 cluster-wide desired state,并通过 Xray gRPC API reconcile 本地 runtime。