3f1a5e0fbf
- Create 指定版本部署.md to explain fixed version deployment - Create 最新版.md detailing the use of the latest tag - Create 版本選擇指南.md to guide users on version selection - Add Nginx and Traefik configuration examples for reverse proxy - Introduce minimal and production configuration examples - Develop Docker deployment guide with detailed steps - Implement quick start guide for first-time Docker users - Include version update instructions and rollback procedures - Add troubleshooting section for common issues - Enhance overall documentation structure and links for better navigation
105 lines
1.8 KiB
Markdown
105 lines
1.8 KiB
Markdown
# 使用 latest 標籤
|
||
|
||
本文件說明使用 `latest` 標籤的注意事項。
|
||
|
||
---
|
||
|
||
## 什麼是 latest？
|
||
|
||
```yaml
|
||
image: convertx/convertx-cn:latest
|
||
```
|
||
|
||
`latest` 是指向最新穩定版本的標籤。每次發布新版本時，`latest` 會自動更新。
|
||
|
||
---
|
||
|
||
## 優點
|
||
|
||
- 自動獲取新功能與修復
|
||
- 不需要手動修改 docker-compose.yml
|
||
- 適合快速測試
|
||
|
||
---
|
||
|
||
## 風險
|
||
|
||
### 意外更新
|
||
|
||
當執行 `docker compose pull` 時，會自動下載最新版本：
|
||
|
||
```bash
|
||
docker compose pull # 可能拉到新版本
|
||
docker compose up -d # 使用新版本啟動
|
||
```
|
||
|
||
如果新版本有重大變更，可能影響正常使用。
|
||
|
||
### 無法回滾
|
||
|
||
如果沒有記錄使用的版本，出問題時難以回滾。
|
||
|
||
### 不一致
|
||
|
||
多台伺服器在不同時間部署，可能跑不同版本。
|
||
|
||
---
|
||
|
||
## 適用情境
|
||
|
||
| 情境 | 是否適合 latest |
|
||
| -------- | --------------- |
|
||
| 個人測試 | ✅ |
|
||
| 家庭使用 | ✅ |
|
||
| 團隊協作 | ⚠️ 視情況 |
|
||
| 生產環境 | ❌ |
|
||
|
||
---
|
||
|
||
## 使用建議
|
||
|
||
### 測試環境
|
||
|
||
```yaml
|
||
image: convertx/convertx-cn:latest
|
||
```
|
||
|
||
可以使用 `latest`，享受自動更新的便利。
|
||
|
||
### 生產環境
|
||
|
||
建議使用固定版本：
|
||
|
||
```yaml
|
||
image: convertx/convertx-cn:v0.1.9
|
||
```
|
||
|
||
詳見 [指定版本部署](指定版本.md)。
|
||
|
||
---
|
||
|
||
## 如何知道 latest 是哪個版本？
|
||
|
||
### 方法 1：查看 log
|
||
|
||
```bash
|
||
docker compose logs | head -10
|
||
```
|
||
|
||
### 方法 2：檢查映像檔
|
||
|
||
```bash
|
||
docker inspect convertx/convertx-cn:latest | grep -i version
|
||
```
|
||
|
||
### 方法 3：查看網頁
|
||
|
||
開啟 `http://localhost:3000`，頁面底部會顯示版本號。
|
||
|
||
---
|
||
|
||
## 相關文件
|
||
|
||
- [指定版本部署](指定版本.md)
|
||
- [版本更新指南](../部署指南/版本更新.md)
|
||
- [GitHub Releases](https://github.com/pi-docket/ConvertX-CN/releases)
|