GitHub Action 下载工作流程制品

一个用于下载和提取与特定工作流程和提交或其他条件相关的已上传制品的 Action。

假设你有一个工作流程，其中的作业最后使用 actions/upload-artifact action 上传了一个制品，而你想在另一个在第一个工作流程之后运行的工作流程中下载这个制品。官方的 actions/download-artifact 不允许这样做。这就是我创建这个 action 的原因。只需知道工作流程名称和提交 SHA 或其他详细信息，你就可以从与该提交或其他条件相关的不同工作流程中下载先前上传的制品并使用它。

用法

如果未指定 commit、pr、branch、run_id 或 workflow_conclusion，则将下载最近成功完成的工作流程运行中的制品。

不要同时指定 pr、commit、branch、run_id，或同时指定 workflow_conclusion 和 run_id。只选择其中之一或不选。

- name: 下载制品
  id: download-artifact
  uses: dawidd6/action-download-artifact@v6
  with:
    # 可选，GitHub 令牌，如果需要，可使用具有 `public_repo` 范围的个人访问令牌
    # 如果制品来自不同的仓库，则必需
    # 如果仓库是私有的，则需要具有 `repo` 范围的个人访问令牌，或在权限设置了 `action` 范围为 `read` 的作业中使用 GitHub 令牌
    github_token: ${{secrets.GITHUB_TOKEN}}
    # 可选，工作流程文件名或 ID
    # 如果未指定，将从 run_id 推断（如果指定了 run_id），或使用当前工作流程
    workflow: workflow_name.yml
    # 如果未设置工作流程且 workflow_search 设置为 true，则将查找最近匹配所有其他条件的工作流程，而不是使用当前工作流程
    workflow_search: false
    # 可选，要搜索的已完成工作流程的状态或结论
    # 可以是工作流程结论之一：
    #   "failure"、"success"、"neutral"、"cancelled"、"skipped"、"timed_out"、"action_required"
    # 或工作流程状态：
    #   "completed"、"in_progress"、"queued"
    # 使用空字符串（""）忽略搜索中的状态或结论
    workflow_conclusion: success
    # 可选，将获取头部提交 SHA
    pr: ${{github.event.pull_request.number}}
    # 可选，如果指定了 PR 则无需指定
    commit: ${{github.event.pull_request.head.sha}}
    # 可选，将使用指定的分支。默认为所有分支
    branch: master
    # 可选，默认为所有类型
    event: push
    # 可选，将使用指定的工作流程运行
    # 当你的 action 在 workflow_run 事件中运行并想从触发的工作流程运行中下载时，使用 ${{ github.event.workflow_run.id }}
    run_id: 1122334455
    # 可选，工作流程的运行编号
    run_number: 34
    # 可选，上传的制品名称
    # 如果未指定，将下载所有制品
    # 并将它们提取到相应的子目录中
    # https://github.com/actions/download-artifact#download-all-artifacts
    # 如果输入 name_is_regexp 为 true，则被视为正则表达式
    # 将只下载名称与此正则表达式匹配的制品
    # https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions
    name: artifact_name
    # 可选，如果设置为 true，则名称被视为正则表达式
    name_is_regexp: true
    # 可选，提取制品的目录，默认为当前目录
    path: extract_here
    # 可选，默认为当前仓库
    repo: ${{ github.repository }}
    # 可选，检查工作流程运行是否有制品
    # 然后将从上一个工作流程获取最后可用的制品
    # 默认为 false，只尝试从最后一个下载
    check_artifacts: false
    # 可选，搜索存储了名为 `name` 输入的制品的最后一个工作流程运行
    # 默认为 false
    search_artifacts: false
    # 可选，选择跳过解压下载的制品
    # 默认为 false
    skip_unpack: false
    # 可选，选择在未找到制品时如何退出 action
    # 可以是以下之一：
    #  "fail"、"warn"、"ignore"
    # 默认为 fail
    if_no_artifact_found: fail
    # 可选，搜索制品时包括 fork
    # 默认为 false
    allow_forks: true