Compare commits
22 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| e3f3743950 | |||
|
|
cd5480b334 | ||
|
|
ea8b72ce8f | ||
| 0d7cdd65ca | |||
| 99ae6a157b | |||
| 3bd0ecaa98 | |||
|
|
146283281b | ||
|
|
9cf1a7a974 | ||
|
|
f6d27ed523 | ||
|
|
b4c9edcd69 | ||
|
|
789d08a0a6 | ||
|
|
806e385b86 | ||
|
|
c5333d4562 | ||
|
|
26b91397f1 | ||
|
|
49839e72a0 | ||
|
|
5ca3f9b08a | ||
|
|
70d30e83cd | ||
|
|
1180cacd81 | ||
|
|
6c5f158f00 | ||
|
|
b07b80d8b6 | ||
|
|
551e7bce3b | ||
|
|
1029e146e5 |
@@ -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/jiantw83/calculate-version-action@v${{ vars.CALCULATE_VERSION }}
|
||||
with:
|
||||
gitea-server: ${{ gitea.server_url }}
|
||||
repository: ${{ gitea.repository }}
|
||||
token: ${{ secrets.GITEA_TOKEN }}
|
||||
uses: https://gitea.jsc.idv.tw/actions/calculate-version@${{ vars.ACTION_CALCULATE_VERSION }}
|
||||
release:
|
||||
name: "CD > 發布專案"
|
||||
runs-on: ubuntu
|
||||
needs: version
|
||||
steps:
|
||||
- name: 發布專案
|
||||
uses: akkuman/gitea-release-action@v1
|
||||
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/jiantw83/cleanup-release-action@v${{ vars.CLEANUP_RELEASE_VERSION }}
|
||||
with:
|
||||
gitea-server: ${{ gitea.server_url }}
|
||||
repository: ${{ gitea.repository }}
|
||||
token: ${{ secrets.GITEA_TOKEN }}
|
||||
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 }}
|
||||
11
Dockerfile
Normal file
11
Dockerfile
Normal file
@@ -0,0 +1,11 @@
|
||||
FROM alpine:latest
|
||||
|
||||
# 更新並安裝必要的工具
|
||||
RUN apk update \
|
||||
&& apk add --no-cache bash curl jq
|
||||
|
||||
COPY entrypoint.sh /entrypoint.sh
|
||||
|
||||
RUN chmod +x /entrypoint.sh
|
||||
|
||||
ENTRYPOINT ["/entrypoint.sh"]
|
||||
224
action.yml
224
action.yml
@@ -1,215 +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: 'composite'
|
||||
steps:
|
||||
- name: 清理舊版本
|
||||
id: cleanup
|
||||
shell: bash
|
||||
run: |
|
||||
echo "開始清理舊版本,保留最新 ${{ inputs.keep-count }} 個版本"
|
||||
|
||||
# 獲取所有 releases 並按創建時間排序
|
||||
RELEASES_JSON=$(curl -s "${{ inputs.gitea-server }}/api/v1/repos/${{ inputs.repository }}/releases" \
|
||||
-H "Authorization: token ${{ inputs.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 ${{ inputs.keep-count }} ]; then
|
||||
echo "releases 數量 ($TOTAL_COUNT) 未超過保留數量 (${{ inputs.keep-count }}),無需清理"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# 計算需要刪除的數量
|
||||
DELETE_COUNT=$((TOTAL_COUNT - ${{ inputs.keep-count }}))
|
||||
echo "需要刪除 $DELETE_COUNT 個舊版本"
|
||||
|
||||
# 獲取要刪除的 releases (跳過前 keep-count 個)
|
||||
TO_DELETE=$(echo "$RELEASES_JSON" | jq -r ".[${{ inputs.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 [ "${{ inputs.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 "${{ inputs.gitea-server }}/api/v1/repos/${{ inputs.repository }}/releases/$RELEASE_ID" \
|
||||
-H "Authorization: token ${{ inputs.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 [ "${{ inputs.dry-run }}" = "true" ]; then
|
||||
FINAL_DELETE_COUNT=$(echo "$TO_DELETE" | jq -s 'length')
|
||||
echo "🔍 [模擬執行] 總共會刪除 $FINAL_DELETE_COUNT 個版本"
|
||||
else
|
||||
echo "✅ 清理完成,實際刪除了 $ACTUAL_DELETED 個版本"
|
||||
fi
|
||||
|
||||
- name: 清理舊映像
|
||||
id: cleanup-images
|
||||
if: ${{ inputs.package-name != '' }}
|
||||
shell: bash
|
||||
run: |
|
||||
|
||||
echo "開始清理舊映像,保留最新 ${{ inputs.keep-count }} 個版本"
|
||||
|
||||
# 提取 owner 名稱
|
||||
OWNER=$(echo "${{ inputs.repository }}" | cut -d'/' -f1)
|
||||
PACKAGE_NAME="${{ inputs.package-name }}"
|
||||
|
||||
echo "Owner: $OWNER"
|
||||
echo "Package: $PACKAGE_NAME"
|
||||
|
||||
# 獲取所有 container 版本並按創建時間排序
|
||||
VERSIONS_JSON=$(curl -s "${{ inputs.gitea-server }}/api/v1/packages/$OWNER/container/$PACKAGE_NAME" \
|
||||
-H "Authorization: token ${{ inputs.token }}" \
|
||||
-H "Accept: application/json")
|
||||
|
||||
# 檢查是否成功獲取版本列表
|
||||
if [ $? -ne 0 ] || [ -z "$VERSIONS_JSON" ]; then
|
||||
echo "錯誤:無法獲取 container 版本列表"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 獲取並排序所有版本 (按創建時間降序)
|
||||
SORTED_VERSIONS=$(echo "$VERSIONS_JSON" | jq -r '.versions | sort_by(.created_at) | reverse')
|
||||
|
||||
# 計算總數量
|
||||
TOTAL_COUNT=$(echo "$SORTED_VERSIONS" | jq 'length')
|
||||
echo "目前總共有 $TOTAL_COUNT 個映像版本"
|
||||
|
||||
# 如果總數量小於等於保留數量,則無需清理
|
||||
if [ $TOTAL_COUNT -le ${{ inputs.keep-count }} ]; then
|
||||
echo "映像數量 ($TOTAL_COUNT) 未超過保留數量 (${{ inputs.keep-count }}),無需清理"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# 計算需要刪除的數量
|
||||
DELETE_COUNT=$((TOTAL_COUNT - ${{ inputs.keep-count }}))
|
||||
echo "需要刪除 $DELETE_COUNT 個舊映像"
|
||||
|
||||
# 獲取要刪除的版本 (跳過前 keep-count 個)
|
||||
TO_DELETE=$(echo "$SORTED_VERSIONS" | jq -r ".[${{ inputs.keep-count }}:]")
|
||||
|
||||
# 初始化刪除計數器和列表
|
||||
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 [ "${{ inputs.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 "${{ inputs.gitea-server }}/api/v1/packages/$OWNER/container/$PACKAGE_NAME/$VERSION_ID" \
|
||||
-H "Authorization: token ${{ inputs.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 [ "${{ inputs.dry-run }}" = "true" ]; then
|
||||
FINAL_DELETE_COUNT=$(echo "$TO_DELETE" | jq 'length')
|
||||
echo "🔍 [模擬執行] 總共會刪除 $FINAL_DELETE_COUNT 個映像版本"
|
||||
else
|
||||
# 重新獲取並計算實際刪除的數量
|
||||
NEW_VERSIONS_JSON=$(curl -s "${{ inputs.gitea-server }}/api/v1/packages/$OWNER/container/$PACKAGE_NAME" \
|
||||
-H "Authorization: token ${{ inputs.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
|
||||
using: 'docker'
|
||||
image: 'Dockerfile'
|
||||
env:
|
||||
GITEA_SERVER_URL: ${{ gitea.server_url }}
|
||||
GITEA_REPOSITORY: ${{ gitea.repository }}
|
||||
RUNNER_TOKEN: ${{ secrets.RUNNER_TOKEN }}
|
||||
KEEP_COUNT: ${{ inputs.KEEP_COUNT }}
|
||||
81
entrypoint.sh
Normal file
81
entrypoint.sh
Normal 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')
|
||||
|
||||
# 檢查成品數量是否需要清除
|
||||
[ $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
118
readme.md
@@ -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 錯誤狀態
|
||||
Reference in New Issue
Block a user