124 lines
3.7 KiB
Markdown
124 lines
3.7 KiB
Markdown
# K3s 叢集管理
|
|
|
|
> 個人 K3s Kubernetes 叢集的 manifests 與維護腳本
|
|
|
|
## 📖 文檔導航
|
|
|
|
| 文檔 | 用途 |
|
|
|------|------|
|
|
| **[SUMMARY.md](SUMMARY.md)** | 📋 服務總覽、快速參考 |
|
|
| **[QUICKSTART.md](QUICKSTART.md)** | 🚀 快速入門、操作指南 |
|
|
|
|
---
|
|
|
|
## 🖥️ 連線資訊
|
|
|
|
```bash
|
|
ssh ubuntu@192.168.42.120
|
|
sudo -i # 切換 root
|
|
cd /root/k8s # K3s 工作目錄
|
|
```
|
|
|
|
- **主機**: 192.168.42.120 (vm120 master + vm121/vm122 workers)
|
|
- **K3s 目錄**: `/root/k8s`
|
|
- **舊 manifests**: `/root/k8s-manifests` (備份保留)
|
|
- **本地目錄**: `/Users/timmy/42_120/k8s`
|
|
- **Git Repo**: http://192.168.42.124:31337/timmy/k3s.git
|
|
|
|
---
|
|
|
|
## 🚀 已部署服務
|
|
|
|
| 服務 | 用途 | 狀態腳本 |
|
|
|------|------|----------|
|
|
| [CodiMD](apps/codimd/) | Markdown 協作筆記 | `./apps/codimd/status.sh` |
|
|
| [Opengist](apps/opengist/) | Git Snippets 管理 | `./apps/opengist/status.sh` |
|
|
| [Vaultwarden](apps/vaultwarden/) | 密碼管理器 | `./apps/vaultwarden/status.sh` |
|
|
| [Adminer](apps/adminer/) | 資料庫管理工具 | `./apps/adminer/status.sh` |
|
|
| [PostgreSQL](apps/postgres/) | 通用資料庫 | `./apps/postgres/status.sh` |
|
|
|
|
---
|
|
|
|
## 📂 目錄結構
|
|
|
|
```
|
|
k8s/
|
|
├── apps/
|
|
│ ├── adminer/ # 資料庫管理工具
|
|
│ ├── codimd/ # 筆記應用
|
|
│ ├── opengist/ # Git Snippets
|
|
│ ├── postgres/ # 資料庫
|
|
│ ├── template/ # 新 App 範本
|
|
│ └── vaultwarden/ # 密碼管理器
|
|
└── cluster/ # 叢集工具
|
|
```
|
|
|
|
每個 app 都包含：
|
|
- `manifests/` - Kubernetes YAML 檔案
|
|
- `backup/` - 備份資料
|
|
- `deploy.sh` - 部署腳本
|
|
- `stop.sh` - 停止腳本（保留資料）
|
|
- `status.sh` - 狀態檢查
|
|
- `backup.sh` - 備份腳本（如有）
|
|
|
|
---
|
|
|
|
## ⚡ 快速命令
|
|
|
|
```bash
|
|
# 部署所有服務
|
|
for app in apps/*/; do cd "$app" && ./deploy.sh && cd ../..; done
|
|
|
|
# 檢查所有服務狀態
|
|
for app in apps/*/; do cd "$app" && ./status.sh && cd ../..; done
|
|
|
|
# 查看 K3s Pods
|
|
kubectl get pods -A
|
|
|
|
# 查看 Ingress
|
|
kubectl get ingress -A
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 維護工作流程
|
|
|
|
1. **本地修改** → 在此目錄編輯 manifests 或腳本
|
|
2. **Git 提交** → `git add -A && git commit -m "描述" && git push`
|
|
3. **遠端更新** → `git -C /root/k8s pull`
|
|
4. **套用變更** → `kubectl apply -f manifests/`
|
|
|
|
---
|
|
|
|
## 📚 叢集架構
|
|
|
|
```
|
|
┌─────────────────────────────────────┐
|
|
│ Traefik Ingress │
|
|
│ (codimd / opengist / vw / adminer) │
|
|
└─────────────────┬───────────────────┘
|
|
│
|
|
┌─────────────┼─────────────┬─────────┐
|
|
│ │ │ │
|
|
┌───▼───┐ ┌───▼───┐ ┌───▼───┐ ┌──▼────┐
|
|
│CodiMD │ │Opengist│ │Vault │ │Adminer│
|
|
│ +PG │ │ │ │warden │ │ │
|
|
└───────┘ └────────┘ └───────┘ └───────┘
|
|
│ │ │
|
|
└───▼─────────────▼─────────────▼───┘
|
|
Longhorn Storage
|
|
(持久化資料儲存)
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 相關連結
|
|
|
|
- [K3s 官方文檔](https://docs.k3s.io/)
|
|
- [Traefik Ingress](https://doc.traefik.io/traefik/)
|
|
- [Longhorn Storage](https://longhorn.io/)
|
|
|
|
---
|
|
|
|
⚠️ **注意**：維護時請同步本地與遠端，並定期執行備份！
|