|
| 1 | +# Docker 部署测试指南 |
| 2 | + |
| 3 | +## 当前状态 |
| 4 | +❌ Docker Desktop 未找到或未安装 |
| 5 | + |
| 6 | +## 安装步骤 |
| 7 | + |
| 8 | +### 1. 安装 Docker Desktop for Mac |
| 9 | + |
| 10 | +请按照以下步骤安装 Docker Desktop: |
| 11 | + |
| 12 | +1. 访问 Docker 官网下载页面: |
| 13 | + - Apple Silicon (M1/M2/M3): https://desktop.docker.com/mac/main/arm64/Docker.dmg |
| 14 | + - Intel 芯片: https://desktop.docker.com/mac/main/amd64/Docker.dmg |
| 15 | + |
| 16 | +2. 下载后双击 `.dmg` 文件 |
| 17 | + |
| 18 | +3. 将 Docker 图标拖到 Applications 文件夹 |
| 19 | + |
| 20 | +4. 从 Applications 文件夹启动 Docker Desktop |
| 21 | + |
| 22 | +5. 首次启动需要授权并等待 Docker 引擎启动完成 |
| 23 | + |
| 24 | +### 2. 验证 Docker 安装 |
| 25 | + |
| 26 | +安装完成后,在终端运行: |
| 27 | + |
| 28 | +```bash |
| 29 | +# 检查 Docker 版本 |
| 30 | +docker --version |
| 31 | +docker-compose --version |
| 32 | + |
| 33 | +# 检查 Docker 是否运行 |
| 34 | +docker ps |
| 35 | +``` |
| 36 | + |
| 37 | +## 测试计划 |
| 38 | + |
| 39 | +安装完成后,将执行以下测试: |
| 40 | + |
| 41 | +### ✅ 已完成 |
| 42 | +- [x] 检查 Docker 环境 |
| 43 | + |
| 44 | +### 📋 待执行 |
| 45 | +- [ ] 启动 Docker Desktop |
| 46 | +- [ ] 验证 Docker 环境 |
| 47 | +- [ ] 测试 Docker 镜像构建(OpenAI 模式) |
| 48 | +- [ ] 测试 Docker Compose 启动服务 |
| 49 | +- [ ] 验证服务健康状态 |
| 50 | +- [ ] 测试 API 接口 |
| 51 | +- [ ] 清理测试资源 |
| 52 | + |
| 53 | +## 快速测试命令 |
| 54 | + |
| 55 | +安装完成后,执行以下命令进行完整测试: |
| 56 | + |
| 57 | +### 方式1: 使用 Docker Compose (推荐) |
| 58 | + |
| 59 | +```bash |
| 60 | +# 构建并启动 OpenAI 兼容模式 |
| 61 | +docker-compose up -d factory-proxy-openai |
| 62 | + |
| 63 | +# 查看服务状态 |
| 64 | +docker-compose ps |
| 65 | + |
| 66 | +# 查看日志 |
| 67 | +docker-compose logs -f factory-proxy-openai |
| 68 | + |
| 69 | +# 测试健康检查 |
| 70 | +curl http://localhost:8003/v1/health |
| 71 | + |
| 72 | +# 测试 API 文档页面 |
| 73 | +curl http://localhost:8003/ |
| 74 | + |
| 75 | +# 停止服务 |
| 76 | +docker-compose down |
| 77 | +``` |
| 78 | + |
| 79 | +### 方式2: 使用纯 Docker 命令 |
| 80 | + |
| 81 | +```bash |
| 82 | +# 构建镜像 |
| 83 | +docker build --target openai -t factory-proxy-openai . |
| 84 | + |
| 85 | +# 运行容器 |
| 86 | +docker run -d \ |
| 87 | + --name factory-proxy-openai \ |
| 88 | + -p 8003:8003 \ |
| 89 | + -e PORT=8003 \ |
| 90 | + factory-proxy-openai |
| 91 | + |
| 92 | +# 查看容器状态 |
| 93 | +docker ps |
| 94 | + |
| 95 | +# 查看日志 |
| 96 | +docker logs -f factory-proxy-openai |
| 97 | + |
| 98 | +# 测试健康检查 |
| 99 | +curl http://localhost:8003/v1/health |
| 100 | + |
| 101 | +# 停止并删除容器 |
| 102 | +docker stop factory-proxy-openai |
| 103 | +docker rm factory-proxy-openai |
| 104 | + |
| 105 | +# 删除镜像 |
| 106 | +docker rmi factory-proxy-openai |
| 107 | +``` |
| 108 | + |
| 109 | +## 测试 Anthropic 原生模式 |
| 110 | + |
| 111 | +```bash |
| 112 | +# 使用 Docker Compose |
| 113 | +docker-compose up -d factory-proxy-openai-anthropic |
| 114 | + |
| 115 | +# 测试 |
| 116 | +curl http://localhost:8001/health |
| 117 | + |
| 118 | +# 停止 |
| 119 | +docker-compose down |
| 120 | +``` |
| 121 | + |
| 122 | +## 同时测试两种模式 |
| 123 | + |
| 124 | +```bash |
| 125 | +# 启动所有服务 |
| 126 | +docker-compose up -d |
| 127 | + |
| 128 | +# 测试 OpenAI 模式 |
| 129 | +curl http://localhost:8003/v1/health |
| 130 | + |
| 131 | +# 测试 Anthropic 模式 |
| 132 | +curl http://localhost:8001/health |
| 133 | + |
| 134 | +# 查看所有容器 |
| 135 | +docker-compose ps |
| 136 | + |
| 137 | +# 停止所有服务 |
| 138 | +docker-compose down |
| 139 | +``` |
| 140 | + |
| 141 | +## 常见问题 |
| 142 | + |
| 143 | +### 1. Docker 命令未找到 |
| 144 | +确保 Docker Desktop 已启动,可以在 macOS 顶部菜单栏看到 Docker 图标 |
| 145 | + |
| 146 | +### 2. 端口被占用 |
| 147 | +如果端口 8003 或 8001 被占用,可以修改 `docker-compose.yml` 中的端口映射: |
| 148 | +```yaml |
| 149 | +ports: |
| 150 | + - "9003:8003" # 将主机端口改为 9003 |
| 151 | +``` |
| 152 | +
|
| 153 | +### 3. 构建失败 |
| 154 | +检查网络连接,确保可以访问 Go 模块代理和 Docker Hub |
| 155 | +
|
| 156 | +### 4. 容器启动失败 |
| 157 | +查看容器日志: |
| 158 | +```bash |
| 159 | +docker logs factory-proxy-openai |
| 160 | +``` |
| 161 | + |
| 162 | +## 性能测试 |
| 163 | + |
| 164 | +部署成功后,可以进行性能测试: |
| 165 | + |
| 166 | +```bash |
| 167 | +# 使用 Apache Bench (需要安装) |
| 168 | +ab -n 100 -c 10 http://localhost:8003/v1/health |
| 169 | + |
| 170 | +# 或使用 curl 循环测试 |
| 171 | +for i in {1..10}; do |
| 172 | + curl -w "\nTime: %{time_total}s\n" http://localhost:8003/v1/health |
| 173 | +done |
| 174 | +``` |
| 175 | + |
| 176 | +## 下一步 |
| 177 | + |
| 178 | +请先安装 Docker Desktop,然后我可以继续帮您完成自动化测试。 |
0 commit comments