23 Commits

Author SHA1 Message Date
e5f97f6ae2 更新 action.yml 2026-03-25 06:40:25 +00:00
56691b629b 更新 Dockerfile 2026-03-25 05:43:24 +00:00
69e1b8a553 更新 action.yml 2026-03-25 02:45:22 +00:00
a39202fd68 feat: 將清理成品的行為合併到發布專案 2026-03-21 19:45:07 +08:00
431fbe06f8 更新 .gitea/workflows/master.yaml 2026-03-21 07:20:28 +00:00
7e067f2f4b feat: 修改工作流的名稱 2026-03-21 10:50:37 +08:00
193f1d3312 feat: 修改工作流的名稱 2026-03-21 10:48:42 +08:00
29849ebc19 feat: 執行工作留時,才取得 token 2026-03-21 10:45:19 +08:00
59bc31a756 feat: 新增 input 參數,可以讓工具使用者自訂 token 2026-03-21 10:44:18 +08:00
e3f3743950 feat: 重構清理舊版成品 2026-03-21 10:32:21 +08:00
Jeffery
cd5480b334 test: 嘗試修正 INPUT_GITEA_SERVER: unbound variable 問題 2026-03-20 14:25:53 +08:00
Jeffery
ea8b72ce8f feat: 改成 docker action 2026-03-20 14:18:53 +08:00
0d7cdd65ca 更新 .gitea/workflows/master.yaml 2026-03-05 08:07:45 +00:00
99ae6a157b 更新 .gitea/workflows/master.yaml 2026-03-05 08:05:12 +00:00
3bd0ecaa98 更新 .gitea/workflows/master.yaml 2026-03-05 07:59:39 +00:00
Jeffery
146283281b fix: 修正刪除 API 的參數 2025-12-01 15:14:56 +08:00
Jeffery
9cf1a7a974 feat: 刪除失敗,不要讓任務成功 2025-12-01 15:13:00 +08:00
Jeffery
f6d27ed523 feat: 移除多餘的變數 2025-12-01 14:53:06 +08:00
Jeffery
b4c9edcd69 feat: 修改輸出與註解 2025-12-01 14:33:36 +08:00
Jeffery
789d08a0a6 feat: 優化程序 2025-12-01 14:32:01 +08:00
Jeffery
806e385b86 feat: 修正刪除的 API 2025-12-01 14:11:37 +08:00
Jeffery
c5333d4562 fix: 修正 get 的 api 解析 2025-12-01 14:03:32 +08:00
Jeffery
26b91397f1 Revert "feat: 修改指令執行格式"
This reverts commit 49839e72a0.
2025-12-01 12:03:51 +08:00
7 changed files with 121 additions and 373 deletions

View File

@@ -3,26 +3,25 @@ on:
branches: branches:
- master - master
jobs: jobs:
cd: version:
name: "CD > 發布專案" name: "CD > 計算版本號"
runs-on: docker runs-on: ubuntu
env: outputs:
RUNNER_TOOL_CACHE: /toolcache version: ${{ steps.version.outputs.version }}
steps: steps:
- name: 計算版本號 - name: 計算版本號
id: version id: version
uses: https://gitea.jsc.idv.tw/jiantw83/calculate-version-action@v${{ vars.CALCULATE_VERSION }} uses: https://gitea.jsc.idv.tw/actions/calculate-version@${{ vars.ACTION_CALCULATE_VERSION }}
with: release:
gitea-server: ${{ gitea.server_url }} name: "CD > 發布專案"
repository: ${{ gitea.repository }} runs-on: ubuntu
token: ${{ secrets.GITEA_TOKEN }} needs: version
steps:
- name: 發布專案 - name: 發布專案
uses: akkuman/gitea-release-action@v1 uses: akkuman/gitea-release-action@${{ vars.ACTION_RELEASE_VERSION }}
with: with:
tag_name: "v${{ steps.version.outputs.VERSION }}" tag_name: "v${{ needs.version.outputs.version }}"
- name: 清理舊版本 (保留最新2個) - name: 清理成品
uses: https://gitea.jsc.idv.tw/jiantw83/cleanup-release-action@v${{ vars.CLEANUP_RELEASE_VERSION }} uses: https://gitea.jsc.idv.tw/actions/cleanup-release@${{ vars.ACTION_CLEANUP_RELEASE_VERSION }}
with: with:
gitea-server: ${{ gitea.server_url }} RUNNER_TOKEN: ${{ secrets.RUNNER_TOKEN }}
repository: ${{ gitea.repository }}
token: ${{ secrets.GITEA_TOKEN }}

10
Dockerfile Normal file
View File

@@ -0,0 +1,10 @@
FROM alpine:latest
# 安裝必要的工具
RUN apk add --no-cache --no-check-certificate bash curl jq
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]

View File

