lpenz/ghaction-version-gen

ghaction-version-gen

ghaction-version-gen是一个Docker GitHub Action，它输出版本号供您在部署操作中使用。

有许多方法可以为仓库生成版本信息。它们通常涉及以某种方式处理GITHUB_REF，甚至可能使用https://github.com/actions/github-script%E3%80%82

本仓库也是一个示例，展示如何创建Docker GitHub Action，该Action在容器中编译Rust入口点，然后将其移动到第二个最小容器中。

输出

以下是此Action的主要输出，通常用于版本控制：

• version_tagged: 对于只应在标签上部署的仓库，当GitHub事件是标签推送时定义。

  输出本身是标签，可选的v前缀已被移除。

• version_commit: 对于在所有master或main分支提交上部署的仓库，当GitHub事件是这些分支的推送时定义。

  输出本身是分支上最近的标签（可选的v前缀已被移除），后跟分支与标签之间的距离。

此方案的思路是允许用户检查version_tagged或version_commit是否非空，在这种情况下将其用作要部署的版本：

yaml
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - id: version
        uses: docker://lpenz/ghaction-version-gen:0.3
      - name: deploy
        uses: <部署操作>
        if: steps.version.outputs.version_tagged != ''
        with:
          version: ${{ steps.version.outputs.version_tagged }}

同样的方法适用于version_commit。请记住，要使其在标记的提交上工作，您可能需要在提交之前推送标签，这可能与直觉相反。

次要输出

以下是可能对调试或作为替代版本控制方案有用的次要输出：

• is_push: 如果识别到GitHub事件，当事件是推送时为"true"，否则为"false"。
• is_tag: 如果识别到GitHub引用，当引用是标签时为"true"，否则为"false"。
• is_main: 当GitHub引用是名为main或master的分支时为"true"。
• is_push_tag: 当推送了标签时为"true"。
• is_push_main: 当推送了main或master分支时为"true"。
• commit: 提交的哈希值。
• git_describe_tags: git describe --tags的输出。
• tag_latest: 最近的标签。
• distance: 当前提交与tag_latest之间的距离。
• tag_distance: tag_latest-distance
• tag_head: HEAD上的标签（如果HEAD上有标签），不依赖于GitHub事件。
• dash_distance: 前缀为-的distance。
• tag_latest_ltrimv: 不带可选前导v的tag_latest。
• tag_head_ltrimv: 如果定义了tag_head，则为不带可选前导v的tag_head。
• version_tagged: 如果is_push_tag为true，则为tag_head_ltrimv。
• version_commit: 如果is_push_main为true，则为tag_distance_ltrimv。