Checkout a Git repository at a particular version
Input | Description | Required | Default Value |
---|---|---|---|
submodules | Whether to checkout submodules: true to checkout submodules or recursive to recursively checkout submodules.When the ssh-key input is not provided, SSH URLs beginning with [email protected]: are converted to HTTPS. |
no | false |
set‑safe‑directory | Add repository path as safe.directory for Git global config by running git config --global --add safe.directory <path> |
no | true |
path | Relative path under $GITHUB_WORKSPACE to place the repository | no | |
clean | Whether to execute git clean -ffdx && git reset --hard HEAD before fetching |
no | true |
ref | 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, uses the default branch. |
no | |
fetch‑depth | Number of commits to fetch. 0 indicates all history for all branches and tags. | no | 1 |
ssh‑strict | 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. |
no | true |
token | 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. We recommend using a service account with the least permissions necessary. Also when generating a new PAT, select the least scopes necessary. Learn more about creating and using encrypted secrets |
no | ${{ github.token }} |
ssh‑known‑hosts | 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. |
no | |
persist‑credentials | Whether to configure the token or SSH key with the local git config | no | true |
lfs | Whether to download Git-LFS files | no | false |
ssh‑key | SSH key used to fetch the repository. The SSH key is configured with the local git config, which enables your scripts to run authenticated git commands. The post-job step removes the SSH key. We recommend using a service account with the least permissions necessary. Learn more about creating and using encrypted secrets |
no | |
repository | Repository name with owner. For example, actions/checkout | no | ${{ github.repository }} |
No outputs.