@@ -1,37 +1,17 @@
name: 'Cleanup Old Releases' name: 'CLEANUP OLD RELEASES'
description: '自動清理舊版本的 releases保留指定數量的最新版本' description: '清理舊版成品'
author: 'Jeffery'
inputs: inputs:
gitea-server: RUNNER_TOKEN:
description: 'Gitea 伺服器 URL' description: 'GitHub Runner Token'
required: true KEEP_COUNT:
repository: description: '保留的版本數量'
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
default: '2' default: '2'
dry-run:
description: '是否為模擬執行 (只顯示會刪除的版本,不實際刪除)'
required: false
default: 'false'
runs: runs:
using: 'composite' using: 'docker'
steps: image: 'Dockerfile'
- name: 清理舊版本 env:
id: cleanup GITEA_SERVER_URL: ${{ gitea.server_url }}
shell: bash GITEA_REPOSITORY: ${{ gitea.repository }}
run: chmod +x "${{ github.action_path }}/cleanup-releases.sh" && "${{ github.action_path }}/cleanup-releases.sh" "${{ inputs.gitea-server }}" "${{ inputs.repository }}" "${{ inputs.token }}" "${{ inputs.keep-count }}" "${{ inputs.dry-run }}" RUNNER_TOKEN: ${{ inputs.RUNNER_TOKEN || secrets.GITEA_TOKEN || secrets.RUNNER_TOKEN }}
KEEP_COUNT: ${{ inputs.KEEP_COUNT }}
- name: 清理舊映像
id: cleanup-images
if: inputs.package-name != ''
shell: bash
run: chmod +x "${{ github.action_path }}/cleanup-images.sh" && "${{ github.action_path }}/cleanup-images.sh" "${{ inputs.gitea-server }}" "${{ inputs.repository }}" "${{ inputs.package-name }}" "${{ inputs.token }}" "${{ inputs.keep-count }}" "${{ inputs.dry-run }}"

View File

@@ -1,107 +0,0 @@
#!/bin/bash
set -e
GITEA_SERVER="$1"
REPOSITORY="$2"
PACKAGE_NAME="$3"
TOKEN="$4"
KEEP_COUNT="$5"
DRY_RUN="$6"
echo "開始清理舊映像,保留最新 $KEEP_COUNT 個版本"
# 提取 owner 名稱
OWNER=$(echo "$REPOSITORY" | cut -d'/' -f1)
echo "Owner: $OWNER"
echo "Package: $PACKAGE_NAME"
# 獲取所有 container 版本並按創建時間排序
VERSIONS_JSON=$(curl -s "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME" \
-H "Authorization: token $TOKEN" \
-H "Accept: application/json")
# 檢查是否成功獲取版本列表
if [ $? -ne 0 ] || [ -z "$VERSIONS_JSON" ]; then
echo "錯誤:無法獲取 container 版本列表"
exit 1
fi
# 獲取並排序所有版本 (按創建時間降序)
SORTED_VERSIONS=$(echo "$VERSIONS_JSON" | jq '.versions | sort_by(.created_at) | reverse')
# 計算總數量
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 -r ".[$KEEP_COUNT:] | .[] | {id: .id, name: .name, created_at: .created_at}")
# 初始化刪除計數器和列表
DELETED_COUNT=0
DELETED_LIST="[]"
# 處理每個要刪除的版本
echo "$TO_DELETE" | jq -c '.' | while 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 '.name')
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 "HTTP_STATUS:%{http_code}" \
-X DELETE "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME/$VERSION_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 "✅ 成功刪除映像版本: $VERSION_NAME (ID: $VERSION_ID)"
DELETED_COUNT=$((DELETED_COUNT + 1))
# 更新已刪除列表
DELETED_LIST=$(echo "$DELETED_LIST" | jq ". + [{\"id\": \"$VERSION_ID\", \"version\": \"$VERSION_NAME\", \"created_at\": \"$CREATED_AT\"}]")
else
echo "❌ 刪除失敗映像版本: $VERSION_NAME (ID: $VERSION_ID), HTTP狀態: $HTTP_STATUS"
fi
fi
done
# 由於 while 迴圈在子 shell 中執行,需要重新計算
if [ "$DRY_RUN" = "true" ]; then
FINAL_DELETE_COUNT=$(echo "$TO_DELETE" | jq -s 'length')
echo "🔍 [模擬執行] 總共會刪除 $FINAL_DELETE_COUNT 個映像版本"
else
# 重新獲取並計算實際刪除的數量
NEW_VERSIONS_JSON=$(curl -s "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME" \
-H "Authorization: token $TOKEN" \
-H "Accept: application/json")
NEW_TOTAL_COUNT=$(echo "$NEW_VERSIONS_JSON" | jq '.versions | length')
ACTUAL_DELETED=$((TOTAL_COUNT - NEW_TOTAL_COUNT))
echo "✅ 清理完成,實際刪除了 $ACTUAL_DELETED 個映像版本"
fi

