actions/upload-artifact
Upload Artifact
This project is a build artifact manager and file persistence tool designed to save files and directories from a workflow run as archived assets. It functions as a workflow asset archiver that compresses and uploads project files to a remote store.
The system differentiates itself through a comprehensive metadata tracking system that generates unique identifiers, download URLs, and security digests for every uploaded asset. It manages the asset lifecycle using configurable retention policies to determine how long files remain available before automatic deletion and supports updating existing assets via overwrite capabilities.
The tool covers broad capability areas including file operations, where it uses glob patterns for resolution and directory prefixing to avoid filename collisions during artifact merging. It also provides configurable archive compression to balance upload speed against storage size and includes logic to handle missing files during the upload process.
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.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
