動作自動釋放

GitHub 自動發布

此操作透過自動上傳資產、產生變更日誌、處理預發布等來簡化 GitHub 發布流程。

內容

1. 使用範例
2. 支援的參數
3. 事件觸發器
4. 版本控制
5. 如何獲得協助
6. 執照

注意： marvinpinto/action-automatic-releases儲存庫是包含此操作和其他操作的 marvinpinto/actions monorepo 自動產生的鏡像。請在那裡提交問題並拉取請求。

使用範例

當變更發生在 master 上時自動產生預發布

一旦變更發生在master上，此範例工作流程就會啟動。運行建置和測試專案的步驟後：

1. 它將創建（或替換）一個名為latest的 git 標籤。
2. 根據此標籤與上一個latest標籤之間的所有提交產生變更日誌。
3. 產生與latest標籤關聯的新版本（刪除任何先前的關聯版本）。
4. 使用指定的標題更新此新版本（例如Development Build ）。
5. 上傳LICENSE.txt和任何jar檔案作為發布資產。
6. 將此版本標記為pre-release 。

您可以在 marvinpinto/actions 上查看此工作流程的工作範例。

---
name : " pre-release "

on :
  push :
    branches :
      - " master "

jobs :
  pre-release :
    name : " Pre Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          automatic_release_tag : " latest "
          prerelease : true
          title : " Development Build "
          files : |
            LICENSE.txt
            *.jar

當標籤推送到儲存庫時建立新的 GitHub 版本

與前面的範例類似，一旦新標籤推送到 GitHub，此工作流程就會啟動。建置並測試您的專案後：

1. 從此標記與上一個 semver 標記之間的所有提交產生變更日誌。
2. 產生新版本並將其與此標籤關聯。
3. 上傳LICENSE.txt和任何jar檔案作為發布資產。

marvinpinto/actions 上又有一個這樣的例子。

---
name : " tagged-release "

on :
  push :
    tags :
      - " v* "

jobs :
  tagged-release :
    name : " Tagged Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          prerelease : false
          files : |
            LICENSE.txt
            *.jar 

支援的參數

範圍	描述	預設
repo_token **	GitHub Action 令牌，例如"${{ secrets.GITHUB_TOKEN }}" 。	null
draft	將此版本標記為草稿？	false
prerelease	將此版本標記為預版本嗎？	true
automatic_release_tag	用於自動發布的標籤名稱，例如latest 。	null
title	發布標題；如果未指定，則預設為標籤名稱。	標籤名稱
files	作為發布資產的一部分上傳的文件。	null

輸出

可以透過${{ steps..outputs. }}存取以下輸出值：

姓名	描述	類型
automatic_releases_tag	此操作剛剛處理的發布標籤	細繩
upload_url	用於將其他資產上傳到版本的 URL	細繩

筆記：

• 帶**的參數為必填項。
• files參數支援多行 glob 模式，請參閱儲存庫範例。

事件觸發器

GitHub Actions 框架可讓您對許多事件組合觸發此（和其他）操作。例如，您可以為候選版本標籤建立特定的預版本（例如*-rc* ）、在主版本發生變更時產生版本（上面的範例）、夜間版本等等。通讀 GitHub Actions 的工作流程語法以獲取想法和高級範例。

版本控制

該專案在 master 上的每次提交都會觸發自動建置以及名為latest的標記發布。如果您不想生活在最前沿，您可以使用穩定版本。請參閱可用版本的發行版。

"">

- uses : " marvinpinto/action-automatic-releases@ " 

如何獲得協助

該專案的主要自述文件包含大量與調試和提交問題相關的資訊。如果您仍然遇到困難，請嘗試在 keybase 上聯繫我，我會盡力幫助您。

執照

該專案的源代碼是根據 MIT 許可證發布的。該專案與 GitHub 沒有關聯。