Skip to main content

測試

單元測試​

go test -short ./...

完整測試套件​

go test ./...

整合測試​

go test -v ./tests/integration

手動 smoke test​

發布前最重要的三組手動驗證如下：

  • audio:transcode with HLS + downloads + waveform enabled
  • video:preview with gif
  • video:preview with webp
  • video:transcode with encrypt=true

這些 smoke test 會用到的 BASE_URL、API_KEY、buckets 與 secrets，完整說明請見 設定。

如果你不想手動寫 curl，而想透過 docs branch 內附的 Python helper 來驅動這些檢查，可改看 本機手動測試工具。

建議的 smoke test 順序​

audio:transcode​

BASE_URL='http://localhost:3000'
API_KEY='replace-with-api-key'

curl -s \
    -X POST "$BASE_URL/api/audio/jobs" \
    -H 'Content-Type: application/json' \
    -H "X-API-Key: $API_KEY" \
    -d '{
        "source": {
            "hash": "smoke-audio-job",
            "key": "uploads/sample.flac"
        },
        "pipeline": {
            "package": {
                "hls": {
                    "enabled": true,
                    "profile": "stream_aac_standard"
                }
            },
            "downloads": [
                {"profile": "download_mp3_high"},
                {"profile": "download_flac_standard"}
            ],
            "waveform": {
                "enabled": true,
                "profile": "waveform_standard",
                "bins": 2048
            }
        }
    }'

video:preview with gif​

BASE_URL='http://localhost:3000'
API_KEY='replace-with-api-key'

curl -s \
    -X POST "$BASE_URL/api/video/jobs" \
    -H 'Content-Type: application/json' \
    -H "X-API-Key: $API_KEY" \
    -d '{
        "source": {
            "hash": "smoke-preview-gif",
            "key": "uploads/sample.mp4"
        },
        "pipeline": {
            "preview": {
                "enabled": true,
                "start_sec": 1,
                "duration": 3,
                "width": 480,
                "fps": 12,
                "format": "gif"
            }
        }
    }'

video:preview with webp​

把 format 改成 webp，並確認 results.format 與輸出 key 對應。

video:transcode with encrypt=true​

curl -s \
    -X POST "$BASE_URL/api/video/jobs" \
    -H 'Content-Type: application/json' \
    -H "X-API-Key: $API_KEY" \
    -d '{
        "source": {
            "hash": "smoke-transcode-encrypted",
            "key": "uploads/sample.mp4"
        },
        "pipeline": {
            "package": {
                "hls": {
                    "enabled": true,
                    "profile": "stream_video_standard",
                    "encryption": {
                        "enabled": true
                    }
                }
            }
        }
    }'

完成後至少確認：

  • results.streaming.encrypted == true
  • results.streaming.master_playlist 存在
  • results.encryption.scheme == "cbcs"
  • 變體 playlist 內可看到 #EXT-X-KEY
  • /api/key/{id} 在未帶 token 時回 401，有效 token 時回 16 bytes

最近驗證過的情境​

  • portrait HLS ladder 實際播放
  • master.m3u8 的 RESOLUTION 與 API results 對齊
  • CBCS key delivery：401 / 403 / 200 + 16 bytes 語義
  • preview 輸出 gif / webp

測試資料與 fixtures​

  • 單元測試集中在 internal/.../*_test.go
  • 整合測試集中在 tests/integration
  • 共用測試輔助在 tests/testutil

發布前檢查建議​

發布前至少確認下面四件事：

  • go test ./... 全綠
  • 非加密 transcode job 可完成並能播放 master.m3u8
  • 加密 transcode job 會產生 #EXT-X-KEY，且 key endpoint 權限語義正確
  • video:preview 的 gif 與 webp 都能產出預期檔案

若你同時驗證 observability，建議把 smoke test 與 可觀測性 頁的 Jaeger 檢查一起跑，確認 HTTP 與 worker spans 有串起來。