2019-06-25 04:38:44 +08:00
# upload-artifact
2019-07-24 03:24:56 +08:00
2019-08-03 02:13:17 +08:00
This uploads artifacts from your workflow.
2019-07-24 03:24:56 +08:00
2019-09-09 13:36:31 +08:00
See also [download-artifact ](https://github.com/actions/download-artifact ).
2019-07-24 03:24:56 +08:00
# Usage
See [action.yml ](action.yml )
2019-07-24 03:35:48 +08:00
Basic:
2019-07-24 03:24:56 +08:00
```yaml
2019-07-26 09:33:03 +08:00
steps:
2019-08-28 20:44:51 +08:00
- uses: actions/checkout@v1
2019-07-24 03:24:56 +08:00
- run: mkdir -p path/to/artifact
- run: echo hello > path/to/artifact/world.txt
2019-11-13 06:29:16 +08:00
- uses: actions/upload-artifact@v1
2019-07-24 03:24:56 +08:00
with:
name: my-artifact
path: path/to/artifact
```
2019-10-14 03:21:48 +08:00
To upload artifacts only when the previous step of a job failed, use [`if: failure()` ](https://help.github.com/en/articles/contexts-and-expression-syntax-for-github-actions#job-status-check-functions ):
```yaml
2019-11-26 02:12:56 +08:00
- uses: actions/upload-artifact@v1
2019-10-14 03:21:48 +08:00
if: failure()
with:
name: my-artifact
path: path/to/artifact
```
2019-08-21 03:25:46 +08:00
## Where does the upload go?
In the top right corner of a workflow run, once the run is over, if you used this action, there will be a `Artifacts` dropdown which you can download items from. Here's a screenshot of what it looks like< br />
2019-07-24 03:24:56 +08:00
# License
The scripts and documentation in this project are released under the [MIT License ](LICENSE )
