atos-actions/Tar and Upload a Build Artifact
Pack files in a tar archive and upload a build artifact that can be used by subsequent workflow steps
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| name | Artifact name | — | artifact |
| path | A file, directory or wildcard pattern (one per line) that describes what to upload. Lines starting with '!' are treated as exclusion patterns and will be omitted from the archive (passed to tar via --exclude). | yes | — |
| directory | Change to DIR before performing any operations. This option is order-sensitive, i.e. it affects all optionsthat follow. | — | . |
| if-no-files-found | The desired behavior if no files are found using the provided path. 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 | — | warn |
| retention-days | 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 | 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. | — | 6 |
| overwrite | If true, an artifact with a matching name will be deleted before a new one is uploaded. If false, the action will fail if an artifact for the given name already exists. Does not fail if the artifact does not exist. | — | false |
Outputs
| name | description |
|---|---|
| artifact-id | 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 | 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. |