探索 @actions/upload-artifact
v4:加速你的工作流程
upload-artifact 项目地址: https://gitcode.com/gh_mirrors/up/upload-artifact
项目介绍
@actions/upload-artifact
是一个强大的 GitHub Actions 插件,用于从工作流程运行中上传 Actions Artifacts。这个插件由 @actions/artifact 包提供支持,能够帮助开发者轻松管理和共享工作流程中的文件和数据。
项目技术分析
v4 版本的新特性
@actions/upload-artifact
v4 版本带来了多项重大改进和突破性变化:
改进
- 显著的性能提升:上传速度大幅提升,最坏情况下也有高达 90% 的改进。
- 即时可用性:上传后,Artifact 立即在 UI 和 REST API 中可用,无需等待工作流程完成。
- 不可变存档:Artifact 内容被上传到一个不可变的存档中,减少了文件被意外篡改的可能性。
- 压缩级别可调:开发者可以根据速度或大小需求手动调整压缩级别。
突破性变化
- 防火墙规则:自托管运行器可能需要额外的防火墙规则。
- 多次上传同名 Artifact:不再支持多次上传同名 Artifact,必须使用不同的名称或仅上传一次。
- Artifact 数量限制:每个作业的 Artifact 数量限制为 500 个。
- 默认排除隐藏文件:
v4.4
及更高版本默认排除隐藏文件。
项目及技术应用场景
@actions/upload-artifact
适用于多种场景,包括但不限于:
- 持续集成/持续部署 (CI/CD):在构建和部署过程中上传和下载构建工件。
- 测试结果存储:上传测试结果以便后续分析和报告。
- 版本控制和发布管理:上传发布版本以便分发和存档。
项目特点
灵活的上传选项
- 单个文件或整个目录:支持上传单个文件或整个目录。
- 通配符模式:支持使用通配符模式上传多个文件。
- 多路径和排除:支持指定多个路径和排除特定文件。
高级功能
- 压缩级别调整:根据需求调整压缩级别,平衡速度和文件大小。
- 自定义无文件处理:自定义当找不到文件时的行为,如警告、错误或忽略。
- 覆盖现有 Artifact:支持覆盖同名 Artifact,避免上传失败。
安全性和可靠性
- 不可变存档:确保上传的文件不会被意外修改。
- 即时可用性:上传后立即在 UI 和 API 中可用,提高工作流程的响应速度。
结语
@actions/upload-artifact
v4 版本通过多项改进和新增功能,显著提升了工作流程的效率和可靠性。无论你是开发新手还是资深开发者,这个插件都能帮助你更轻松地管理和共享工作流程中的文件和数据。立即升级到 v4 版本,体验前所未有的工作流程加速!
注意:@actions/upload-artifact
v3 及更早版本计划于 2024 年 11 月 30 日弃用,请尽快更新你的工作流程以使用 v4 版本。
upload-artifact 项目地址: https://gitcode.com/gh_mirrors/up/upload-artifact