GitHub Actions CI 条件正则表达式

Question

我正在尝试将 CI 工作流程从 CircleCI 转移到 GitHub Actions。我面临的最后一个主要难题是部署。

目前我的工作流程是这样的，当我将标签推送到我的 GitHub 存储库时，它将运行测试，然后运行部署。只有当标签与正则表达式匹配时，CircleCI 过滤标签才运行作业：/v[0-9]+(\.[0-9]+)*/。

如何在运行部署之前检查以确保我推送的标签与上面的正则表达式模式匹配？

我目前有以下 GitHub Actions yml 文件：

name: CI
on: [create]

jobs:
  # ...

  deploy:
    runs-on: ubuntu-latest
    if: github.event.ref_type == 'tag' && github.event.ref == SOMETHING HERE
    steps:
      - uses: actions/checkout@v1
      # ...

在if 块下，我需要将github.event.ref == SOMETHING HERE 更改为其他内容。我查看了Contexts and expression syntax for GitHub Actions 文档页面。但由于 GitHub Actions 的灵活和强大，似乎应该有一种方法或方式来做到这一点，或者至少是某种解决方法。

如何确保标签 (github.event.ref) 与正则表达式模式 (/v[0-9]+(\.[0-9]+)*/) 匹配？

Answer 1

不幸的是，我认为目前还没有任何方法可以对if 条件表达式进行正则表达式匹配。

一种选择是对push 事件使用过滤。

on:
  push:
    tags:
      - 'v*.*.*'

另一种选择是在creates a step output 的单独步骤中进行正则表达式检查。然后可以在 if 条件中使用它。

      - name: Check Tag
        id: check-tag
        run: |
          if [[ ${{ github.event.ref }} =~ ^refs/tags/v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
              echo ::set-output name=match::true
          fi
      - name: Build
        if: steps.check-tag.outputs.match == 'true'
        run: |
          echo "Tag is a match"

Answer 2

根据docs，您可以这样做：

on:
  create:
    tags:
      - "v[0-9]+.[0-9]+"

我尝试了上述方法并且可以确认它有效。这不是完整的正则表达式功能，但应该足以满足您的需求。

Answer 3

我已经设法通过两部分方法实现了这一点。第一部分包括过滤您想要运行的标签。第二部分是为您的 deploy 作业创建条件。

我的工作流程的精简版如下所示：

name: CI-CD

on:
  push:
    branches:
    - stable
    tags:
    - '[0-9]+.[0-9]+.[0-9]+'
    - '[0-9]+.[0-9]+.[0-9]+rc[0-9]+'
  pull_request:
    branches:
    - stable


jobs:
  test:
    steps:
      ...

  deploy:
    needs: test
    if: startsWith(github.ref, 'refs/tags')
    steps:
      ...

我针对特定分支的推送、标签和拉取请求运行我的工作流程。您可以根据自己想要过滤标签的方式获得创意。 Check out the filter patterns.

我有点挣扎的是如何设置正确的条件来运行deploy 作业。我决定了以下几点：

needs: test

确保它仅在test 作业成功时运行。

然后我滥用github.ref 将是'refs/heads/stable' 推送到分支和'refs/tags/<your tag>' 推送标签的事实。所以我只是用以下条件来测试这种差异。

if: startsWith(github.ref, 'refs/tags')

对我来说就像一个魅力，但可能取决于你的设置。

当然，您也可以创建单独的工作流程，但就我而言，我总是想先运行测试套件。