Skip to content

GitHub Action之Checkout

主要解决actions/checkout@v4中可能拉取的分支不是最新的问题。

修正checkout最新提交

场景

网站部署，但是前置依赖有更新文档并自动提交 git，结果网站发布的不是最新提交的（即没有包含 git 自动提交的内容）。

YAML
# ...
jobs:
  process:
    permissions:
      contents: write
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4
      - name: something ... # 这里执行执行同时自动提交
      - name: Git auto commit
        uses: stefanzweifel/git-auto-commit-action@v5
        with:
          commit_message: Automated Change

  deploy:
    needs: process
    permissions:
      pages: write
      id-token: write
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}

    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.ref }} # 这是改正后的，没有这个就是次新提交，和process阶段一样的版本
      - name: Latest git log
        run: git log -1 --pretty=format:"%h %s (%an, %ar)"

      - uses: actions/configure-pages@v4
      - uses: actions/upload-pages-artifact@v3
        with:
          path: "./site"
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

解决

增加ref: ${{ github.ref }}或者是分支名ref: main

YAML
# 见 https://github.com/actions/checkout/issues/439#issuecomment-1464126822
- name: Checkout
  uses: actions/checkout@v4
  with:
    ref: ${{ github.ref }}

submodule 同步

YAML
# ...
jobs:
  deploy:
    # permissions:
    # environment:

  runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        # 方式1
        # with:
        #   submodule: 'recursive'
      # 方式2
      - name: Sync submodules
        run: git submodule update --init --recursive --depth=1

参考

Comments