2021-06-29 18:28:31 +03:00
name : 'GitCheckout'
2019-12-05 06:43:03 +02:00
description : 'Checkout a Git repository at a particular version'
2020-03-11 21:55:17 +02:00
inputs :
2019-07-23 18:50:59 +03:00
repository :
2019-12-03 23:47:19 +02:00
description : 'Repository name with owner. For example, actions/checkout'
2019-12-03 17:28:59 +02:00
default : ${{ github.repository }}
2019-07-23 18:50:59 +03:00
ref :
2019-12-03 17:28:59 +02:00
description : >
2019-12-12 20:49:26 +02:00
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
2020-06-16 20:41:01 +03:00
event. Otherwise, uses the default branch.
2019-07-23 18:50:59 +03:00
token :
2019-12-12 20:49:26 +02:00
description : >
2020-03-11 21:55:17 +02:00
Personal access token (PAT) used to fetch the repository. The PAT is configured
with the local git config, which enables your scripts to run authenticated git
commands. The post-job step removes the PAT.
2020-03-12 17:42:38 +02:00
We recommend using a service account with the least permissions necessary.
2020-03-11 21:55:17 +02:00
Also when generating a new PAT, select the least scopes necessary.
[ Learn more about creating and using encrypted secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)
2019-12-03 17:28:59 +02:00
default : ${{ github.token }}
2020-03-11 21:55:17 +02:00
ssh-key :
description : >
2020-03-12 17:42:38 +02:00
SSH key used to fetch the repository. The SSH key is configured with the local
2020-03-11 21:55:17 +02:00
git config, which enables your scripts to run authenticated git commands.
The post-job step removes the SSH key.
2020-03-12 17:42:38 +02:00
We recommend using a service account with the least permissions necessary.
2020-03-11 21:55:17 +02:00
[ Learn more about creating and using
encrypted secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)
ssh-known-hosts :
description : >
Known hosts in addition to the user and global host key database. The public
SSH keys for a host may be obtained using the utility `ssh-keyscan`. For example,
`ssh-keyscan github.com`. The public key for github.com is always implicitly added.
ssh-strict :
description : >
Whether to perform strict host key checking. When true, adds the options `StrictHostKeyChecking=yes`
and `CheckHostIP=no` to the SSH command line. Use the input `ssh-known-hosts` to
configure additional hosts.
default : true
2019-12-12 20:49:26 +02:00
persist-credentials :
2020-03-11 21:55:17 +02:00
description : 'Whether to configure the token or SSH key with the local git config'
2019-12-12 20:49:26 +02:00
default : true
2019-12-03 17:28:59 +02:00
path :
2021-06-29 18:28:31 +03:00
description : 'Relative path under the workspace folder to place the repository'
allow_parent_path :
description : 'allows path option to result in a path that is a parent of the working directory. This may have unforseen consequences.'
default : false
2019-07-23 18:50:59 +03:00
clean :
2019-12-03 17:28:59 +02:00
description : 'Whether to execute `git clean -ffdx && git reset --hard HEAD` before fetching'
2019-07-23 18:50:59 +03:00
default : true
fetch-depth :
2020-07-13 04:02:24 +03:00
description : 'Number of commits to fetch. 0 indicates all history for all branches and tags.'
2019-12-03 17:28:59 +02:00
default : 1
lfs :
description : 'Whether to download Git-LFS files'
default : false
2020-03-05 21:21:59 +02:00
submodules :
description : >
Whether to checkout submodules : `true` to checkout submodules or `recursive` to
recursively checkout submodules.
2020-03-11 21:55:17 +02:00
When the `ssh-key` input is not provided, SSH URLs beginning with `git@github.com:` are
converted to HTTPS.
2020-03-05 21:21:59 +02:00
default : false
2021-06-29 20:47:27 +03:00
outputs :
WORKSPACE_DIR :
description : working directory for the project
2019-07-23 18:50:59 +03:00
runs :
2019-12-03 17:28:59 +02:00
using : node12
main : dist/index.js
2019-12-05 06:43:03 +02:00
post : dist/index.js