Go to file
eric sciple e347bba93b
Convert checkout to a regular action (#70)
2019-12-03 10:28:59 -05:00
.github/workflows Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
__test__ Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
dist Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
src Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
.eslintignore Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
.eslintrc.json Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
.gitignore Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
.prettierignore Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
.prettierrc.json Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
CHANGELOG.md Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
LICENSE Add docs (#2) 2019-07-23 15:32:03 -04:00
README.md Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
action.yml Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
jest.config.js Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
package-lock.json Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
package.json Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00
tsconfig.json Convert checkout to a regular action (#70) 2019-12-03 10:28:59 -05:00

README.md

GitHub Actions status

Checkout V2 (preview)

This action checks-out your repository under $GITHUB_WORKSPACE, so your workflow can access it.

By default, the repository that triggered the workflow is checked-out, for the ref/SHA that triggered the event.

Refer here to learn which commit $GITHUB_SHA points to for different events.

Refer here for previous versions.

Usage

- uses: actions/checkout@preview
  with:
    # Repository name
    # Default: ${{ github.repository }}
    repository: ''

    # Ref to checkout (SHA, branch, tag). For the repository that triggered the
    # workflow, defaults to the ref/SHA for the event. Otherwise defaults to master.
    ref: ''

    # Access token for clone repository
    # Default: ${{ github.token }}
    token: ''

    # Relative path under $GITHUB_WORKSPACE to place the repository
    path: ''

    # Whether to execute `git clean -ffdx && git reset --hard HEAD` before fetching
    # Default: true
    clean: ''

    # Number of commits to fetch. 0 indicates all history.
    # Default: 1
    fetch-depth: ''

    # Whether to download Git-LFS files
    # Default: false
    lfs: ''

Checkout a different branch

- uses: actions/checkout@preview
  with:
    ref: some-branch

Checkout a different, private repository

- uses: actions/checkout@preview
  with:
    repository: myAccount/myRepository
    ref: refs/heads/master
    token: ${{ secrets.GitHub_PAT }} # `GitHub_PAT` is a secret that contains your PAT
  • ${{ github.token }} is scoped to the current repository, so if you want to checkout another repository that is private you will need to provide your own PAT.

License

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