kusold/Upload Artifact to S3
Upload a build artifact to S3 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 that describes what to upload | yes | — |
| 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 |
| include-hidden-files | If true, hidden files will be included in the artifact. If false, hidden files will be excluded from the artifact. | — | false |
| s3-bucket | S3 bucket name for storing artifacts | yes | — |
| s3-prefix | Optional prefix path within the bucket (e.g., "artifacts/") | no | — |
| s3-endpoint | S3-compatible endpoint URL (for MinIO, Cloudflare R2, etc.) | no | — |
| s3-region | AWS region for the S3 bucket | — | us-east-1 |
| s3-force-path-style | Force path-style URLs (required for some S3-compatible stores) | — | false |
Outputs
| name | description |
|---|---|
| artifact-id | A unique identifier for the artifact that was just uploaded. Empty if the artifact upload failed. |
| artifact-url | The S3 URL for the artifact that was just uploaded. Empty if the artifact upload failed. |
| artifact-digest | SHA-256 digest for the artifact that was just uploaded. Empty if the artifact upload failed. |