93 lines
2.1 KiB
Markdown
93 lines
2.1 KiB
Markdown
# WebMail Gateway 快速開發指南
|
||
|
||
## 開發環境設定 (最簡單方式)
|
||
|
||
### 第一步：停止正式環境
|
||
|
||
```bash
|
||
ssh porsche@10.1.0.254 'cd /home/porsche/services/webmail-gateway && docker compose down'
|
||
```
|
||
|
||
### 第二步：在開發機啟動服務
|
||
|
||
```batch
|
||
cd D:\_Develop\porscheworld_develop\webmail-gateway
|
||
START_DEVELOPMENT.bat
|
||
```
|
||
|
||
服務會在 `http://10.1.0.245:8100` 啟動
|
||
|
||
### 第三步：測試訪問
|
||
|
||
**方式 A: 直接訪問開發機 (推薦)**
|
||
- ✅ http://10.1.0.245:8100/vmis-admin
|
||
- ✅ http://10.1.0.245:8100/porsche1
|
||
|
||
**方式 B: 透過 SSH 隧道**
|
||
```bash
|
||
# 在本機執行
|
||
ssh -L 8100:10.1.0.245:8100 porsche@10.1.0.254
|
||
|
||
# 然後訪問
|
||
# http://localhost:8100/vmis-admin
|
||
```
|
||
|
||
**方式 C: 修改 hosts 檔案 (如果需要 HTTPS)**
|
||
```
|
||
# Windows: C:\Windows\System32\drivers\etc\hosts
|
||
10.1.0.245 webmail.lab.taipei
|
||
```
|
||
然後訪問: http://webmail.lab.taipei:8100/vmis-admin
|
||
|
||
---
|
||
|
||
## 開發完成後：部署到正式環境
|
||
|
||
### 快速部署
|
||
|
||
```bash
|
||
# 1. 上傳修改的檔案
|
||
scp app.py porsche@10.1.0.254:/home/porsche/services/webmail-gateway/
|
||
|
||
# 2. 重啟正式環境
|
||
ssh porsche@10.1.0.254 'cd /home/porsche/services/webmail-gateway && docker compose down && docker compose build && docker compose up -d'
|
||
```
|
||
|
||
### 透過 Git 部署 (建立 Gitea 倉庫後)
|
||
|
||
```bash
|
||
# 1. 提交變更
|
||
git add .
|
||
git commit -m "Feature: 完整 UI 功能"
|
||
git push gitea main
|
||
|
||
# 2. 伺服器拉取
|
||
ssh porsche@10.1.0.254
|
||
cd /home/porsche/services/webmail-gateway
|
||
git pull
|
||
docker compose down && docker compose build && docker compose up -d
|
||
```
|
||
|
||
---
|
||
|
||
## 重要注意事項
|
||
|
||
⚠️ **Keycloak Redirect URI**
|
||
|
||
開發時如果使用不同的 URL，需要更新 Keycloak client 的 Redirect URI：
|
||
|
||
```
|
||
正式環境: https://webmail.lab.taipei/{tenant_code}/callback
|
||
開發環境: http://10.1.0.245:8100/{tenant_code}/callback
|
||
```
|
||
|
||
可以同時設定兩個 URI，這樣開發和正式環境都能用。
|
||
|
||
⚠️ **Redis 和 Database**
|
||
|
||
開發環境會直接連接正式環境的 Redis (10.1.0.20) 和 PostgreSQL (10.1.0.20)，請小心操作。
|
||
|
||
⚠️ **Session 衝突**
|
||
|
||
如果同時有人在使用正式環境，Session 可能會衝突。建議開發時使用測試帳號。
|