Go to file
Konrad Pabjan 9fde3de0b7
Merge branch 'master' into v2-preview
2020-04-28 14:20:34 +02:00
.github/workflows Update test YAML 2020-04-28 14:17:18 +02:00
dist Update @actions/artifact to 0.3.1 2020-04-23 12:36:47 +02:00
src V2 Preview (#19) 2020-03-13 14:46:09 +01:00
.eslintignore V2 Preview (#19) 2020-03-13 14:46:09 +01:00
.eslintrc.json V2 Preview (#19) 2020-03-13 14:46:09 +01:00
.gitattributes Add .gitattributes 2020-04-28 11:43:05 +02:00
.gitignore V2 Preview (#19) 2020-03-13 14:46:09 +01:00
.prettierignore V2 Preview (#19) 2020-03-13 14:46:09 +01:00
.prettierrc.json V2 Preview (#19) 2020-03-13 14:46:09 +01:00
LICENSE Create LICENSE 2019-07-23 15:29:14 -04:00
README.md Update Readme 2020-04-28 12:58:56 +02:00
action.yml V2 Preview (#19) 2020-03-13 14:46:09 +01:00
package-lock.json Update @actions/artifact to 0.3.1 2020-04-23 12:36:47 +02:00
package.json Update @actions/artifact to 0.3.1 2020-04-23 12:36:47 +02:00
tsconfig.json V2 Preview (#19) 2020-03-13 14:46:09 +01:00

README.md

Download-Artifact v2

This downloads artifacts from your build

See also upload-artifact.

What's new

  • Download all artifacts at once
  • Port entire action to typescript from a runner plugin so it is easier to collaborate and accept contributions

Refer here for the previous version

Usage

See action.yml

Download a Single Artifact

Basic (download to the current working directory):

steps:
- uses: actions/checkout@v2

- uses: actions/download-artifact@v2
  with:
    name: my-artifact
    
- name: Display structure of downloaded files
  run: ls -R

Download to a specific directory:

steps:
- uses: actions/checkout@v2

- uses: actions/download-artifact@v2
  with:
    name: my-artifact
    path: path/to/artifact
    
- name: Display structure of downloaded files
  run: ls -R
  working-directory: path/to/artifact

Download All Artifacts

If the name input parameter is not provided, all artifacts will be downloaded. To differentiate between downloaded artifacts, a directory denoted by the artifacts name will be created for each individual artifact.

Example, if there are two artifacts Artifact-A and Artifact-B, and the directory is etc/usr/artifacts/, the directory structure will look like this:

  etc/usr/artifacts/
      Artifact-A/
          ... contents of Artifact-A
      Artifact-B/
          ... contents of Artifact-B

Download all artifacts to a specific directory

steps:
- uses: actions/checkout@v2

- uses: actions/download-artifact@v2
  with:
    path: path/to/artifacts
    
- name: Display structure of downloaded files
  run: ls -R
  working-directory: path/to/artifacts

Download all artifacts to the current working directory

steps:
- uses: actions/checkout@v2

- uses: actions/download-artifact@v2

- name: Display structure of downloaded files
  run: ls -R

@actions/artifact package

Internally the @actions/artifact NPM package is used to interact with artifacts. You can find additional documentation there along with all the source code related to artifact download.

License

The scripts and documentation in this project are released under the MIT License