mirror of
				https://github.com/actions/checkout.git
				synced 2025-10-31 15:47:36 +00:00 
			
		
		
		
	Compare commits
	
		
			1 Commits
		
	
	
		
			v1
			...
			Update-des
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
|   | 3204e0bf8c | 
							
								
								
									
										19
									
								
								.github/workflows/test.yml
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										19
									
								
								.github/workflows/test.yml
									
									
									
									
										vendored
									
									
								
							| @@ -1,19 +0,0 @@ | |||||||
| name: "test-local" |  | ||||||
| on: |  | ||||||
|   pull_request: |  | ||||||
|   push: |  | ||||||
|     branches: |  | ||||||
|       - master |  | ||||||
|       - 'releases/*' |  | ||||||
|  |  | ||||||
| jobs: |  | ||||||
|   test: |  | ||||||
|     strategy: |  | ||||||
|       matrix: |  | ||||||
|         os: [windows-latest, ubuntu-latest, macOS-latest] |  | ||||||
|     runs-on: ${{ matrix.os }} |  | ||||||
|     steps: |  | ||||||
|     - uses: actions/checkout@master |  | ||||||
|     - uses: ./ |  | ||||||
|       with: |  | ||||||
|         ref: master |  | ||||||
							
								
								
									
										13
									
								
								CHANGELOG.md
									
									
									
									
									
								
							
							
						
						
									
										13
									
								
								CHANGELOG.md
									
									
									
									
									
								
							| @@ -1,13 +0,0 @@ | |||||||
| # Changelog |  | ||||||
|  |  | ||||||
| ## Unreleased Changes |  | ||||||
| - N/A |  | ||||||
|  |  | ||||||
| ## v1.2.0 |  | ||||||
| - Reverted the breaking behavior change in v1.1.0 that broke custom authentication flows |  | ||||||
|  |  | ||||||
| ## v1.1.0 (Not reccomended for use, this functionality will be ported to the 2.0 update) |  | ||||||
| - Persist `with.token` or `${{ github.token }}` into checkout repository's git config as `http.https://github.com/.extraheader=AUTHORIZATION: basic ***` to better support scripting git |  | ||||||
|  |  | ||||||
| ## v1.0.0 |  | ||||||
| - Initial Release of the checkout action |  | ||||||
							
								
								
									
										49
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										49
									
								
								README.md
									
									
									
									
									
								
							| @@ -1,61 +1,22 @@ | |||||||
| <p align="center"> | # checkout | ||||||
|   <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 | This action checks out your repository so that your workflow operates from the root of the repository | ||||||
|  |  | ||||||
| This action checks out your repository to `$GITHUB_WORKSPACE`, so that your workflow can access the contents of your repository. |  | ||||||
|  |  | ||||||
| By default, this is equivalent to running `git fetch` and `git checkout $GITHUB_SHA`, so that you'll always have your repo contents at the version that triggered the workflow. |  | ||||||
| See [here](https://help.github.com/en/articles/events-that-trigger-workflows) to learn what `$GITHUB_SHA` is for different kinds of events. |  | ||||||
|  |  | ||||||
| # Usage | # Usage | ||||||
|  |  | ||||||
| See [action.yml](action.yml) | See [action.yml](action.yml) | ||||||
|  |  | ||||||
| Basic: | Basic: | ||||||
|  |  | ||||||
| ```yaml | ```yaml | ||||||
| steps: | steps: | ||||||
| - uses: actions/checkout@v1 | - uses: actions/checkout@master | ||||||
| - uses: actions/setup-node@v1 | - uses: actions/setup-node@master | ||||||
|   with: |   with: | ||||||
|     node-version: 10.x  |     version: 10.x  | ||||||
| - run: npm install | - run: npm install | ||||||
| - run: npm test | - run: npm test | ||||||
| ``` | ``` | ||||||
|  |  | ||||||
| By default, the branch or tag ref that triggered the workflow will be checked out. If you wish to check out a different branch, a different repository or use different token to checkout, specify that using `with.ref`, `with.repository` and `with.token`. |  | ||||||
|  |  | ||||||
| ## Checkout different branch from the workflow repository |  | ||||||
| ```yaml |  | ||||||
| - uses: actions/checkout@v1 |  | ||||||
|   with: |  | ||||||
|     ref: some-branch |  | ||||||
| ``` |  | ||||||
|  |  | ||||||
| ## Checkout different private repository |  | ||||||
| ```yaml |  | ||||||
| - uses: actions/checkout@v1 |  | ||||||
|   with: |  | ||||||
|     repository: myAccount/myRepository |  | ||||||
|     ref: refs/heads/master |  | ||||||
|     token: ${{ secrets.GitHub_PAT }} # `GitHub_PAT` is a secret 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](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line). |  | ||||||
|  |  | ||||||
| ## Checkout private submodules |  | ||||||
| ```yaml |  | ||||||
| - uses: actions/checkout@v1 |  | ||||||
|   with: |  | ||||||
|     submodules: true # 'recursive' 'true' or 'false' |  | ||||||
|     token: ${{ secrets.GitHub_PAT }} # `GitHub_PAT` is a secret contains your PAT. |  | ||||||
| ``` |  | ||||||
| > - Private submodules must be configured via `https` not `ssh`. |  | ||||||
| > - `${{ github.token }}` only has permission to the workflow triggering repository. If the repository contains any submodules that come from private repositories, you will need to add your [PAT](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) as secret and use the secret in `with.token` to make the `checkout` action work. |  | ||||||
|  |  | ||||||
| For more details, see [Contexts and expression syntax for GitHub Actions](https://help.github.com/en/articles/contexts-and-expression-syntax-for-github-actions) and [Creating and using encrypted secrets](https://help.github.com/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) |  | ||||||
|  |  | ||||||
| # License | # License | ||||||
|  |  | ||||||
| The scripts and documentation in this project are released under the [MIT License](LICENSE) | The scripts and documentation in this project are released under the [MIT License](LICENSE) | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| name: 'Checkout' | name: 'Checkout' | ||||||
| description: 'Checkout a Git repository.' | description: 'Checkout a Git repository' | ||||||
| inputs:  | inputs:  | ||||||
|   repository: |   repository: | ||||||
|     description: 'Repository name' |     description: 'Repository name' | ||||||
| @@ -11,7 +11,7 @@ inputs: | |||||||
|     description: 'If true, execute `execute git clean -ffdx && git reset --hard HEAD` before fetching' |     description: 'If true, execute `execute git clean -ffdx && git reset --hard HEAD` before fetching' | ||||||
|     default: true |     default: true | ||||||
|   submodules: |   submodules: | ||||||
|     description: 'Whether to include submodules: false to exclude submodules, true to include only one level of submodules, or recursive to recursively clone submodules; defaults to false' |     description: 'Directory containing files to upload' | ||||||
|   lfs: |   lfs: | ||||||
|     description: 'Whether to download Git-LFS files; defaults to false' |     description: 'Whether to download Git-LFS files; defaults to false' | ||||||
|   fetch-depth: |   fetch-depth: | ||||||
| @@ -19,5 +19,4 @@ inputs: | |||||||
|   path: |   path: | ||||||
|     description: 'Optional path to check out source code'   |     description: 'Optional path to check out source code'   | ||||||
| runs: | runs: | ||||||
|   # Plugins live on the runner and are only available to a certain set of first party actions. |  | ||||||
|   plugin: 'checkout' |   plugin: 'checkout' | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user