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
120 lines
2 KiB
Markdown
120 lines
2 KiB
Markdown
# 指定版本部署
|
||
|
||
本文件說明如何使用固定版本標籤部署 ConvertX-CN。
|
||
|
||
---
|
||
|
||
## 為什麼要指定版本？
|
||
|
||
使用固定版本可以：
|
||
|
||
- 確保每次部署結果一致
|
||
- 避免意外升級造成問題
|
||
- 方便在多台伺服器部署相同版本
|
||
- 出問題時容易回滾
|
||
|
||
---
|
||
|
||
## 如何指定版本
|
||
|
||
修改 `docker-compose.yml`：
|
||
|
||
```yaml
|
||
services:
|
||
convertx:
|
||
image: convertx/convertx-cn:v0.1.9 # 指定版本
|
||
```
|
||
|
||
---
|
||
|
||
## 查看可用版本
|
||
|
||
### GitHub Releases
|
||
|
||
[https://github.com/pi-docket/ConvertX-CN/releases](https://github.com/pi-docket/ConvertX-CN/releases)
|
||
|
||
### Docker Hub
|
||
|
||
```bash
|
||
# 列出所有標籤
|
||
docker search convertx/convertx-cn --limit 100
|
||
|
||
# 或查看 Docker Hub 網頁
|
||
# https://hub.docker.com/r/convertx/convertx-cn/tags
|
||
```
|
||
|
||
---
|
||
|
||
## 版本命名規則
|
||
|
||
| 格式 | 說明 | 範例 |
|
||
| -------- | -------------------- | -------- |
|
||
| `vX.Y.Z` | 正式版本 | `v0.1.9` |
|
||
| `latest` | 最新穩定版 | - |
|
||
| `main` | 最新開發版（不穩定） | - |
|
||
|
||
---
|
||
|
||
## 升級到新版本
|
||
|
||
1. 查看 [Changelog](../../CHANGELOG.md) 確認變更
|
||
2. 修改 docker-compose.yml 的版本號
|
||
3. 執行更新
|
||
|
||
```bash
|
||
docker compose down
|
||
docker compose pull
|
||
docker compose up -d
|
||
```
|
||
|
||
詳見 [版本更新指南](../部署指南/版本更新.md)。
|
||
|
||
---
|
||
|
||
## 回滾到舊版本
|
||
|
||
如果新版本有問題：
|
||
|
||
1. 修改版本號為舊版本
|
||
|
||
```yaml
|
||
image: convertx/convertx-cn:v0.1.8
|
||
```
|
||
|
||
2. 重新部署
|
||
|
||
```bash
|
||
docker compose down
|
||
docker compose pull
|
||
docker compose up -d
|
||
```
|
||
|
||
---
|
||
|
||
## 生產環境建議
|
||
|
||
### 部署流程
|
||
|
||
1. 在測試環境使用 `latest` 或新版本
|
||
2. 確認功能正常
|
||
3. 記錄版本號
|
||
4. 生產環境使用該固定版本
|
||
|
||
### 版本記錄
|
||
|
||
建議在 docker-compose.yml 加上註解：
|
||
|
||
```yaml
|
||
services:
|
||
convertx:
|
||
# 2026-01-20 升級：修復 PDF 轉換問題
|
||
image: convertx/convertx-cn:v0.1.9
|
||
```
|
||
|
||
---
|
||
|
||
## 相關文件
|
||
|
||
- [使用 latest 標籤](最新版.md)
|
||
- [版本更新指南](../部署指南/版本更新.md)
|
||
- [Changelog](../../CHANGELOG.md)
|