|
|
|
@ -2,7 +2,7 @@
|
|
|
|
|
<a href="https://github.com/actions/checkout"><img alt="GitHub Actions status" src="https://github.com/actions/checkout/workflows/test-local/badge.svg"></a>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
# Checkout V2 (preview)
|
|
|
|
|
# Checkout V2 (beta)
|
|
|
|
|
|
|
|
|
|
This action checks-out your repository under `$GITHUB_WORKSPACE`, so your workflow can access it.
|
|
|
|
|
|
|
|
|
@ -10,13 +10,29 @@ By default, the repository that triggered the workflow is checked-out, for the r
|
|
|
|
|
|
|
|
|
|
Refer [here](https://help.github.com/en/articles/events-that-trigger-workflows) to learn which commit `$GITHUB_SHA` points to for different events.
|
|
|
|
|
|
|
|
|
|
Changes in V2:
|
|
|
|
|
- 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](https://github.com/actions/checkout/blob/v1/README.md) for previous versions.
|
|
|
|
|
|
|
|
|
|
# Usage
|
|
|
|
|
|
|
|
|
|
<!-- start usage -->
|
|
|
|
|
```yaml
|
|
|
|
|
- uses: actions/checkout@preview
|
|
|
|
|
- uses: actions/checkout@v2-beta
|
|
|
|
|
with:
|
|
|
|
|
# Repository name
|
|
|
|
|
# Default: ${{ github.repository }}
|
|
|
|
|