144 lines
3.1 KiB
Markdown
144 lines
3.1 KiB
Markdown
# 網絡配置說明
|
||
|
||
## 🐳 Docker 容器訪問主機服務
|
||
|
||
當 API 服務器在主機上運行，而 k6 測試在 Docker 容器內運行時，需要配置網絡讓容器能夠訪問主機上的服務。
|
||
|
||
## ✅ 已配置的解決方案
|
||
|
||
本測試架構已經配置為使用**主機網絡模式**（`--network host`），容器可以直接訪問主機上的服務。
|
||
|
||
### 配置說明
|
||
|
||
1. **Makefile**：所有 `docker run` 命令都添加了 `--network host` 參數
|
||
2. **docker-compose.yml**：k6 服務使用 `network_mode: host`
|
||
|
||
### 使用方式
|
||
|
||
```bash
|
||
# 如果 API 在本地主機運行（localhost）
|
||
export BASE_URL=http://localhost:8888
|
||
# 或
|
||
export BASE_URL=https://localhost:8888
|
||
|
||
# 運行測試
|
||
make smoke-health
|
||
```
|
||
|
||
## 🔧 其他網絡配置選項
|
||
|
||
### 選項 1: 使用 host.docker.internal（僅限 macOS/Windows）
|
||
|
||
在 macOS 和 Windows 上，Docker Desktop 提供了 `host.docker.internal` 主機名：
|
||
|
||
```bash
|
||
export BASE_URL=http://host.docker.internal:8888
|
||
make smoke-health
|
||
```
|
||
|
||
**注意**：在 Linux 上，`host.docker.internal` 默認不可用，需要額外配置。
|
||
|
||
### 選項 2: 使用主機 IP 地址
|
||
|
||
如果知道主機的 IP 地址，可以直接使用：
|
||
|
||
```bash
|
||
# 獲取主機 IP 地址
|
||
ip addr show | grep "inet " | grep -v 127.0.0.1
|
||
|
||
# 使用主機 IP
|
||
export BASE_URL=http://192.168.1.100:8888
|
||
make smoke-health
|
||
```
|
||
|
||
### 選項 3: 使用 Docker 網絡（如果 API 也在容器中）
|
||
|
||
如果 API 服務器也在 Docker 容器中運行，可以使用 Docker 網絡：
|
||
|
||
```yaml
|
||
# docker-compose.yml
|
||
services:
|
||
api:
|
||
# ... API 配置
|
||
|
||
k6:
|
||
# ... k6 配置
|
||
networks:
|
||
- test-network
|
||
extra_hosts:
|
||
- "host.docker.internal:host-gateway"
|
||
```
|
||
|
||
## 📝 常見問題
|
||
|
||
### Q: 為什麼使用 `--network host`？
|
||
|
||
A: `--network host` 是最簡單可靠的方式，讓容器直接使用主機網絡，可以訪問 `localhost` 和主機上的所有端口。
|
||
|
||
### Q: 使用 `--network host` 有什麼限制？
|
||
|
||
A:
|
||
- 容器無法使用端口映射（因為直接使用主機端口）
|
||
- 在 macOS/Windows 上，`--network host` 可能不工作（需要使用 `host.docker.internal`）
|
||
|
||
### Q: 如何測試連接？
|
||
|
||
A: 在容器內測試連接：
|
||
|
||
```bash
|
||
# 進入容器
|
||
docker run -it --rm --network host grafana/k6:latest sh
|
||
|
||
# 在容器內測試連接
|
||
curl http://localhost:8888/api/v1/health
|
||
```
|
||
|
||
### Q: HTTPS 證書問題？
|
||
|
||
A: 如果使用 HTTPS 但沒有有效證書，可以設置：
|
||
|
||
```bash
|
||
export K6_SKIP_TLS_VERIFY=true
|
||
make smoke-health
|
||
```
|
||
|
||
或在測試文件中設置：
|
||
|
||
```javascript
|
||
export const options = {
|
||
// ...
|
||
insecureSkipTLSVerify: true,
|
||
};
|
||
```
|
||
|
||
## 🚀 快速測試
|
||
|
||
### 測試本地 API
|
||
|
||
```bash
|
||
# 1. 確認 API 在本地運行
|
||
curl http://localhost:8888/api/v1/health
|
||
|
||
# 2. 設置 BASE_URL
|
||
export BASE_URL=http://localhost:8888
|
||
|
||
# 3. 運行測試
|
||
make smoke-health
|
||
```
|
||
|
||
### 測試遠程 API
|
||
|
||
```bash
|
||
# 1. 設置遠程 API 地址
|
||
export BASE_URL=https://api.example.com
|
||
|
||
# 2. 運行測試
|
||
make smoke-health
|
||
```
|
||
|
||
## 📚 參考資源
|
||
|
||
- [Docker 網絡文檔](https://docs.docker.com/network/)
|
||
- [k6 網絡配置](https://k6.io/docs/using-k6/options/#insecureskiptlsverify)
|
||
|