View File

@@ -1,97 +0,0 @@
#!/bin/bash
set -e
GITEA_SERVER="$1"
REPOSITORY="$2"
TOKEN="$3"
KEEP_COUNT="$4"
DRY_RUN="$5"
echo "開始清理舊版本,保留最新 $KEEP_COUNT 個版本"
# 獲取所有 releases 並按創建時間排序
RELEASES_JSON=$(curl -s "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases" \
-H "Authorization: token $TOKEN" \
-H "Accept: application/json")
# 檢查是否成功獲取 releases
if [ $? -ne 0 ] || [ -z "$RELEASES_JSON" ]; then
echo "錯誤:無法獲取 releases 列表"
exit 1
fi
# 計算總數量
TOTAL_COUNT=$(echo "$RELEASES_JSON" | jq 'length')
echo "目前總共有 $TOTAL_COUNT 個 releases"
# 如果總數量小於等於保留數量,則無需清理
if [ $TOTAL_COUNT -le $KEEP_COUNT ]; then
echo "releases 數量 ($TOTAL_COUNT) 未超過保留數量 ($KEEP_COUNT),無需清理"
exit 0
fi
# 計算需要刪除的數量
DELETE_COUNT=$((TOTAL_COUNT - KEEP_COUNT))
echo "需要刪除 $DELETE_COUNT 個舊版本"
# 獲取要刪除的 releases (跳過前 keep-count 個)
TO_DELETE=$(echo "$RELEASES_JSON" | jq -r ".[$KEEP_COUNT:] | .[] | {id: .id, tag: .tag_name, name: .name}")
# 初始化刪除計數器和列表
DELETED_COUNT=0
DELETED_LIST="[]"
# 處理每個要刪除的 release
echo "$TO_DELETE" | jq -c '.' | while 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')
RELEASE_NAME=$(echo "$release" | jq -r '.name')
if [ -z "$RELEASE_ID" ] || [ "$RELEASE_ID" = "null" ]; then
continue
fi
echo "準備刪除: ID=$RELEASE_ID, Tag=$RELEASE_TAG, Name=$RELEASE_NAME"
if [ "$DRY_RUN" = "true" ]; then
echo "🔍 [模擬執行] 會刪除 release: $RELEASE_TAG ($RELEASE_NAME)"
DELETED_COUNT=$((DELETED_COUNT + 1))
else
# 實際刪除
DELETE_RESPONSE=$(curl -s -w "HTTP_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: $RELEASE_TAG ($RELEASE_NAME)"
DELETED_COUNT=$((DELETED_COUNT + 1))
# 更新已刪除列表
DELETED_LIST=$(echo "$DELETED_LIST" | jq ". + [{\"id\": \"$RELEASE_ID\", \"tag\": \"$RELEASE_TAG\", \"name\": \"$RELEASE_NAME\"}]")
else
echo "❌ 刪除失敗 release: $RELEASE_TAG ($RELEASE_NAME), HTTP狀態: $HTTP_STATUS"
fi
fi
done
# 由於 while 迴圈在子 shell 中執行,需要重新計算
if [ "$DRY_RUN" = "true" ]; then
FINAL_DELETE_COUNT=$(echo "$TO_DELETE" | jq -s 'length')
echo "🔍 [模擬執行] 總共會刪除 $FINAL_DELETE_COUNT 個版本"
else
# 重新獲取並計算實際刪除的數量
NEW_RELEASES_JSON=$(curl -s "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases" \
-H "Authorization: token $TOKEN" \
-H "Accept: application/json")
NEW_TOTAL_COUNT=$(echo "$NEW_RELEASES_JSON" | jq 'length')
ACTUAL_DELETED=$((TOTAL_COUNT - NEW_TOTAL_COUNT))
echo "✅ 清理完成,實際刪除了 $ACTUAL_DELETED 個版本"
fi

81
entrypoint.sh Normal file
View File

@@ -0,0 +1,81 @@
#!/bin/bash
echo "=================================================="
echo "參數檢查"
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
# 計算成品數量並依照時間排序
RELEASE_JSON=$(echo "$RELEASE_JSON" | jq -e 'sort_by(.created_at) | reverse')
RELEASE_COUNT=$(echo "$RELEASE_JSON" | jq 'length') && echo "RELEASE_COUNT=$RELEASE_COUNT"
# 檢查成品數量是否需要清除
[ $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 "=================================================="

118
readme.md
View File

@@ -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 APIaction 會失敗並顯示錯誤訊息
- 如果某個版本刪除失敗,會記錄錯誤但繼續處理其他版本
- 如果 token 權限不足,會顯示相應的 HTTP 錯誤狀態