# K3s 叢集總覽

快速參考手冊 - 所有服務一覽

## 🖥️ 叢集資訊

| 項目 | 值 |
|------|-----|
| 主機 | 192.168.42.120 |
| 連線 | `ssh ubuntu@192.168.42.120` → `sudo -i` |
| K8s 目錄 | `/root/k8s` |
| 本地目錄 | `/Users/timmy/42_120/k8s` |
| Git Repo | http://192.168.42.124:31337/timmy/k3s.git |

---

## 🚀 已部署服務

### CodiMD - 協作筆記應用

| 項目 | 值 |
|------|-----|
| 用途 | Markdown 協作筆記、團隊知識庫 |
| Ingress | `note.yourdomain.com` |
| 命名空間 | `default` |
| 資料庫 | PostgreSQL (內建) |

**組件：**
- `codimd-app` - 應用程式
- `codimd-db` - PostgreSQL 資料庫
- Longhorn PVC - 資料持久化

**腳本：** `apps/codimd/{deploy,stop,status,backup,restore}.sh`

---

### Opengist - Git Snippets 管理

| 項目 | 值 |
|------|-----|
| 用途 | 自架 Git snippets、程式碼片段分享 |
| SSH Port | `2222` (Traefik TCP) |
| Web Port | `80`/`443` (Ingress) |
| 命名空間 | `default` |

**組件：**
- `opengist` - 應用程式
- Longhorn PVC - 資料持久化

**腳本：** `apps/opengist/{deploy,stop,status,backup,restore}.sh`

---

### PostgreSQL - 獨立資料庫

| 項目 | 值 |
|------|-----|
| 用途 | 通用 PostgreSQL 資料庫服務 |
| Service | `postgres:5432` |
| 命名空間 | `default` |

**腳本：** `apps/postgres/{deploy,stop,status,backup}.sh`

---

## 📂 目錄結構

```
k8s/
├── apps/
│   ├── codimd/           # CodiMD 筆記應用
│   │   ├── manifests/    # K8s YAML 檔案
│   │   ├── backup/       # 備份檔案
│   │   ├── tmpdir/       # 暫存/舊檔案
│   │   └── *.sh          # 管理腳本
│   ├── opengist/         # Opengist Git Snippets
│   │   ├── manifests/
│   │   ├── backup/
│   │   └── *.sh
│   └── postgres/         # 獨立 PostgreSQL
│       ├── manifests/
│       ├── backups/      # SQL 備份
│       └── *.sh
└── cluster/              # 叢集檢查工具
    ├── check_access.sh   # 檢查存取權限
    ├── check_nodes.sh    # 檢查節點狀態
    └── check_storage.sh  # 檢查儲存空間
```

---

## 🔧 常用 K3s 命令

```bash
# 連線後切換 root
ssh ubuntu@192.168.42.120
sudo -i

# 查看 Pods
kubectl get pods -A

# 查看 Services
kubectl get svc -A

# 查看 Ingress
kubectl get ingress -A

# 查看 PVC
kubectl get pvc -A

# 進入 Pod
kubectl exec -it <pod-name> -- sh

# 查看日誌
kubectl logs -f <pod-name>
```

---

## 🔄 維護工作流程

1. **本地修改** → 編輯 manifests 或腳本
2. **同步遠端** → `rsync` 或 `git push`
3. **部署** → 執行 `deploy.sh`
4. **驗證** → 執行 `status.sh`
5. **備份** → 執行 `backup.sh`

---

📖 詳細操作請參考 [QUICKSTART.md](QUICKSTART.md)