docs: 補入 docs/external+guides+memory 目錄至版控
包含: - docs/external/aiops_saas.md - docs/guides/deployment_sop.md / devops_handbook.md / google_drive_setup.md - docs/memory/credentials_passbook.md / history_logs.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
37
docs/guides/deployment_sop.md
Normal file
37
docs/guides/deployment_sop.md
Normal file
@@ -0,0 +1,37 @@
|
||||
# 🚀 EwoooC 部署標準作業程序 (SOP)
|
||||
|
||||
> **版本日期**: 2026-04-18 (依 ADR-008 修訂)
|
||||
> **目標主機**: `ollama@192.168.0.188` (經 `192.168.0.110` 跳板)
|
||||
|
||||
## 🛠️ 開發同步流程
|
||||
由於正式環境使用 Docker Compose + Volume Mount,部署邏輯如下:
|
||||
|
||||
### 1. 本地開發與測試
|
||||
在 Mac 本地完成功能開發,並確認 `./app.py` 執行無誤。
|
||||
|
||||
### 2. 同步程式碼 (SCP)
|
||||
使用 110 作為跳板機,將本地檔案推送至 188 正式目錄:
|
||||
```bash
|
||||
# 同步單一檔案
|
||||
scp -o ProxyJump=wooo@192.168.0.110 app.py ollama@192.168.0.188:/home/ollama/momo-pro/
|
||||
|
||||
# 同步目錄
|
||||
scp -o ProxyJump=wooo@192.168.0.110 -r services/ ollama@192.168.0.188:/home/ollama/momo-pro/
|
||||
```
|
||||
|
||||
### 3. 重啟容器
|
||||
檔案進入掛載目錄後,重啟容器以加載變更:
|
||||
```bash
|
||||
ssh -J wooo@192.168.0.110 ollama@192.168.0.188 "docker restart momo-pro-system"
|
||||
```
|
||||
|
||||
## 🏗️ 重大變更 (Rebuild)
|
||||
若修改了 `Dockerfile` 或新增了 `requirements.txt` 套件:
|
||||
```bash
|
||||
ssh -J wooo@192.168.0.110 ollama@192.168.0.188 "cd /home/ollama/momo-pro && docker compose build momo-app && docker compose up -d momo-app"
|
||||
```
|
||||
|
||||
## 🔍 維運指令
|
||||
- **查看日誌**: `docker logs -f momo-pro-system --tail 100`
|
||||
- **進入資料庫**: `docker exec -it momo-db psql -U momo -d momo_analytics`
|
||||
- **檢查磁碟**: `df -h`
|
||||
56
docs/guides/devops_handbook.md
Normal file
56
docs/guides/devops_handbook.md
Normal file
@@ -0,0 +1,56 @@
|
||||
# EwoooC 運維與自動化手冊 (DevOps Handbook)
|
||||
|
||||
## 🌐 伺服器連線
|
||||
| 環境 | 主機 | 指令 |
|
||||
|---|-|---|
|
||||
| **正式 (EwoooC)** | 192.168.0.188 | `ssh -J wooo@192.168.0.110 ollama@192.168.0.188` |
|
||||
| **周邊 (UAT)** | 192.168.0.110 | `ssh wooo@192.168.0.110` |
|
||||
| **安全 (Kali)** | 192.168.0.112 | `ssh kali@192.168.0.112` |
|
||||
|
||||
---
|
||||
|
||||
## 🐋 Docker & Docker Compose 指令 (188 主機)
|
||||
執行路徑:`/home/ollama/momo-pro`
|
||||
|
||||
### 常用操作
|
||||
- **查看狀態**: `docker ps | grep momo`
|
||||
- **查看日誌**: `docker logs -f momo-pro-system --tail 100`
|
||||
- **重啟主應用**: `docker restart momo-pro-system`
|
||||
- **全面啟動**: `docker compose up -d`
|
||||
- **進入資料庫**: `docker exec -it momo-db psql -U momo`
|
||||
|
||||
### 影像管理
|
||||
- **重建影像**: `docker compose build --no-cache momo-pro-system`
|
||||
- **清理過期資源**: `docker system prune -f`
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Nginx 反向代理 (110 主機)
|
||||
配置路徑:`/etc/nginx/sites-enabled/momo`
|
||||
|
||||
- **重新載入**: `sudo systemctl reload nginx`
|
||||
- **語法檢查**: `sudo nginx -t`
|
||||
|
||||
---
|
||||
|
||||
## 🤖 n8n 工作流程管理 (188 主機)
|
||||
- **進入容器**: `docker exec -it n8n /bin/sh`
|
||||
- **手動執行 Workflow**: `docker exec n8n n8n execute --id=<workflow_id>`
|
||||
- **列出 Workflow**: `docker exec n8n n8n list:workflow`
|
||||
|
||||
---
|
||||
|
||||
## ❄️ K8s 相關指令 (已撤除,備份存檔)
|
||||
- **查看 Pod**: `kubectl get pods -n momo`
|
||||
- **重啟 Deployment**: `kubectl rollout restart deployment/momo-app -n momo`
|
||||
- **查看日誌**: `kubectl logs -f deployment/momo-app -n momo`
|
||||
|
||||
---
|
||||
|
||||
## 🏥 健康檢查與自動修復
|
||||
**監控腳本**: `/home/wooo/scripts/domain-health-monitor.sh` (於 110 執行)
|
||||
**頻率**: 每 5 分鐘
|
||||
- `https://mo.wooo.work/health` -> 200
|
||||
- `https://momo.wooo.work/health` -> 200
|
||||
- `https://monitor.wooo.work/` -> 200
|
||||
- `https://registry.wooo.work/v2/` -> 401
|
||||
32
docs/guides/google_drive_setup.md
Normal file
32
docs/guides/google_drive_setup.md
Normal file
@@ -0,0 +1,32 @@
|
||||
# Google Drive API 設定指南
|
||||
|
||||
## 📋 功能說明
|
||||
系統自動化流程:
|
||||
1. **每 30 分鐘**檢查 Google Drive `當日業績匯入` 資料夾。
|
||||
2. **自動下載** `即時業績_當日.xlsx`。
|
||||
3. **自動匯入** 至資料庫 `daily_sales_snapshot`。
|
||||
4. **歸檔** 原始檔案。
|
||||
|
||||
---
|
||||
|
||||
## 🔑 認證資訊庫
|
||||
| 項目 | 值 |
|
||||
|-----|-----|
|
||||
| Google Cloud 專案名 | `wooo-481204` |
|
||||
| Client ID | `132823079326-h9cvj5eahigm8hp9q0b7t5rk77bhu3gp...` |
|
||||
| 認證帳號 | `owen.tsai@gmail.com` |
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 首次認證步驟
|
||||
若 `config/google_token.pickle` 遺失或過期,執行以下指令:
|
||||
```bash
|
||||
python3 -c "from services.google_drive_service import drive_service; drive_service.authenticate()"
|
||||
```
|
||||
執行後會彈出瀏覽器要求授權。
|
||||
|
||||
---
|
||||
|
||||
## 📁 資料夾結構要求
|
||||
Google Drive 根目錄必須存在:
|
||||
`我的雲端硬碟/業績報表/當日業績/`
|
||||
Reference in New Issue
Block a user