DevOps + AI Flow 一键模板

本模板包含以下模块：

• 统一入口与路由：Traefik（仅 80/443 暴露）
• 代码与 CI/CD：Gitea + Act Runner（可换 Woodpecker）
• 本地镜像仓库与代理：Docker Registry +（可选）Harbor Proxy
• 依赖缓存：Apt-Cacher-NG、Verdaccio(NPM)、Devpi(PyPI)
• AI 网关与可视化：LiteLLM、Langfuse、MLflow、Ollama/MinIO/Redis
• 可观测性：Prometheus / Loki / Tempo / Grafana / Promtail
• 任务编排与可视化：Prefect 2.x（Server + Agent）

原则：只有 Traefik 占用 80/443，其他服务不直接映射端口，统一通过域名路由（例如：grafana.dev.lan、git.dev.lan）。

📚 文档

• 实施计划 - 详细的分阶段实施指南与检查清单
• 实施指南 - 快速操作手册
• 优化蓝皮书 - DevOps优化建议

快速开始

1. 安装 Docker 与 Docker Compose。Mac 可用 Orbstack。
2. 本机解析配置：将 *.dev.lan 解析到 127.0.0.1（可用 dnsmasq 或本地 hosts 临时添加）。
3. 证书（本地开发）：执行 infra/scripts/mkcert-init.sh 生成 *.dev.lan 本地信任证书。
4. 启动基础栈：

   docker compose -f infra/compose/core.yml up -d
   docker compose -f infra/compose/dev-cache.yml up -d
   docker compose -f infra/compose/observability.yml up -d
   docker compose -f infra/compose/ai.yml up -d
   docker compose -f infra/compose/ai-visual.yml up -d
   docker compose -f infra/compose/taskflow.yml up -d
   

5. 访问：
   • Traefik: https://traefik.dev.lan
   • Gitea: https://git.dev.lan
   • Registry(无UI): https://reg.dev.lan
   • Grafana: https://grafana.dev.lan
   • MLflow: https://mlflow.dev.lan
   • Langfuse: https://langfuse.dev.lan
   • Prefect: https://prefect.dev.lan
   • MinIO 控制台: https://minio.dev.lan
   • LiteLLM API: https://ai.dev.lan/v1

目录结构

infra/
  compose/               # 分栈 compose 文件
  traefik/
  registry/
  observability/
  scripts/
secrets/                 # .env 模板（请自行填写并用 sops/age 加密）
grafana-dashboards/      # 预置仪表盘 JSON
ai/                      # prompts / evals 示例目录

环境变量

• 将 secrets/.env.core.example 复制为 secrets/.env.core 并填写。其他同理。
• 推荐采用 sops + age 对 .env.* 做静态加密，CI/CD 侧解密后使用。

多架构镜像

• infra/buildx/docker-bake.hcl 提供多架构构建模板。
• 首次运行 infra/scripts/buildx-setup.sh 初始化 builder。

告警与集成

• Grafana/Prometheus 可配置 Slack/Webhook 告警。
• Prefect / Langfuse 也支持 Webhook/Slack 集成。

本模板为最小可用版，建议按需修改。生产环境请加固安全策略与备份策略。