From e3f374395096ccaaf13289af34dfbea28abbb854 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Sat, 21 Mar 2026 10:32:21 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E9=87=8D=E6=A7=8B=E6=B8=85=E7=90=86?= =?UTF-8?q?=E8=88=8A=E7=89=88=E6=88=90=E5=93=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitea/workflows/master.yaml | 34 ++++----- Dockerfile | 14 ++-- action.yml | 37 +++------- cleanup-images.sh | 134 ----------------------------------- cleanup-releases.sh | 129 --------------------------------- entrypoint.sh | 88 +++++++++++++++++++---- readme.md | 118 ------------------------------ 7 files changed, 108 insertions(+), 446 deletions(-) delete mode 100644 cleanup-images.sh delete mode 100644 cleanup-releases.sh delete mode 100644 readme.md diff --git a/.gitea/workflows/master.yaml b/.gitea/workflows/master.yaml index 879ac69..3e8d0e3 100644 --- a/.gitea/workflows/master.yaml +++ b/.gitea/workflows/master.yaml @@ -3,26 +3,28 @@ on: branches: - master jobs: - cd: - name: "CD > 發布專案" - runs-on: docker - env: - RUNNER_TOOL_CACHE: /toolcache + version: + name: "CD > 計算版本號" + runs-on: ubuntu + outputs: + version: ${{ steps.version.outputs.version }} steps: - name: 計算版本號 id: version uses: https://gitea.jsc.idv.tw/actions/calculate-version@${{ vars.ACTION_CALCULATE_VERSION }} - with: - gitea-server: ${{ gitea.server_url }} - repository: ${{ gitea.repository }} - token: ${{ secrets.GITEA_TOKEN }} + release: + name: "CD > 發布專案" + runs-on: ubuntu + needs: version + steps: - name: 發布專案 uses: akkuman/gitea-release-action@${{ vars.ACTION_RELEASE_VERSION }} with: - tag_name: "v${{ steps.version.outputs.VERSION }}" - - name: 清理舊版本 (保留最新2個) - uses: https://gitea.jsc.idv.tw/actions/cleanup-release@${{ vars.ACTION_CLEANUP_RELEASE_VERSION }} - with: - gitea-server: ${{ gitea.server_url }} - repository: ${{ gitea.repository }} - token: ${{ secrets.GITEA_TOKEN }} \ No newline at end of file + tag_name: "v${{ needs.version.outputs.version }}" + test: + name: "CD > 清理舊版成品" + runs-on: ubuntu + needs: release + steps: + - name: 清理舊版成品 + uses: https://gitea.jsc.idv.tw/actions/cleanup-release@${{ vars.ACTION_CLEANUP_RELEASE_VERSION }} \ No newline at end of file diff --git a/Dockerfile b/Dockerfile index 08b23e1..0cc82e8 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,11 +1,11 @@ -FROM alpine:3.21 +FROM alpine:latest -RUN apk add --no-cache bash curl jq - -COPY cleanup-releases.sh /cleanup-releases.sh -COPY cleanup-images.sh /cleanup-images.sh +# 更新並安裝必要的工具 +RUN apk update \ + && apk add --no-cache bash curl jq + COPY entrypoint.sh /entrypoint.sh -RUN chmod +x /cleanup-releases.sh /cleanup-images.sh /entrypoint.sh +RUN chmod +x /entrypoint.sh -ENTRYPOINT ["/entrypoint.sh"] +ENTRYPOINT ["/entrypoint.sh"] \ No newline at end of file diff --git a/action.yml b/action.yml index 0b2a2ef..9ec41af 100644 --- a/action.yml +++ b/action.yml @@ -1,34 +1,15 @@ -name: 'Cleanup Old Releases' -description: '自動清理舊版本的 releases,保留指定數量的最新版本' +name: 'CLEANUP OLD RELEASES' +description: '清理舊版成品' +author: 'Jeffery' inputs: - gitea-server: - description: 'Gitea 伺服器 URL' - required: true - repository: - description: '儲存庫名稱 (格式: owner/repo)' - required: true - package-name: - description: 'Container 套件名稱 (選填,若提供則會清理 Container Registry)' - required: false - default: '' - token: - description: 'Gitea API Token' - required: true - keep-count: - description: '保留的最新版本數量' - required: false + KEEP_COUNT: + description: '保留的版本數量' default: '2' - dry-run: - description: '是否為模擬執行 (只顯示會刪除的版本,不實際刪除)' - required: false - default: 'false' runs: using: 'docker' image: 'Dockerfile' env: - GITEA_SERVER: ${{ inputs.gitea-server }} - REPOSITORY: ${{ inputs.repository }} - PACKAGE_NAME: ${{ inputs.package-name }} - TOKEN: ${{ inputs.token }} - KEEP_COUNT: ${{ inputs.keep-count }} - DRY_RUN: ${{ inputs.dry-run }} + GITEA_SERVER_URL: ${{ gitea.server_url }} + GITEA_REPOSITORY: ${{ gitea.repository }} + RUNNER_TOKEN: ${{ secrets.RUNNER_TOKEN }} + KEEP_COUNT: ${{ inputs.KEEP_COUNT }} \ No newline at end of file diff --git a/cleanup-images.sh b/cleanup-images.sh deleted file mode 100644 index 50f7919..0000000 --- a/cleanup-images.sh +++ /dev/null @@ -1,134 +0,0 @@ -#!/bin/bash - -set -euo pipefail - -GITEA_SERVER="$1" -REPOSITORY="$2" -PACKAGE_NAME="$3" -TOKEN="$4" -KEEP_COUNT="$5" -DRY_RUN="${6:-false}" - -# 參數驗證 -if [[ -z "$GITEA_SERVER" ]] || [[ -z "$REPOSITORY" ]] || [[ -z "$PACKAGE_NAME" ]] || [[ -z "$TOKEN" ]] || [[ -z "$KEEP_COUNT" ]]; then - echo "❌ 錯誤:缺少必要參數" - echo "使用方式: $0 [dry-run]" - exit 1 -fi - -echo "開始清理舊映像,保留最新 $KEEP_COUNT 個版本" - -# 提取 owner 名稱 -OWNER=$(echo "$REPOSITORY" | cut -d'/' -f1) - -echo "Owner: $OWNER" -echo "Package: $PACKAGE_NAME" - -# 獲取所有 container 版本並按創建時間排序 -echo "正在獲取映像版本列表..." -VERSIONS_JSON=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \ - "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME?token=$TOKEN" \ - -H "Accept: application/json") - -HTTP_STATUS=$(echo "$VERSIONS_JSON" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2) -VERSIONS_JSON=$(echo "$VERSIONS_JSON" | sed '/HTTP_STATUS:/d') - -# 檢查是否成功獲取版本列表 -if [[ "$HTTP_STATUS" != "200" ]] || [[ -z "$VERSIONS_JSON" ]] || [[ "$VERSIONS_JSON" == "null" ]]; then - echo "❌ 錯誤:無法獲取 container 版本列表 (HTTP Status: $HTTP_STATUS)" - exit 1 -fi - -# 獲取並排序所有版本 (按創建時間降序) -SORTED_VERSIONS=$(echo "$VERSIONS_JSON" | jq -e 'sort_by(.created_at) | reverse') - -if [[ $? -ne 0 ]]; then - echo "❌ 錯誤:無法解析版本資料" - exit 1 -fi - -# 計算總數量 -TOTAL_COUNT=$(echo "$SORTED_VERSIONS" | jq 'length') -echo "目前總共有 $TOTAL_COUNT 個映像版本" - -# 如果總數量小於等於保留數量,則無需清理 -if [[ $TOTAL_COUNT -le $KEEP_COUNT ]]; then - echo "✅ 映像數量 ($TOTAL_COUNT) 未超過保留數量 ($KEEP_COUNT),無需清理" - exit 0 -fi - -# 計算需要刪除的數量 -DELETE_COUNT=$((TOTAL_COUNT - KEEP_COUNT)) -echo "需要刪除 $DELETE_COUNT 個舊映像" - -# 獲取要刪除的版本 (跳過前 keep-count 個) -TO_DELETE=$(echo "$SORTED_VERSIONS" | jq -c ".[$KEEP_COUNT:][]") - -# 初始化刪除計數器 -DELETED_COUNT=0 -FAILED_COUNT=0 - -# 處理每個要刪除的版本 -while IFS= read -r version; do - if [[ -z "$version" ]] || [[ "$version" == "null" ]]; then - continue - fi - - VERSION_ID=$(echo "$version" | jq -r '.id') - VERSION_NAME=$(echo "$version" | jq -r '.version') - CREATED_AT=$(echo "$version" | jq -r '.created_at') - - if [[ -z "$VERSION_ID" ]] || [[ "$VERSION_ID" == "null" ]]; then - continue - fi - - echo "準備刪除: ID=$VERSION_ID, Version=$VERSION_NAME, Created=$CREATED_AT" - - if [[ "$DRY_RUN" == "true" ]]; then - echo "🔍 [模擬執行] 會刪除映像版本: $VERSION_NAME (ID: $VERSION_ID)" - DELETED_COUNT=$((DELETED_COUNT + 1)) - else - # 實際刪除 - DELETE_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \ - -X DELETE "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME/$VERSION_NAME?token=$TOKEN" \ - -H "Accept: application/json") - - DELETE_HTTP_STATUS=$(echo "$DELETE_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2) - - if [[ "$DELETE_HTTP_STATUS" == "204" ]] || [[ "$DELETE_HTTP_STATUS" == "200" ]]; then - echo "✅ 成功刪除映像版本: $VERSION_NAME (ID: $VERSION_ID)" - DELETED_COUNT=$((DELETED_COUNT + 1)) - else - echo "❌ 刪除失敗映像版本: $VERSION_NAME (ID: $VERSION_ID), HTTP狀態: $DELETE_HTTP_STATUS" - FAILED_COUNT=$((FAILED_COUNT + 1)) - fi - fi -done <<< "$TO_DELETE" - -# 檢查是否有刪除失敗的情況 -if [[ $FAILED_COUNT -gt 0 ]]; then - echo "" - echo "❌ 錯誤:有 $FAILED_COUNT 個映像版本刪除失敗" - exit 1 -fi - -# 輸出最終結果 -echo "" -echo "=========================================" -if [[ "$DRY_RUN" == "true" ]]; then - echo "🔍 [模擬執行] 總共會刪除 $DELETED_COUNT 個映像版本" - echo "✅ 模擬執行完成" -else - echo "✅ 清理完成,成功刪除了 $DELETED_COUNT 個映像版本" - - # 驗證結果 - if [[ $DELETED_COUNT -gt 0 ]]; then - echo "" - echo "正在驗證剩餘映像數量..." - VERIFY_JSON=$(curl -s "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME?token=$TOKEN" \ - -H "Accept: application/json") - NEW_TOTAL_COUNT=$(echo "$VERIFY_JSON" | jq 'length') - echo "📊 目前剩餘 $NEW_TOTAL_COUNT 個映像版本(預期: $KEEP_COUNT)" - fi -fi -echo "=========================================" diff --git a/cleanup-releases.sh b/cleanup-releases.sh deleted file mode 100644 index 5eab579..0000000 --- a/cleanup-releases.sh +++ /dev/null @@ -1,129 +0,0 @@ -#!/bin/bash - -set -euo pipefail - -GITEA_SERVER="$1" -REPOSITORY="$2" -TOKEN="$3" -KEEP_COUNT="$4" -DRY_RUN="${5:-false}" - -# 參數驗證 -if [[ -z "$GITEA_SERVER" ]] || [[ -z "$REPOSITORY" ]] || [[ -z "$TOKEN" ]] || [[ -z "$KEEP_COUNT" ]]; then - echo "❌ 錯誤:缺少必要參數" - echo "使用方式: $0 [dry-run]" - exit 1 -fi - -echo "開始清理舊版本,保留最新 $KEEP_COUNT 個版本" - -# 獲取所有發佈並按創建時間排序 -echo "正在獲取發佈列表..." -RELEASES_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \ - "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases" \ - -H "Authorization: token $TOKEN" \ - -H "Accept: application/json") - -HTTP_STATUS=$(echo "$RELEASES_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2) -RELEASES_JSON=$(echo "$RELEASES_RESPONSE" | sed '/HTTP_STATUS:/d') - -# 檢查是否成功獲取發佈 -if [[ "$HTTP_STATUS" != "200" ]] || [[ -z "$RELEASES_JSON" ]] || [[ "$RELEASES_JSON" == "null" ]]; then - echo "❌ 錯誤:無法獲取發佈列表 (HTTP Status: $HTTP_STATUS)" - exit 1 -fi - -# 計算總數量並排序(按創建時間降序,最新的在前) -SORTED_RELEASES=$(echo "$RELEASES_JSON" | jq -e 'sort_by(.created_at) | reverse') - -if [[ $? -ne 0 ]]; then - echo "❌ 錯誤:無法解析發佈資料" - exit 1 -fi - -TOTAL_COUNT=$(echo "$SORTED_RELEASES" | jq 'length') -echo "目前總共有 $TOTAL_COUNT 個發佈" - -# 如果總數量小於等於保留數量,則無需清理 -if [[ $TOTAL_COUNT -le $KEEP_COUNT ]]; then - echo "✅ 發佈數量 ($TOTAL_COUNT) 未超過保留數量 ($KEEP_COUNT),無需清理" - exit 0 -fi - -# 計算需要刪除的數量 -DELETE_COUNT=$((TOTAL_COUNT - KEEP_COUNT)) -echo "需要刪除 $DELETE_COUNT 個舊版本" - -# 獲取要刪除的發佈(跳過前 keep-count 個) -TO_DELETE=$(echo "$SORTED_RELEASES" | jq -c ".[$KEEP_COUNT:]") - -# 初始化刪除計數器 -DELETED_COUNT=0 -FAILED_COUNT=0 - -# 處理每個要刪除的發佈 -echo "$TO_DELETE" | jq -c '.[]' | while IFS= read -r release; do - if [[ -z "$release" ]] || [[ "$release" == "null" ]]; then - continue - fi - - RELEASE_ID=$(echo "$release" | jq -r '.id') - RELEASE_TAG=$(echo "$release" | jq -r '.tag_name') - RELEASE_NAME=$(echo "$release" | jq -r '.name // "未命名"') - - if [[ -z "$RELEASE_ID" ]] || [[ "$RELEASE_ID" == "null" ]]; then - continue - fi - - if [[ "$DRY_RUN" == "true" ]]; then - echo "🔍 [模擬執行] 會刪除發佈: $RELEASE_TAG ($RELEASE_NAME)" - else - # 實際刪除 - DELETE_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \ - -X DELETE "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases/$RELEASE_ID" \ - -H "Authorization: token $TOKEN") - - HTTP_STATUS=$(echo "$DELETE_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2) - - if [[ "$HTTP_STATUS" == "204" ]] || [[ "$HTTP_STATUS" == "200" ]]; then - echo "✅ 成功刪除發佈: $RELEASE_TAG ($RELEASE_NAME)" - else - echo "❌ 刪除失敗發佈: $RELEASE_TAG ($RELEASE_NAME), HTTP 狀態: $HTTP_STATUS" - FAILED_COUNT=$((FAILED_COUNT + 1)) - fi - fi -done - -# 檢查是否有刪除失敗的情況 -if [[ $FAILED_COUNT -gt 0 ]]; then - echo "" - echo "❌ 錯誤:有 $FAILED_COUNT 個發佈刪除失敗" - exit 1 -fi - -# 輸出最終結果 -if [[ "$DRY_RUN" == "true" ]]; then - echo "" - echo "🔍 [模擬執行] 總共會刪除 $DELETE_COUNT 個版本" - echo "✅ 模擬執行完成" -else - # 重新獲取並計算實際刪除的數量 - echo "" - echo "正在驗證刪除結果..." - NEW_RELEASES_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \ - "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases" \ - -H "Authorization: token $TOKEN" \ - -H "Accept: application/json") - - NEW_HTTP_STATUS=$(echo "$NEW_RELEASES_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2) - NEW_RELEASES_JSON=$(echo "$NEW_RELEASES_RESPONSE" | sed '/HTTP_STATUS:/d') - - if [[ "$NEW_HTTP_STATUS" == "200" ]] && [[ -n "$NEW_RELEASES_JSON" ]]; then - NEW_TOTAL_COUNT=$(echo "$NEW_RELEASES_JSON" | jq 'length') - ACTUAL_DELETED=$((TOTAL_COUNT - NEW_TOTAL_COUNT)) - echo "✅ 清理完成!實際刪除了 $ACTUAL_DELETED 個版本" - echo "📊 目前剩餘 $NEW_TOTAL_COUNT 個發佈" - else - echo "✅ 清理完成(無法驗證最終數量)" - fi -fi diff --git a/entrypoint.sh b/entrypoint.sh index 120ee26..3ac297a 100644 --- a/entrypoint.sh +++ b/entrypoint.sh @@ -1,21 +1,81 @@ #!/bin/bash -set -euo pipefail +echo "==================================================" -GITEA_SERVER="${GITEA_SERVER:-}" -REPOSITORY="${REPOSITORY:-}" -PACKAGE_NAME="${PACKAGE_NAME:-}" -TOKEN="${TOKEN:-}" -KEEP_COUNT="${KEEP_COUNT:-2}" -DRY_RUN="${DRY_RUN:-false}" +echo "參數檢查" -if [[ -z "$GITEA_SERVER" ]] || [[ -z "$REPOSITORY" ]] || [[ -z "$TOKEN" ]]; then - echo "❌ 錯誤:缺少必要的 inputs (gitea-server, repository, token)" - exit 1 +echo "--------------------------------------------------" + +# 顯示 GITEA_SERVER_URL 參數,並檢查是否為空或 "null",如果是則輸出錯誤訊息並退出 +echo "GITEA_SERVER_URL=$GITEA_SERVER_URL" && ([ -z "$GITEA_SERVER_URL" ] || [ "$GITEA_SERVER_URL" = "null" ]) && exit 1 + +# 顯示 GITEA_REPOSITORY 參數,並檢查是否為空或 "null",如果是則輸出錯誤訊息並退出 +echo "GITEA_REPOSITORY=$GITEA_REPOSITORY" && ([ -z "$GITEA_REPOSITORY" ] || [ "$GITEA_REPOSITORY" = "null" ]) && exit 1 + +# 顯示 RUNNER_TOKEN 參數 +echo "RUNNER_TOKEN=$RUNNER_TOKEN" + +# 顯示 KEEP_COUNT 參數,並檢查是否為空或 "null",如果是則輸出錯誤訊息並退出 +echo "KEEP_COUNT=$KEEP_COUNT" && ([ -z "$KEEP_COUNT" ] || [ "$KEEP_COUNT" = "null" ]) && exit 1 + +echo "==================================================" + +echo "取得成品資訊" + +echo "--------------------------------------------------" + +RELEASE_URL="$GITEA_SERVER_URL/api/v1/repos/$GITEA_REPOSITORY/releases" + +# 檢查是否為空或 "null" +if [ -n "$RUNNER_TOKEN" ] && [ "$RUNNER_TOKEN" != "null" ]; then + # 組合 RELEASE_HEADER 參數,並顯示出來 + RELEASE_HEADER="Authorization: token $RUNNER_TOKEN" && echo "RELEASE_HEADER=$RELEASE_HEADER" + + # 取得成品資訊 + RELEASE_JSON="$(curl -s -H "$RELEASE_HEADER" "$RELEASE_URL")" +else + # 取得成品資訊 + RELEASE_JSON="$(curl -s "$RELEASE_URL")" fi -/cleanup-releases.sh "$GITEA_SERVER" "$REPOSITORY" "$TOKEN" "$KEEP_COUNT" "$DRY_RUN" +# 計算成品數量並依照時間排序 +RELEASE_JSON=$(echo "$RELEASE_JSON" | jq -e 'sort_by(.created_at) | reverse') +RELEASE_COUNT=$(echo "$RELEASE_JSON" | jq 'length') -if [[ -n "$PACKAGE_NAME" ]]; then - /cleanup-images.sh "$GITEA_SERVER" "$REPOSITORY" "$PACKAGE_NAME" "$TOKEN" "$KEEP_COUNT" "$DRY_RUN" -fi +# 檢查成品數量是否需要清除 +[ $RELEASE_COUNT -le $KEEP_COUNT ] && exit 0 + +echo "==================================================" + +echo "刪除舊版本的成品" + +echo "--------------------------------------------------" + +RELEASE_TO_DELETE=$(echo "$RELEASE_JSON" | jq -c ".[$KEEP_COUNT:]") + +echo "$RELEASE_TO_DELETE" | jq -c '.[]' | while IFS= read -r RELEASE_URL; do + # 檢查是否有成品連結 + ([ -z "$RELEASE_URL" ] || [ "$RELEASE_URL" == "null" ]) && continue + + # 取得成品資訊 + RELEASE_ID=$(echo "$RELEASE_URL" | jq -r '.id') + RELEASE_TAG=$(echo "$RELEASE_URL" | jq -r '.tag_name') + RELEASE_NAME=$(echo "$RELEASE_URL" | jq -r '.name') + + # 檢查成品編號是否正確 + ([ -z "$RELEASE_ID" ] || [ "$RELEASE_ID" == "null" ]) && continue + + # 刪除成品 + RELEASE_URL="$GITEA_SERVER_URL/api/v1/repos/$GITEA_REPOSITORY/releases/$RELEASE_ID" + + RELEASE_DELETE_CODE=$(curl -s -o /dev/null -w "%{http_code}" -X DELETE -H "$RELEASE_HEADER" "$RELEASE_URL") + + # 檢查刪除成品是否成功 + if [ "$RELEASE_DELETE_CODE" -eq 204 ]; then + echo "✅ 成功刪除成品: $RELEASE_TAG ($RELEASE_NAME)" + else + echo "❌ 刪除成品失敗: $RELEASE_TAG ($RELEASE_NAME), HTTP 狀態碼: $RELEASE_DELETE_CODE" + fi +done + +echo "==================================================" \ No newline at end of file diff --git a/readme.md b/readme.md deleted file mode 100644 index f3350d8..0000000 --- a/readme.md +++ /dev/null @@ -1,118 +0,0 @@ -# Cleanup Old Releases Action - -這是一個自動清理舊版本 releases 的 GitHub Action,可以保留指定數量的最新版本,刪除多餘的舊版本。 - -## 功能特色 - -- 🗑️ 自動清理舊版本 releases -- 🔢 可配置保留的版本數量 -- 🔍 支援模擬執行模式 -- 📊 詳細的執行報告 -- 🛡️ 安全的錯誤處理 - -## 輸入參數 - -| 參數名稱 | 必要 | 預設值 | 描述 | -|---------|------|--------|------| -| `gitea-server` | ✅ | - | Gitea 伺服器 URL | -| `repository` | ✅ | - | 儲存庫名稱 (格式: owner/repo) | -| `token` | ✅ | - | Gitea API Token | -| `keep-count` | ❌ | `2` | 保留的最新版本數量 | -| `dry-run` | ❌ | `false` | 是否為模擬執行 (只顯示會刪除的版本,不實際刪除) | - -## 輸出參數 - -| 參數名稱 | 描述 | -|---------|------| -| `deleted-count` | 已刪除的版本數量 | -| `deleted-releases` | 已刪除的版本列表 (JSON 格式) | - -## 使用範例 - -### 基本用法 (保留最新2個版本) - -```yaml -- name: 清理舊版本 - uses: ./.gitea/actions/cleanup-releases - with: - gitea-server: ${{ gitea.server_url }} - repository: ${{ gitea.repository }} - token: ${{ secrets.GITEA_TOKEN }} -``` - -### 自定義保留數量 - -```yaml -- name: 清理舊版本 (保留最新5個) - uses: ./.gitea/actions/cleanup-releases - with: - gitea-server: ${{ gitea.server_url }} - repository: ${{ gitea.repository }} - token: ${{ secrets.GITEA_TOKEN }} - keep-count: '5' -``` - -### 模擬執行模式 - -```yaml -- name: 檢查要清理的版本 - id: check-cleanup - uses: ./.gitea/actions/cleanup-releases - with: - gitea-server: ${{ gitea.server_url }} - repository: ${{ gitea.repository }} - token: ${{ secrets.GITEA_TOKEN }} - keep-count: '3' - dry-run: 'true' - -- name: 顯示模擬結果 - run: | - echo "模擬執行會刪除 ${{ steps.check-cleanup.outputs.deleted-count }} 個版本" -``` - -### 使用輸出結果 - -```yaml -- name: 清理舊版本 - id: cleanup - uses: ./.gitea/actions/cleanup-releases - with: - gitea-server: ${{ gitea.server_url }} - repository: ${{ gitea.repository }} - token: ${{ secrets.GITEA_TOKEN }} - keep-count: '2' - -- name: 報告清理結果 - run: | - echo "清理完成,刪除了 ${{ steps.cleanup.outputs.deleted-count }} 個舊版本" - echo "刪除的版本詳情: ${{ steps.cleanup.outputs.deleted-releases }}" -``` - -## 運作邏輯 - -1. **獲取版本列表**:從 Gitea API 獲取所有 releases,按創建時間排序 -2. **計算刪除範圍**:保留最新的 `keep-count` 個版本,標記其餘版本為待刪除 -3. **執行清理**: - - 模擬模式:只顯示會刪除的版本,不實際執行 - - 正常模式:逐一刪除標記的版本 -4. **回報結果**:提供刪除數量和詳細列表 - -## 安全特性 - -- ✅ **防護機制**:如果總版本數 ≤ 保留數量,則不執行任何刪除 -- ✅ **錯誤處理**:API 請求失敗時會顯示錯誤訊息並停止執行 -- ✅ **模擬模式**:可以先模擬執行,確認要刪除的版本無誤 -- ✅ **詳細日誌**:每個步驟都有清楚的日誌輸出 - -## 注意事項 - -- 需要有 `GITEA_TOKEN` secret 且具備刪除 releases 的權限 -- 刪除操作是不可逆的,建議先使用模擬模式確認 -- Action 按照創建時間排序,保留最新的版本 -- 建議在 release 創建之後執行此 action - -## 錯誤處理 - -- 如果無法連接到 Gitea API,action 會失敗並顯示錯誤訊息 -- 如果某個版本刪除失敗,會記錄錯誤但繼續處理其他版本 -- 如果 token 權限不足,會顯示相應的 HTTP 錯誤狀態