如何在每次提交推送时 运行 在 GitHub 工作流中提交 commitlint

How to run commitlint in GitHub workflow on every commit of a push

我有一个 Github 存储库,在本地安装 commitlint and husky 并且想在验证拉取请求时在每次推送提交时设置一个工作流 运行ning commitlint。 在主分支上,较旧的提交不遵循常规提交规则。

我根据这条评论创建了一个单独的分支

https://github.com/conventional-changelog/commitlint/issues/586#issuecomment-657226800

我开始使用这个工作流程

name: Run commitlint on pull request

on: pull_request

jobs:
  run-commitlint-on-pull-request:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2
        with:
          fetch-depth: 0

      - name: Setup Node
        uses: actions/setup-node@v2
        with:
          node-version: 14.x

      - name: Install dependencies
        run: npm install

      - name: Validate all commits from PR
        run: npx commitlint --from HEAD~${{ github.event.pull_request.commits }} --to HEAD --verbose

我按照常规提交规则又进行了两次提交并开始了拉取请求

我想到的第一个解决方案是重新定义所有内容并重命名每个提交以遵循规则,但这需要付出巨大的努力。

我不确定我是否必须在这里改进这条线

npx commitlint --from HEAD~${{ github.event.pull_request.commits }} --to HEAD --verbose

仅检查来自 PR 的提交(不幸的是我不知道那里需要修复什么)。

您有什么想法或者变基和重命名是唯一的解决方案吗?

git rev-list 被认为是因为拉取请求 (PR) 的提交似乎无效。不需要循环。

issue 提示检查 PR 分支,这似乎比获取 PR 提交更简单。从问题来看,似乎不需要在默认分支上进行测试。

- uses: actions/checkout@v2
        with:
          fetch-depth: 0
          ref: ${{ github.event.pull_request.base.sha }}

lint 指令为:

npx commitlint --from ${{ github.event.pull_request.base.sha }} --verbose

pull-request payload 的文档 不立即提供提交列表。

解决方案

直接的解决方案是使用 commitlint--to--from 参数以及 SHA-1 值 而不是分支名称或相对引用。一方面,这可靠地解决了工作树中未知修订或路径的问题。另一方面,只会检查 PR 范围内的提交。作为旁注:GitHub 对正在签出的临时合并使用相同的引用 (SHA-1)。

我们需要 base-SHA 以及 head-SHA。在 GitHub 操作中,这些值在 github 上下文中事件的拉取请求对象中可用。

因此,您可以使用经过测试并按预期工作的以下行:

npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose

演示

这里有一个 POC repository on GitHub 有 3 个测试用例(拉取请求)。

完成工作流程

name: Run Commitlint on PR

on:
  pull_request:

jobs:

  run-commitlint-on-pr:
    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@v2
        with:
          fetch-depth: 0

      - name: Setup Node
        uses: actions/setup-node@v2
        with:
          node-version: 14.x

      - name: Install dependencies
        run: npm install

      - name: Validate all commits from PR
        run: npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose