mirror of
https://github.com/actions/upload-artifact.git
synced 2024-11-24 12:12:09 +00:00
66 lines
3 KiB
YAML
66 lines
3 KiB
YAML
name: 'Merge Build Artifacts'
|
|
description: 'Merge one or more build Artifacts'
|
|
author: 'GitHub'
|
|
inputs:
|
|
name:
|
|
description: 'The name of the artifact that the artifacts will be merged into.'
|
|
required: true
|
|
default: 'merged-artifacts'
|
|
pattern:
|
|
description: 'A glob pattern matching the artifact names that should be merged.'
|
|
default: '*'
|
|
if-no-files-found:
|
|
description: >
|
|
The desired behavior if no artifacts are found using the provided pattern.
|
|
|
|
Available Options:
|
|
warn: Output a warning but do not fail the action
|
|
error: Fail the action with an error message
|
|
ignore: Do not output any warnings or errors, the action does not fail
|
|
default: 'error'
|
|
separate-directories:
|
|
description: 'When multiple artifacts are matched, this changes the behavior of how they are merged in the archive.
|
|
If true, the matched artifacts will be extracted into individual named directories within the specified path.
|
|
If false, the matched artifacts will combined in the same directory.'
|
|
default: 'false'
|
|
retention-days:
|
|
description: >
|
|
Duration after which artifact will expire in days. 0 means using default retention.
|
|
|
|
Minimum 1 day.
|
|
Maximum 90 days unless changed from the repository settings page.
|
|
compression-level:
|
|
description: >
|
|
The level of compression for Zlib to be applied to the artifact archive.
|
|
The value can range from 0 to 9:
|
|
- 0: No compression
|
|
- 1: Best speed
|
|
- 6: Default compression (same as GNU Gzip)
|
|
- 9: Best compression
|
|
Higher levels will result in better compression, but will take longer to complete.
|
|
For large files that are not easily compressed, a value of 0 is recommended for significantly faster uploads.
|
|
default: '6'
|
|
delete-merged:
|
|
description: >
|
|
If true, the artifacts that were merged will be deleted.
|
|
If false, the artifacts will still exist.
|
|
default: 'false'
|
|
|
|
outputs:
|
|
artifact-id:
|
|
description: >
|
|
A unique identifier for the artifact that was just uploaded. Empty if the artifact upload failed.
|
|
|
|
This ID can be used as input to other APIs to download, delete or get more information about an artifact: https://docs.github.com/en/rest/actions/artifacts
|
|
artifact-url:
|
|
description: >
|
|
A download URL for the artifact that was just uploaded. Empty if the artifact upload failed.
|
|
|
|
This download URL only works for requests Authenticated with GitHub. Anonymous downloads will be prompted to first login.
|
|
If an anonymous download URL is needed than a short time restricted URL can be generated using the download artifact API: https://docs.github.com/en/rest/actions/artifacts#download-an-artifact
|
|
|
|
This URL will be valid for as long as the artifact exists and the workflow run and repository exists. Once an artifact has expired this URL will no longer work.
|
|
Common uses cases for such a download URL can be adding download links to artifacts in descriptions or comments on pull requests or issues.
|
|
runs:
|
|
using: 'node20'
|
|
main: '../dist/merge/index.js'
|