92 lines
2.8 KiB
Markdown
92 lines
2.8 KiB
Markdown
# CLEANUP OLD NUGET
|
|
|
|
清理 Gitea NuGet 套件舊版本的 Docker Action。
|
|
|
|
## 功能
|
|
|
|
- 依序嘗試取得 Gitea API token。
|
|
- 預設每個套件保留最新 `2` 個版本。
|
|
- 直接刪除超出保留數量的舊版本。
|
|
- 只處理你指定的 NuGet 套件名稱，可一次指定多個。
|
|
- 輸出可搜尋的 log，包含 API status、request id 與 summary。
|
|
- 每頁預設抓取 100 筆版本，可用 `PAGE_LIMIT` 調整。
|
|
|
|
## Token 來源順序
|
|
|
|
Action 會依序嘗試以下來源：
|
|
|
|
1. `inputs.RUNNER_TOKEN`
|
|
2. `secrets.GITEA_TOKEN`
|
|
3. `secrets.RUNNER_TOKEN`
|
|
|
|
若三者都沒有值，Action 會以非零 exit code 結束。
|
|
|
|
## Inputs
|
|
|
|
| 名稱 | 類型 | 預設值 | 說明 |
|
|
| --- | --- | --- | --- |
|
|
| `RUNNER_TOKEN` | string | - | Gitea API token，優先順序最高 |
|
|
| `KEEP_COUNT` | integer string | `2` | 每個套件要保留的最新版本數，必須是整數且 `>= 0` |
|
|
| `PACKAGE_NAMES` | string | - | 要清理的 NuGet 套件名稱，逗號分隔，可一次指定多個 |
|
|
|
|
## Log 行為
|
|
|
|
執行時會輸出這類資訊：
|
|
|
|
- `Trying token from ...`
|
|
- `Using token from ...`
|
|
- `keep_count=...`
|
|
- `package_names=...`
|
|
- `GET /api/v1/... -> 200 OK`
|
|
- `Candidate to delete: ...`
|
|
- `Deleted package ... -> 204 No Content`
|
|
- `Summary: packages=... versions=... kept=... candidates=... deleted=... errors=...`
|
|
|
|
## Workflow 範例
|
|
|
|
```yaml
|
|
jobs:
|
|
cleanup:
|
|
runs-on: ubuntu
|
|
steps:
|
|
- uses: https://gitea.jsc.idv.tw/jiantw83/cleanup-nuget@${{ vars.ACTION_CLEANUP_NUGET_VERSION }}
|
|
with:
|
|
RUNNER_TOKEN: ${{ secrets.GITEA_TOKEN }}
|
|
KEEP_COUNT: 2
|
|
PACKAGE_NAMES: package-a,package-b
|
|
```
|
|
|
|
## 相關檔案
|
|
|
|
- Action 定義: [`action.yaml`](action.yaml)
|
|
- 執行腳本: [`entrypoint.sh`](entrypoint.sh)
|
|
|
|
## 專案範圍
|
|
|
|
- 不需要新增 `.gitea/workflows/ci.yaml`
|
|
- 不需要新增 `tests/*`
|
|
- 除非另外明確要求，請不要再補這兩類檔案
|
|
|
|
## Review Exclusions
|
|
|
|
以下審查意見屬於刻意排除，不再以測試或 CI 的形式處理：
|
|
|
|
- `entrypoint.sh:10-15` `trim`
|
|
- `entrypoint.sh:16-18` `url_encode`
|
|
- `entrypoint.sh:30-59` `resolve_package_names`
|
|
- `entrypoint.sh:61-76` `parse_repo_context`
|
|
- `entrypoint.sh:35-51` `resolve_keep_count`
|
|
- `entrypoint.sh:78-120` `api_request`
|
|
- `entrypoint.sh:122-181` `fetch_package_versions`
|
|
- `entrypoint.sh:183-241` `collect_package_candidates`
|
|
- `entrypoint.sh:243-286` `process_candidates`
|
|
- `entrypoint.sh（整體）` 新增測試程式碼與測試框架
|
|
- `entrypoint.sh（整體）` 端對端測試
|
|
- `entrypoint.sh:7` 結構化 logging
|
|
- `entrypoint.sh:105` 驗證 `GITEA_SERVER_URL`
|
|
- `entrypoint.sh:125-126,241` 暫存檔重用與 I/O 微調
|
|
- `entrypoint.sh:149` 流式 JSON 合併
|
|
- `entrypoint.sh:204,215` 排序與日誌分離建議
|
|
- `entrypoint.sh:243-286` 重複 `url_encode` 進一步最佳化
|
|
- `entrypoint.sh:183-241` 改回掃描 owner 全量套件的 N+1 API 建議
|