Skip to content
No description, website, or topics provided.
TypeScript Shell JavaScript
Branch: master
Clone or download
Latest commit 5881116 Dec 6, 2019

GitHub Actions status

Checkout V2 beta

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.

What's new

  • Improved fetch performance
    • The default behavior now fetches only the SHA being checked-out
  • Script authenticated git commands
    • Persists with.token in the local git config
    • Enables your scripts to run authenticated git commands
    • Post-job cleanup removes the token
    • Coming soon: Opt out by setting with.persist-credentials to false
  • Creates a local branch
    • No longer detached HEAD when checking out a branch
    • A local branch is created with the corresponding upstream branch set
  • Improved layout
    • with.path is always relative to github.workspace
    • Aligns better with container actions, where github.workspace gets mapped in
  • Removed input submodules

Refer here for previous versions.


- uses: actions/checkout@v2-beta
    # Repository name with owner. For example, actions/checkout
    # Default: ${{ github.repository }}
    repository: ''

    # The branch, tag or SHA to checkout.  When checking out the repository that
    # triggered a workflow, this defaults to the reference or SHA for that 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@v2-beta
    ref: some-branch

Checkout a different, private repository

- uses: actions/checkout@v2-beta
    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.

Checkout the HEAD commit of a PR, rather than the merge commit

- uses: actions/checkout@v2-beta
    ref: ${{ github.event.after }}


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

You can’t perform that action at this time.