Files
runner/docs/checks/git.md
2022-06-28 21:03:53 -04:00

1.7 KiB

Git Connection Check

What is this check for?

Make sure git can access GitHub.com or your GitHub Enterprise Server.

What is checked?

The test is done by executing

# For GitHub.com
git ls-remote --exit-code https://github.com/actions/checkout HEAD

# For GitHub Enterprise Server
git ls-remote --exit-code https://ghes.me/actions/checkout HEAD

The test also set environment variable GIT_TRACE=1 and GIT_CURL_VERBOSE=1 before running git ls-remote, this will make git to produce debug log for better debug any potential issues.

How to fix the issue?

1. Check global and system git config

If you are having issues connecting to the server, check your global and system git config for any unexpected authentication headers. You might be seeing an error like:

fatal: unable to access 'https://github.com/actions/checkout/': The requested URL returned error: 400

The following commands can be used to check for unexpected authentication headers:

$ git config --global --list | grep extraheader
http.extraheader=AUTHORIZATION: unexpected_auth_header

$ git config --system --list | grep extraheader

The following command can be used to remove the above value: git config --global --unset http.extraheader

2. Check the common network issue

Please check the network doc

If you are seeing SSL Certificate problem: in the log, it means the git can't connect to the GitHub server due to SSL handshake failure.

Please check the SSL cert doc

Still not working?

Contact GitHub customer service or log an issue at https://github.com/actions/runner if you think it's a runner issue.