actions/upload-artifact
Upload Artifact
该项目是一个构建工件管理器和文件持久化工具，旨在将工作流运行中的文件和目录保存为归档资产。它作为一个工作流资产归档器，压缩并将项目文件上传到远程存储。
该系统通过全面的元数据跟踪系统脱颖而出，该系统为每个上传的资产生成唯一标识符、下载 URL 和安全摘要。它使用可配置的保留策略管理资产生命周期，以确定文件在自动删除前保留多长时间，并支持通过覆盖功能更新现有资产。
该工具涵盖了广泛的功能领域，包括文件操作，它使用 Glob 模式进行解析，并使用目录前缀以避免工件合并期间的文件名冲突。它还提供可配置的归档压缩以平衡上传速度与存储大小，并包含在上传过程中处理缺失文件的逻辑。
Features
- Workflow Artifact Managers - Provides functions to upload, download, and cache build artifacts and dependencies across workflow runs.
- CI Artifact Managers - Functions as a CI artifact manager for storing, versioning, and managing build outputs and logs.
- Artifact Identifier Retrieval - Returns a unique identifier after every successful upload to track and manage assets through external interfaces.
- HTTP File Transfer Utilities - Transfers archived assets to an external storage service using HTTP requests for persistence.
- Artifact Metadata Identification - Generates and retrieves unique identifiers and checksums for uploaded assets to enable tracking across workflow steps.
- GitHub Actions Workflows - Saves files and directories from a workflow run as archived assets specifically within GitHub Actions.
- Artifact Uploaders - Saves files and directories from a workflow run as archived assets in GitHub Actions.
- Build Artifact Management - Provides a system for listing, filtering, and retrieving versions of software build outputs.
- Build Result Persistence - Stores the outcomes of CI runs as persistent objects to be passed between different jobs.
- Artifact Lifecycle Management - Manages the lifecycle of build artifacts using custom compression and automated retention policies.
- Workflow Asset Archivers - Compresses and uploads project files to remote storage with configurable retention and expiration policies.
- Artifact Uploaders - Stores files and directories from a workflow run as named assets using wildcards and custom compression levels.
- Workflow Asset Tracking - Generates unique identifiers and security digests to track assets across different workflow steps.
- Artifact Passing - Implements mechanisms for transferring files between different jobs or stages within a single automated pipeline run.
- Globbing Pattern Matching - Identifies target files and directories for upload using glob patterns and wildcards.
- Compression Level Tuning - Provides adjustable compression parameters to balance the trade-off between upload speed and resulting storage size.
- Artifact Merging - Combines multiple separate files into a single consolidated artifact using patterns and directory prefixes.
- Build Archive Compression - Provides configurable archive compression to balance upload speed and storage size for build artifacts.
- Glob-Based File Location - Uses glob patterns and wildcards to identify target files and directories for upload.
- Retention Policies - Assigns time-to-live values to assets to trigger automatic deletion by the remote storage backend.
- Artifact Overwriting - Updates an existing asset with a new version to generate a fresh unique identifier for the file.
- Collision-Avoidance Directory Prefixing - Prevents filename conflicts when merging multiple assets by mapping source files into unique directory paths.
- Pre-Upload Compression - Compresses files into archives before transferring them to remote storage to optimize bandwidth.
- Test Report Attachments - Enables embedding supplementary files like screenshots and logs into test execution reports.
- Core Workflow Actions - Upload artifacts from your workflow.
