- 所有 task 驗證完成(7.1 stderr log / 7.2 無新增日誌檔 / 7.3 session 走 Redis) - 同步 env-cloud-annotations 主 spec(LOG_CHANNEL 取代 LOG_STACK + 新增 scenario) - 新增 scheduler-container 主 spec(獨立 container 取代 cron daemon) - 移至 archive/2026-06-18-cloud-ready-p1 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
+3
-3
@@ -40,6 +40,6 @@
|
|||||||
|
|
||||||
## 7. 手動驗證(VPS,需更新 .env 後)
|
## 7. 手動驗證(VPS,需更新 .env 後)
|
||||||
|
|
||||||
- [ ] 7.1 [整合測試] 確認 log 走 stderr:呼叫任意 API 後 `docker compose logs app | tail -20` 有日誌輸出
|
- [x] 7.1 [整合測試] 確認 log 走 stderr:呼叫任意 API 後 `docker compose logs app | tail -20` 有日誌輸出
|
||||||
- [ ] 7.2 [整合測試] 確認 `storage/logs/` 無新增日誌檔(舊檔保留)
|
- [x] 7.2 [整合測試] 確認 `storage/logs/` 無新增日誌檔(舊檔保留)
|
||||||
- [ ] 7.3 [整合測試] 確認 session 走 Redis:登入後 `docker compose exec redis redis-cli keys "laravel_session*"` 有輸出
|
- [x] 7.3 [整合測試] 確認 session 走 Redis:登入後 `docker compose exec redis redis-cli keys "cfdiveplatform_database_*"` 有輸出(prefix 為 APP_NAME_database_,非 laravel_session*)
|
||||||
@@ -12,11 +12,19 @@
|
|||||||
- **THEN** Laravel queue driver 使用 Redis,queue worker 正常消費 Redis 佇列中的 job
|
- **THEN** Laravel queue driver 使用 Redis,queue worker 正常消費 Redis 佇列中的 job
|
||||||
|
|
||||||
### Requirement: .env.example 標示雲端必要變數
|
### Requirement: .env.example 標示雲端必要變數
|
||||||
`.env.example` SHALL 以行內註解標示以下雲端部署時必須明確設定的變數:
|
`.env.example` SHALL 以行內註解或正確預設值標示以下雲端部署時必須明確設定的變數:
|
||||||
- `FILESYSTEM_DISK`:雲端應設為 `s3`(預設 `local` 在容器重啟後遺失上傳檔案)
|
- `FILESYSTEM_DISK`:雲端應設為 `s3`(預設 `local` 在容器重啟後遺失上傳檔案)
|
||||||
- `LOG_STACK`:雲端建議改為 `stderr` 以接入雲端 logging aggregator
|
- `LOG_CHANNEL`:預設改為 `stderr`(雲端 logging aggregator 標準;原 `stack/daily` 寫檔案不適合雲端)
|
||||||
- `QUEUE_CONNECTION`:應為 `redis`
|
- `QUEUE_CONNECTION`:預設為 `redis`
|
||||||
- `SESSION_DRIVER`:雲端建議改為 `redis`
|
- `SESSION_DRIVER`:預設改為 `redis`(取代 `database`,擴容更高效)
|
||||||
|
|
||||||
|
#### Scenario: 新環境照 .env.example 初始化 session driver
|
||||||
|
- **WHEN** 開發者以 `.env.example` 為基礎建立 `.env`,未手動修改 `SESSION_DRIVER`
|
||||||
|
- **THEN** Laravel session driver 使用 Redis
|
||||||
|
|
||||||
|
#### Scenario: 新環境照 .env.example 初始化 log channel
|
||||||
|
- **WHEN** 開發者以 `.env.example` 為基礎建立 `.env`,未手動修改 `LOG_CHANNEL`
|
||||||
|
- **THEN** Laravel 日誌寫入 stderr,可透過 `docker compose logs app` 查看
|
||||||
|
|
||||||
#### Scenario: 操作者閱讀 .env.example 進行雲端部署
|
#### Scenario: 操作者閱讀 .env.example 進行雲端部署
|
||||||
- **WHEN** 操作者參照 `.env.example` 設定雲端環境的 `.env`
|
- **WHEN** 操作者參照 `.env.example` 設定雲端環境的 `.env`
|
||||||
|
|||||||
@@ -0,0 +1,23 @@
|
|||||||
|
# scheduler-container
|
||||||
|
|
||||||
|
Laravel Scheduler 以獨立 container 執行,取代 app container 內的 cron daemon。
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
### Requirement: Scheduler 以獨立 container 執行
|
||||||
|
`docker-compose.yml` SHALL 定義 `scheduler` service,使用 `cfdive-platform` image,以 `php artisan schedule:work` 前台輪詢方式執行 Laravel Scheduler,取代原本在 app container 內的 cron daemon。
|
||||||
|
|
||||||
|
#### Scenario: Scheduler container 隨 app 啟動
|
||||||
|
- **WHEN** 執行 `docker compose up -d` 且 `app` container 已 healthy
|
||||||
|
- **THEN** `scheduler` container 啟動並持續執行 `php artisan schedule:work`
|
||||||
|
|
||||||
|
#### Scenario: App container 重啟時 scheduler 等待就緒
|
||||||
|
- **WHEN** `app` container 重啟中(unhealthy)
|
||||||
|
- **THEN** `scheduler` container 依 `depends_on` 等待 `app` healthy 後才啟動,避免 scheduler 在 PHP-FPM 未就緒時執行任務
|
||||||
|
|
||||||
|
### Requirement: App container 不再包含 cron daemon
|
||||||
|
`Dockerfile` SHALL 不安裝 `cron` 套件,`docker-entrypoint.sh` SHALL 不執行 `service cron start`,確保 app container 職責單一(只跑 PHP-FPM)。
|
||||||
|
|
||||||
|
#### Scenario: App container 啟動不啟動 cron
|
||||||
|
- **WHEN** `app` container 啟動並執行 entrypoint
|
||||||
|
- **THEN** 不存在 cron daemon 程序,`pgrep cron` 回傳 exit code 1
|
||||||
Reference in New Issue
Block a user