actions/upload-artifact
Upload Artifact
Ce projet est un gestionnaire d'artefacts de build et un outil de persistance de fichiers conçu pour enregistrer des fichiers et des répertoires à partir d'une exécution de flux de travail en tant qu'actifs archivés. Il fonctionne comme un archiveur d'actifs de flux de travail qui compresse et télécharge les fichiers de projet vers un magasin distant.
Le système se différencie par un système complet de suivi des métadonnées qui génère des identifiants uniques, des URL de téléchargement et des digests de sécurité pour chaque actif téléchargé. Il gère le cycle de vie des actifs en utilisant des politiques de rétention configurables pour déterminer combien de temps les fichiers restent disponibles avant suppression automatique et prend en charge la mise à jour des actifs existants via des capacités d'écrasement.
L'outil couvre de larges domaines de capacités, incluant les opérations sur les fichiers, où il utilise des modèles glob pour la résolution et le préfixage de répertoire pour éviter les collisions de noms de fichiers lors de la fusion d'artefacts. Il fournit également une compression d'archive configurable pour équilibrer la vitesse de téléchargement par rapport à la taille de stockage et inclut une logique pour gérer les fichiers manquants pendant le processus de téléchargement.
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.
