mirror of
				https://github.com/actions/checkout.git
				synced 2025-11-04 00:20:37 +00:00 
			
		
		
		
	Prepare v5.0.0 release (#2238)
This commit is contained in:
		
							
								
								
									
										1
									
								
								.github/workflows/update-main-version.yml
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										1
									
								
								.github/workflows/update-main-version.yml
									
									
									
									
										vendored
									
									
								
							@@ -11,6 +11,7 @@ on:
 | 
			
		||||
        type: choice
 | 
			
		||||
        description: The major version to update
 | 
			
		||||
        options:
 | 
			
		||||
          - v5
 | 
			
		||||
          - v4
 | 
			
		||||
          - v3
 | 
			
		||||
          - v2
 | 
			
		||||
 
 | 
			
		||||
@@ -1,5 +1,9 @@
 | 
			
		||||
# Changelog
 | 
			
		||||
 | 
			
		||||
## V5.0.0
 | 
			
		||||
* Update actions checkout to use node 24 by @salmanmkc in https://github.com/actions/checkout/pull/2226
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## V4.3.0
 | 
			
		||||
* docs: update README.md by @motss in https://github.com/actions/checkout/pull/1971
 | 
			
		||||
* Add internal repos for checking out multiple repositories by @mouismail in https://github.com/actions/checkout/pull/1977
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										72
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										72
									
								
								README.md
									
									
									
									
									
								
							@@ -1,5 +1,9 @@
 | 
			
		||||
[](https://github.com/actions/checkout/actions/workflows/test.yml)
 | 
			
		||||
 | 
			
		||||
# Checkout V5
 | 
			
		||||
 | 
			
		||||
Checkout v5 now supports Node.js 24
 | 
			
		||||
 | 
			
		||||
# Checkout V4
 | 
			
		||||
 | 
			
		||||
This action checks-out your repository under `$GITHUB_WORKSPACE`, so your workflow can access it.
 | 
			
		||||
@@ -36,7 +40,7 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
 | 
			
		||||
<!-- start usage -->
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    # Repository name with owner. For example, actions/checkout
 | 
			
		||||
    # Default: ${{ github.repository }}
 | 
			
		||||
@@ -149,24 +153,32 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
 | 
			
		||||
# Scenarios
 | 
			
		||||
 | 
			
		||||
- [Fetch only the root files](#Fetch-only-the-root-files)
 | 
			
		||||
- [Fetch only the root files and `.github` and `src` folder](#Fetch-only-the-root-files-and-github-and-src-folder)
 | 
			
		||||
- [Fetch only a single file](#Fetch-only-a-single-file)
 | 
			
		||||
- [Fetch all history for all tags and branches](#Fetch-all-history-for-all-tags-and-branches)
 | 
			
		||||
- [Checkout a different branch](#Checkout-a-different-branch)
 | 
			
		||||
- [Checkout HEAD^](#Checkout-HEAD)
 | 
			
		||||
- [Checkout multiple repos (side by side)](#Checkout-multiple-repos-side-by-side)
 | 
			
		||||
- [Checkout multiple repos (nested)](#Checkout-multiple-repos-nested)
 | 
			
		||||
- [Checkout multiple repos (private)](#Checkout-multiple-repos-private)
 | 
			
		||||
- [Checkout pull request HEAD commit instead of merge commit](#Checkout-pull-request-HEAD-commit-instead-of-merge-commit)
 | 
			
		||||
- [Checkout pull request on closed event](#Checkout-pull-request-on-closed-event)
 | 
			
		||||
- [Push a commit using the built-in token](#Push-a-commit-using-the-built-in-token)
 | 
			
		||||
- [Push a commit to a PR using the built-in token](#Push-a-commit-to-a-PR-using-the-built-in-token)
 | 
			
		||||
- [Checkout V5](#checkout-v5)
 | 
			
		||||
- [Checkout V4](#checkout-v4)
 | 
			
		||||
    - [Note](#note)
 | 
			
		||||
- [What's new](#whats-new)
 | 
			
		||||
- [Usage](#usage)
 | 
			
		||||
- [Scenarios](#scenarios)
 | 
			
		||||
  - [Fetch only the root files](#fetch-only-the-root-files)
 | 
			
		||||
  - [Fetch only the root files and `.github` and `src` folder](#fetch-only-the-root-files-and-github-and-src-folder)
 | 
			
		||||
  - [Fetch only a single file](#fetch-only-a-single-file)
 | 
			
		||||
  - [Fetch all history for all tags and branches](#fetch-all-history-for-all-tags-and-branches)
 | 
			
		||||
  - [Checkout a different branch](#checkout-a-different-branch)
 | 
			
		||||
  - [Checkout HEAD^](#checkout-head)
 | 
			
		||||
  - [Checkout multiple repos (side by side)](#checkout-multiple-repos-side-by-side)
 | 
			
		||||
  - [Checkout multiple repos (nested)](#checkout-multiple-repos-nested)
 | 
			
		||||
  - [Checkout multiple repos (private)](#checkout-multiple-repos-private)
 | 
			
		||||
  - [Checkout pull request HEAD commit instead of merge commit](#checkout-pull-request-head-commit-instead-of-merge-commit)
 | 
			
		||||
  - [Checkout pull request on closed event](#checkout-pull-request-on-closed-event)
 | 
			
		||||
  - [Push a commit using the built-in token](#push-a-commit-using-the-built-in-token)
 | 
			
		||||
  - [Push a commit to a PR using the built-in token](#push-a-commit-to-a-pr-using-the-built-in-token)
 | 
			
		||||
- [Recommended permissions](#recommended-permissions)
 | 
			
		||||
- [License](#license)
 | 
			
		||||
 | 
			
		||||
## Fetch only the root files
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    sparse-checkout: .
 | 
			
		||||
```
 | 
			
		||||
@@ -174,7 +186,7 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
## Fetch only the root files and `.github` and `src` folder
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    sparse-checkout: |
 | 
			
		||||
      .github
 | 
			
		||||
@@ -184,7 +196,7 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
## Fetch only a single file
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    sparse-checkout: |
 | 
			
		||||
      README.md
 | 
			
		||||
@@ -194,7 +206,7 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
## Fetch all history for all tags and branches
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    fetch-depth: 0
 | 
			
		||||
```
 | 
			
		||||
@@ -202,7 +214,7 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
## Checkout a different branch
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    ref: my-branch
 | 
			
		||||
```
 | 
			
		||||
@@ -210,7 +222,7 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
## Checkout HEAD^
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    fetch-depth: 2
 | 
			
		||||
- run: git checkout HEAD^
 | 
			
		||||
@@ -220,12 +232,12 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- name: Checkout
 | 
			
		||||
  uses: actions/checkout@v4
 | 
			
		||||
  uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    path: main
 | 
			
		||||
 | 
			
		||||
- name: Checkout tools repo
 | 
			
		||||
  uses: actions/checkout@v4
 | 
			
		||||
  uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    repository: my-org/my-tools
 | 
			
		||||
    path: my-tools
 | 
			
		||||
@@ -236,10 +248,10 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- name: Checkout
 | 
			
		||||
  uses: actions/checkout@v4
 | 
			
		||||
  uses: actions/checkout@v5
 | 
			
		||||
 | 
			
		||||
- name: Checkout tools repo
 | 
			
		||||
  uses: actions/checkout@v4
 | 
			
		||||
  uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    repository: my-org/my-tools
 | 
			
		||||
    path: my-tools
 | 
			
		||||
@@ -250,12 +262,12 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- name: Checkout
 | 
			
		||||
  uses: actions/checkout@v4
 | 
			
		||||
  uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    path: main
 | 
			
		||||
 | 
			
		||||
- name: Checkout private tools
 | 
			
		||||
  uses: actions/checkout@v4
 | 
			
		||||
  uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    repository: my-org/my-private-tools
 | 
			
		||||
    token: ${{ secrets.GH_PAT }} # `GH_PAT` is a secret that contains your PAT
 | 
			
		||||
@@ -268,7 +280,7 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 | 
			
		||||
## Checkout pull request HEAD commit instead of merge commit
 | 
			
		||||
 | 
			
		||||
```yaml
 | 
			
		||||
- uses: actions/checkout@v4
 | 
			
		||||
- uses: actions/checkout@v5
 | 
			
		||||
  with:
 | 
			
		||||
    ref: ${{ github.event.pull_request.head.sha }}
 | 
			
		||||
```
 | 
			
		||||
@@ -284,7 +296,7 @@ jobs:
 | 
			
		||||
  build:
 | 
			
		||||
    runs-on: ubuntu-latest
 | 
			
		||||
    steps:
 | 
			
		||||
      - uses: actions/checkout@v4
 | 
			
		||||
      - uses: actions/checkout@v5
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Push a commit using the built-in token
 | 
			
		||||
@@ -295,7 +307,7 @@ jobs:
 | 
			
		||||
  build:
 | 
			
		||||
    runs-on: ubuntu-latest
 | 
			
		||||
    steps:
 | 
			
		||||
      - uses: actions/checkout@v4
 | 
			
		||||
      - uses: actions/checkout@v5
 | 
			
		||||
      - run: |
 | 
			
		||||
          date > generated.txt
 | 
			
		||||
          # Note: the following account information will not work on GHES
 | 
			
		||||
@@ -317,7 +329,7 @@ jobs:
 | 
			
		||||
  build:
 | 
			
		||||
    runs-on: ubuntu-latest
 | 
			
		||||
    steps:
 | 
			
		||||
      - uses: actions/checkout@v4
 | 
			
		||||
      - uses: actions/checkout@v5
 | 
			
		||||
        with:
 | 
			
		||||
          ref: ${{ github.head_ref }}
 | 
			
		||||
      - run: |
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										4
									
								
								package-lock.json
									
									
									
										generated
									
									
									
								
							
							
						
						
									
										4
									
								
								package-lock.json
									
									
									
										generated
									
									
									
								
							@@ -1,12 +1,12 @@
 | 
			
		||||
{
 | 
			
		||||
  "name": "checkout",
 | 
			
		||||
  "version": "4.3.0",
 | 
			
		||||
  "version": "5.0.0",
 | 
			
		||||
  "lockfileVersion": 3,
 | 
			
		||||
  "requires": true,
 | 
			
		||||
  "packages": {
 | 
			
		||||
    "": {
 | 
			
		||||
      "name": "checkout",
 | 
			
		||||
      "version": "4.3.0",
 | 
			
		||||
      "version": "5.0.0",
 | 
			
		||||
      "license": "MIT",
 | 
			
		||||
      "dependencies": {
 | 
			
		||||
        "@actions/core": "^1.10.1",
 | 
			
		||||
 
 | 
			
		||||
@@ -1,6 +1,6 @@
 | 
			
		||||
{
 | 
			
		||||
  "name": "checkout",
 | 
			
		||||
  "version": "4.3.0",
 | 
			
		||||
  "version": "5.0.0",
 | 
			
		||||
  "description": "checkout action",
 | 
			
		||||
  "main": "lib/main.js",
 | 
			
		||||
  "scripts": {
 | 
			
		||||
 
 | 
			
		||||
@@ -120,7 +120,7 @@ function updateUsage(
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
updateUsage(
 | 
			
		||||
  'actions/checkout@v4',
 | 
			
		||||
  'actions/checkout@v5',
 | 
			
		||||
  path.join(__dirname, '..', '..', 'action.yml'),
 | 
			
		||||
  path.join(__dirname, '..', '..', 'README.md')
 | 
			
		||||
)
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user